> ## 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 를 불변 버전으로 출시 — 프로덕션 트래픽이 보는 것.

Flow 편집은 프로덕션에 영향 없습니다. **배포 (publish)** 만 영향을 줍니다. 배포는 Draft 를 얼려서 프로덕션 트래픽을 그 얼어붙은 스냅샷으로 가리킵니다.

## 배포 방법

1. Flow 열기.
2. 우측 상단 **Publish** 클릭.
3. Nora 가 사전 배포 체크 실행 (아래 참고).
4. 무엇이 바뀌었는지 릴리스 노트 추가.
5. 확인.

배포는 몇 초 안에 라이브. 새 실행은 즉시 새 버전 사용; 진행 중인 실행은 이전 버전에서 완료.

## 사전 배포 체크

배포를 허용하기 전 Nora 가 확인:

* **모든 필수 입력이 와이어링됨.** 고아 블록 없음.
* **모든 Agent 가 프롬프트와 모델을 가짐.** 빈 프롬프트 거부.
* **파라미터를 가진 모든 Tool 이 파라미터 설명을 가짐.** 이해할 수 없는 도구를 Agent 는 호출 불가.
* **모든 시크릿이 해결됨.** 삭제된 시크릿에 대한 깨진 참조 없음.
* **와이어링 그래프에 사이클 없음** (경계 있는 루프 패턴을 명시적으로 쓰지 않는 한).
* **현재 배포와의 변경.** 동일한 Draft 배포는 거부 — 출시할 것이 없음.

체크가 실패하면 무엇을 고쳐야 할지 설명하는 빨간 배너가 표시됩니다. 통과할 때까지 Publish 버튼은 비활성.

## "불변" 의 의미

배포된 버전은 콘텐츠 주소 지정 스냅샷입니다. ID 는 내용의 해시입니다. 이 뜻은:

* 같은 버전은 몇 달 뒤에도 항상 같은 방식으로 동작.
* 롤백은 즉시 — 프로덕션을 이전 버전으로 가리키는 것은 메타데이터 업데이트지 재배포가 아님.
* 우연히 동일한 콘텐츠를 배포한 두 Flow 는 저장소를 공유.

배포된 버전을 편집할 수 없습니다. 새로운 버전을 배포할 수만 있습니다.

## 릴리스 노트

노트는 옵션이지만 강력히 권장. 좋은 릴리스 노트 예:

> 부분 환불 지원 추가. 고객이 chargeback 을 언급하는 경우를 잡도록 에스컬레이션 룰 강화. "fraud" 나 "dispute" 를 포함하는 질문에 대해 모델을 고정확도 티어로 상향.

노트는 버전 이력, CLI (`nora flows versions list`), 감사 로그에 표시됩니다.

## CLI 에서 배포

```bash theme={null}
nora flows publish --note "2026-07-31 에스컬레이션 룰 강화"
```

같은 체크, 같은 동작. 테스트 실행 후 초록일 때만 배포하는 CI 파이프라인에서 흔함.

## 배포 권한

기본으로 **Owner** 와 **Manager** 만 배포 가능. Member 는 Draft 를 편집할 수 있지만 출시할 수 없음. **Flow 설정 → Access** 에서 변경.

## 다음 단계

<CardGroup cols={2}>
  <Card title="롤백" icon="rotate-left" href="/ko/reliable/versions/rollback">
    뭔가 깨졌나? 프로덕션을 이전 버전으로 되돌리기.
  </Card>

  <Card title="버전 diff" icon="code-compare" href="/ko/reliable/versions/diff">
    두 버전 사이에서 정확히 무엇이 바뀌었는지 보기.
  </Card>
</CardGroup>
