Skip to main content
배포는 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 에서 배포

같은 체크, 같은 동작. CI 에서 흔함:
먼저 시뮬레이션, 시뮬레이션 통과 시에만 배포.

​
Canary 배포

새 버전 canary:
버전 생성되지만 트래픽 5% 만 봄. 24-72h 모니터; 그 다음:
트래픽 분할이 스코프 키 기반 — 같은 사용자가 일관되게 한 버전 히트.

​
의존 리소스 배포

일부 Flow 변경은 다른 곳의 동시 업데이트 필요:
  • 새 리트리벌 프리셋 참조하는 Flow 배포? 프리셋도 배포되어야.
  • 새 시크릿 있는 새 도구 쓰는 Flow 배포? 시크릿 존재해야.
사전 배포 체크가 이 의존성 표면화; 배포 또는 업데이트 프롬프트 봄.

​
배포 권한

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

​
Draft 에 무슨 일

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

​
배포 되돌리기

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