Skip to main content
배포는 Draft를 가져와 얼리고, 프로덕션 포인터를 새 버전으로 옮기는 일입니다.

​
배포하는 법

Flow 캔버스 오른쪽 위 → Publish를 누릅니다. Nora가 이렇게 합니다.
  1. 배포 전 점검을 돌립니다(아래 참고).
  2. 릴리스 노트를 물어봅니다.
  3. 위험이 큰 변경이면 canary 롤아웃을 권합니다.
  4. 확인을 받습니다.
  5. 버전을 만들고 포인터를 옮깁니다.
새 실행은 곧바로 새 버전을 씁니다. 돌고 있던 실행은 시작한 버전에서 끝냅니다.

​
배포 전 점검

배포가 여러 점검을 한꺼번에 돌립니다. 다 통과해야 합니다.
  • 필수 입력이 모두 연결됨. 외톨이 블록 없음.
  • 모든 Agent에 프롬프트와 모델이 있음. 빈 칸 없음.
  • 파라미터가 있는 모든 도구에 파라미터 설명이 있음.
  • 모든 시크릿이 풀림. 깨진 참조 없음.
  • 사이클 없음. 경계가 있는 루프를 일부러 쓰지 않는 한 와이어링이 순환하지 않음.
  • Draft가 현재 배포와 다름. 아무것도 안 바꾸는 배포는 없음.
  • 시뮬레이션 게이트(설정했다면). Flow 설정이 시뮬레이션 최소 통과율을 요구하면 그게 먼저 돕니다.
실패하면 무엇이 문제인지 빨간 배너로 알려 줍니다. 고치고 다시 시도하세요.

​
릴리스 노트

선택이지만 꼭 권합니다. 노트는 이런 곳에 뜹니다.
  • 버전 목록.
  • 감사 로그.
  • CLI(nora flows versions list).
  • 연결된 개선의 기록.
좋은 릴리스 노트는 이렇습니다.
“환불 에스컬레이션 강화. 룰 추가: 사용자가 chargeback을 말하면 에스컬레이션. fraud/dispute 키워드면 모델을 상위 티어로. 클러스터 #142 해결.”
나쁜 릴리스 노트는 이렇습니다.
“수정.”
관례로는 배포가 다루는 클러스터 ID나 개선 ID를 링크합니다. 감사가 빨라집니다.

​
CLI로 배포

같은 점검, 같은 동작입니다. CI에서 흔히 이렇게 씁니다.
시뮬레이션을 먼저 돌리고, 통과했을 때만 배포합니다.

​
Canary 배포

새 버전을 canary로 내보냅니다.
버전은 생기지만 트래픽의 5% 만 봅니다. 24~72시간 지켜본 뒤 이렇게 합니다.
트래픽은 스코프 키로 나눕니다. 같은 사용자는 늘 같은 버전에 닿습니다.

​
딸린 리소스 함께 배포

어떤 Flow 변경은 다른 곳도 같이 업데이트해야 합니다.
  • 새 리트리벌 프리셋을 참조하는 Flow를 배포한다면? 프리셋도 배포돼 있어야 합니다.
  • 새 시크릿을 쓰는 새 도구가 든 Flow를 배포한다면? 시크릿이 있어야 합니다.
배포 전 점검이 이런 딸림을 짚어 주고, 배포하거나 업데이트하라고 안내합니다.

​
배포 권한

기본은 Owner와 Manager 입니다. Member는 Draft를 고칠 수 있지만 배포는 못 합니다. Flow settings → Access에서 더 제한할 수 있습니다.

​
Draft는 어떻게 되나

배포는 Draft를 건드리지 않습니다. Draft는 계속 고칠 수 있습니다. 다만 이제 배포된 버전과 달라서 “unpublished changes” 표시가 켜집니다.

​
배포 되돌리기

배포 자체는 되돌릴 수 없습니다. 버전이 이미 생겼으니까요. 하지만 롤백(롤백 참고)이 몇 초 만에 포인터를 뒤로 옮겨, 프로덕션 관점에서는 사실상 배포를 되돌립니다.