버전 관리

버전 관리 (Version Control)

Dify 공식 문서 — Version Control 를 한국어로 번역·재해석했어요. 기술 용어는 원문 표기를 보존했어요.

Chatflow와 Workflow 앱에서 변경 사항을 추적하고 버전을 관리하는 방법이에요.

버전 관리는 지금은 Chatflow와 Workflow 앱에서만 사용할 수 있어요.

어떻게 동작하나

Current Draft (현재 초안): 작업 중인 버전이에요. 여기서 수정하며, 아직 사용자에게 공개되지 않아요.
Latest Version (최신 버전): 사용자가 실제로 보는 라이브 버전이에요.
Previous Versions (이전 버전): 과거에 발행했던 버전들이에요.

버전 발행하기

Publish → Publish Update를 클릭하면 초안이 라이브가 돼요. 초안이 새로운 Latest Version이 되고, 이어서 작업할 새 초안이 생겨요.

버전 보기

히스토리 아이콘을 클릭하면 모든 버전을 볼 수 있어요. 다음과 같이 필터링할 수 있어요.

모든 버전 또는 내 버전만
이름이 붙은 버전만(자동 생성 이름 건너뛰기)

버전 관리하기

버전 이름 짓기: 자동 생성된 이름 대신 적절한 이름을 붙여요.
버전 정보 수정: 이름을 바꾸고 릴리즈 노트를 추가해요.
오래된 버전 삭제: 필요 없는 버전을 정리해요. 단, Current Draft와 Latest Version은 삭제할 수 없어요.
버전 복원(Restore): 이전 버전을 초안으로 다시 불러와요. 이때 현재 초안을 완전히 대체하므로, 저장하지 않은 작업이 없도록 주의해야 해요.

버전 복원, 특정 버전의 DSL 내보내기, Service API로 특정 발행 버전 실행은 유료 플랜에서 지원돼요. Sandbox 플랜에서는 앱이 항상 최신 발행 버전을 실행해요.

버전 사용 예시

일반적인 개발 사이클에서 버전이 어떻게 흘러가는지예요.

초안으로 시작 → 2. 첫 버전 발행 → 3. 두 번째 버전 발행 → 4. 이전 버전을 초안으로 복원 → 5. 복원된 버전 발행

팁

발행 전에 항상 초안에서 먼저 테스트하기
중요한 릴리즈에는 설명적인 버전 이름 사용하기
빠른 롤백이 필요할 때는 버전 복원 활용하기
참고용으로 이전 버전은 남겨두기

출처: https://docs.dify.ai/en/cloud/use-dify/build/version-control