원클릭 배포
설계를 마치면 배포 버튼 하나로 실제로 사용하는 시스템이 됩니다. 데이터베이스 테이블 생성부터 API, 화면, 사이드바 메뉴 등록까지 6단계를 차례로 처리하고, 중간에 실패하면 앞 단계까지 되돌립니다.
- 6단계 파이프라인: DDL 생성 → DDL 실행 → API 생성 → UI 생성 → 메뉴 생성 → 아티팩트 저장
- 배포 전 정책 검사: 동시 배포 수, 데이터 손실 위험, 플랜별 테이블 수 같은 규칙을 먼저 확인하고 위반이면 막습니다.
- 실패 시 자동 되돌림: 어느 단계에서 실패하든 이미 처리한 단계를 역순으로 되돌립니다.
- 변경사항 재배포: 블록으로 배포한 캔버스는 바뀐 부분만 분석해 다시 배포합니다.
- 배포 이력: 모든 배포의 상태, 소요 시간, 배포자, 단계별 진행과 생성 파일을 기록합니다.
원클릭 배포란?
스키마 디자이너와 프로세스 디자이너의 캔버스는 설계도입니다. 배포는 이 설계도를 읽어 실제 데이터베이스와 화면을 만드는 과정입니다. 사용자는 배포 버튼만 누르면 되고, 나머지 작업은 서버가 순서대로 처리합니다.
6단계 파이프라인
| 단계 | 하는 일 |
|---|---|
| 1. DDL 생성 | 캔버스의 테이블·컬럼·관계를 데이터베이스 정의문으로 바꿉니다 |
| 2. DDL 실행 | 정의문을 실행해 회사 전용 영역에 테이블을 만듭니다 |
| 3. API 생성 | 테이블마다 조회·등록·수정·삭제 API를 만듭니다 |
| 4. UI 생성 | 화면 노드 설정대로 목록·입력·상세 같은 업무 화면을 만듭니다 |
| 5. 메뉴 생성 | 메뉴 그룹 노드대로 사이드바 메뉴와 화면 주소를 등록합니다 |
| 6. 아티팩트 저장 | 생성된 파일을 저장해 배포 이력에서 다시 볼 수 있게 합니다 |
배포가 끝나면 화면과 메뉴가 사이드바에 자동으로 등록되고, 바로 런타임 뷰에서 데이터를 입력할 수 있습니다.
배포 전 정책 검사
배포 요청이 들어오면 서버는 파이프라인을 시작하기 전에 배포 정책을 평가합니다. 규칙마다 차단과 경고 두 등급이 있습니다. 차단 위반이 하나라도 있으면 배포가 시작되지 않고, 경고만 있으면 배포는 진행되며 경고 내용이 기록됩니다.
| 규칙 | 등급 | 내용 |
|---|---|---|
| 동시 배포 수 제한 | 차단 | 구독 플랜별로 동시에 진행할 수 있는 배포 수를 제한합니다 |
| 배포 시간대 | 경고 | 업무시간 밖의 운영 환경 배포를 알립니다. 운영이 아닌 환경은 항상 허용합니다 |
| 대규모 배포 승인 | 경고 | 많은 테이블에 영향을 주는 배포에 관리자 승인을 권고합니다 |
| 데이터 손실 위험 | 차단 | 영향 분석에서 기존 데이터가 사라질 위험이 감지되면 막습니다 |
| 플랜별 테이블 수 | 차단 | 구독 플랜별 최대 테이블 수를 넘으면 막습니다 |
배포 정책 화면
사이드바 설계 스튜디오 → 배포 정책에서 규칙 목록과 각 규칙의 설명, 등급, 파라미터 요약을 확인합니다.
시뮬레이션을 열면 배포 대상 테이블 수, 진행 중인 배포 수, 요청 시각, 구독 플랜, 배포 환경, 데이터 손실 위험 여부를 넣어 보고 결과가 "배포 허용", "배포 가능(승인 필요)", "배포 차단" 중 무엇인지 미리 확인할 수 있습니다. 차단 위반과 경고가 각각 목록으로 표시됩니다.
실패해도 안전한 배포
배포는 여러 단계를 거치므로 중간에 실패할 수 있습니다. 각 단계에는 되돌리기 작업이 짝으로 정해져 있습니다. 예를 들어 테이블을 만든 단계에는 테이블 삭제가, 메뉴를 등록한 단계에는 메뉴 제거가 짝입니다.
어느 단계에서 실패하든 이미 끝난 단계의 되돌리기 작업을 역순으로 실행해 배포 전 상태로 돌아갑니다. 생성한 API, 화면, 메뉴뿐 아니라 함께 등록된 권한, 워크플로우, IoT 노드도 되돌림 대상입니다.
또한 배포할 때 현재 캔버스 상태가 자동으로 저장되므로, 설계를 실수로 바꿨더라도 이전 상태로 돌아갈 수 있습니다.
사용 흐름
- 캔버스 저장: 프로세스 디자이너에서 설계를 저장합니다. 저장하지 않은 변경이 있으면 저장부터 하라는 안내가 나옵니다.
- 진단 확인: 진단 패널에서 시작 노드 누락, 연결되지 않은 노드, 테이블이 바인딩되지 않은 화면, 메뉴에 연결되지 않은 화면 같은 문제가 있는지 확인합니다. 문제가 없으면 "배포 준비 완료"가 표시됩니다.
- 배포 실행: 툴바의 배포 버튼을 누르고 "현재 캔버스의 스키마를 배포하시겠습니까?" 확인 창에서 진행합니다.
- 진행 확인: 진행 창에 6단계 중 현재 단계, 진행률, 실시간 로그가 표시됩니다.
- 결과 확인: 모든 단계가 끝나면 "배포 완료"와 함께 배포 화면 보기 버튼이 나타납니다. 잠시 뒤 대시보드로 이동하며, 여기 머물기를 누르면 이동하지 않습니다.
- 데모 데이터(선택): 솔루션 템플릿에 데모 데이터가 있으면 같은 창에서 데모 데이터 주입으로 예시 데이터를 넣어 화면을 바로 시험할 수 있습니다. 필요 없으면 데모 데이터 삭제로 한 번에 지웁니다.
이미 배포된 테이블은 캔버스에서 삭제할 수 없고, 블록 기본 컬럼도 지울 수 없습니다. 운영 데이터를 지키기 위해 배포된 테이블에는 컬럼 추가만 허용하며, 재배포 분석에서 이를 벗어난 변경은 잠금 위반으로 막힙니다.
변경사항 재배포
블록으로 배포한 캔버스가 배포됨 상태이면 툴바에 변경사항 재배포 버튼이 나타납니다. 이 캔버스에 컬럼이나 테이블을 더했다면 이 버튼을 사용합니다.
- 재배포를 누르면 마지막 배포 이후 바뀐 내용을 먼저 분석합니다.
- 분석 결과에 새 테이블, 수정된 테이블, 추가된 컬럼이 표 시됩니다.
- 변경이 없으면 "마지막 배포 이후 변경사항이 없습니다"가 표시되고 배포 버튼은 비활성화됩니다.
- 배포된 테이블을 컬럼 추가 외의 방식으로 바꾼 경우 잠금 위반으로 표시되고 재배포가 차단됩니다.
- 문제가 없으면 배포 버튼으로 런타임 데이터베이스에 변경을 적용합니다.
배포 이력
사이드바 설계 스튜디오 → 배포 이력에서 지금까지의 배포를 확인합니다.
- 통계 카드: 전체 배포, 성공률, 평균 소요 시간, 최근 7일 배포를 보여 줍니다.
- 이력 표: 상태(대기중·배포중·완료·실패), 캔버스, 테이블, 소요 시간, 배포자, 배포일시를 보여 주고 상태로 걸러 봅니다.
- 배포 상세: 행을 누르면 캔버스, 상태, 배포·완료 일시, 소요 시간과 함께 6단계 중 어디까지 진행했는지 단계 표시로 보여 줍니다. 생성 파일 영역에서 이 배포로 만들어진 파일의 수를 종류별로 확인합니다.
실무 팁
배포 실패의 상당수는 메뉴에 연결되지 않은 화면이나 테이블이 없는 화면처럼 설계 단계에서 잡을 수 있는 문제입니다. 배포 버튼을 누르기 전에 진단 패널의 문제 수를 0으로 만드세요.
업무시간 밖의 운영 배포는 경고 대상입니다. 문제가 생겼을 때 대응할 사람이 있는 시간에 배포하는 것이 안전합니다.
배포 상세에서 어느 단계에서 멈췄는지 확인하면 원인을 좁히기 쉽습니다. 되돌림은 자동으로 끝나므로 설계를 고친 뒤 다시 배포하면 됩니다.