> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 버전 배포

> 현재 Draft 를 얼리고 프로덕션 트래픽을 그리로 가리킴.

배포는 Draft 를 가져와 얼리고 프로덕션 포인터를 새 버전으로 이동시키는 행위.

## 배포 방법

Flow 캔버스 우측 상단 → **Publish**. Nora:

1. 사전 배포 체크 실행 (아래 참고).
2. 릴리스 노트 프롬프트.
3. 옵션으로 고위험 변경에 canary 롤아웃 제안.
4. 확인.
5. 버전 생성하고 포인터 이동.

새 실행이 즉시 새 버전 사용. 진행 중 실행은 시작한 버전에서 완료.

## 사전 배포 체크

배포가 체크 배터리 실행. 모두 통과해야:

* **모든 필수 입력 와이어링됨.** 고아 블록 없음.
* **모든 Agent 가 프롬프트 + 모델 가짐.** 빈 필드 없음.
* **파라미터 있는 모든 도구가 파라미터 설명 가짐.**
* **모든 시크릿 해결됨.** 깨진 참조 없음.
* **사이클 없음.** 경계 있는 루프 명시적 사용 안 하면 와이어링 acyclic.
* **Draft 가 현재 배포와 다름.** No-op 배포 없음.
* **시뮬레이션 게이트 (설정되면).** Flow 설정이 시뮬레이션 최소 통과율 요구하면 그것이 먼저 실행.

실패는 특정 문제와 함께 빨간 배너 표시. 수정, 재시도.

## 릴리스 노트

옵션이지만 강력 권장. 노트가 나타나는 곳:

* 버전 목록.
* 감사 로그.
* CLI (`nora flows versions list`).
* 링크된 개선의 기록.

좋은 릴리스 노트:

> "환불 에스컬레이션 강화. 룰 추가: 사용자가 chargeback 언급하면 에스컬레이션. `fraud`/`dispute` 키워드에 모델을 상위 티어로. 클러스터 #142 해결."

나쁜 릴리스 노트:

> "수정."

관례: 배포가 다루는 클러스터 ID 나 개선 ID 링크. 감사 빠르게.

## CLI 에서 배포

```bash theme={null}
nora flows publish --note "release 2026-07-31 refund cleanup"
```

같은 체크, 같은 동작. CI 에서 흔함:

```bash theme={null}
nora flows publish \
  --note "$(git log -1 --pretty=%s)" \
  --gate-simulation support-golden \
  --min-pass-rate 0.9
```

먼저 시뮬레이션, 시뮬레이션 통과 시에만 배포.

## Canary 배포

새 버전 canary:

```bash theme={null}
nora flows publish --canary 5%
```

버전 생성되지만 트래픽 5% 만 봄. 24-72h 모니터; 그 다음:

```bash theme={null}
nora flows canary promote  # 100% 로 롤
nora flows canary abort    # canary 롤백
```

트래픽 분할이 스코프 키 기반 — 같은 사용자가 일관되게 한 버전 히트.

## 의존 리소스 배포

일부 Flow 변경은 다른 곳의 동시 업데이트 필요:

* 새 리트리벌 프리셋 참조하는 Flow 배포? 프리셋도 배포되어야.
* 새 시크릿 있는 새 도구 쓰는 Flow 배포? 시크릿 존재해야.

사전 배포 체크가 이 의존성 표면화; 배포 또는 업데이트 프롬프트 봄.

## 배포 권한

기본으로 Owner 와 Manager. Member 는 Draft 편집 가능; 배포 못함. **Flow settings → Access** 에서 추가 제한.

## Draft 에 무슨 일

배포가 Draft 안 만짐. Draft 는 편집 가능 유지. 이제 배포된 버전과 다름 — "unpublished changes" 인디케이터 켜짐.

## 배포 되돌리기

배포는 그 자체로 되돌릴 수 없음 — 버전이 존재. 하지만 롤백 ([롤백](/ko/reliable/versions/rollback) 참고) 이 몇 초 안에 포인터 뒤로, 프로덕션 관점에서 사실상 배포 되돌림.