Agentria에서 워크플로우를 완성했다면, API 배포를 통해 다양한 작업에 활용할 수 있습니다.

API를 배포하기 위해서는 먼저, 워크플로우의 배포 버전을 생성해야 합니다.

버전 관리 필요성

버전 관리가 잘 되어 있으면 다음과 같은 이점이 있습니다.

• 변경 내역을 명확히 추적할 수 있습니다.

• 협업 시 팀원 간 혼선을 줄일 수 있습니다.

• 문제 발생 시 안정적인 이전 버전으로 되돌릴 수 있습니다.

• 사용자에게 신뢰성 있는 업데이트를 제공할 수 있습니다.

이 페이지를 통해 버전 번호를 올리는 기준, 실제로 버전을 올리는 방법, 그리고 버전 히스토리를 확인하는 방법에 대해 이해할 수 있습니다.

버전 관리 기준

Agentria의 프로젝트는 유의적 버전 관리를 따릅니다.

(참고: https://semver.org/lang/ko/)

버전 번호는 주요 버전(Major).부 버전(Minor).수 버전(Patch) 형식으로 구성됩니다.

• 주요 버전(Major):

  기준 사용자와의 하위 호환성이 깨지는 변경이 있을 때 올립니다.

  (예시: API 응답 형식이 바뀌거나, 기존 기능이 삭제되는 경우)

• 부 버전(Minor):

  새로운 기능이 추가되었지만 하위 호환성은 유지되는 경우 올립니다.

  (예시: 기존 API에 새로운 파라미터를 추가하거나, 옵션 기능이 생긴 경우)

• 수 버전(Patch):

  버그 수정, 보안 패치, 성능 최적화 등 작은 변경에 사용합니다.

  (예시: 잘못된 계산 로직 수정, UI 오류 해결 등)

예시:

1.4.2 → 1.4.3 (버그 수정)

1.4.2 → 1.5.0 (기능 추가)

1.4.2 → 2.0.0 (하위 호환 깨짐)

1단계: 버전 생성하기

캔버스 우측 상단의 버전(Version) 버튼을 클릭하고 + 아이콘(버전 저장,Create Version) 을 클릭합니다.

팝업창에서 배포 버전을 생성할 수 있습니다.

유의적 버전 관리 기준에 따라 버전과 설명을 입력한 후 생성(Create) 버튼을 클릭합니다.

2단계: 버전 히스토리 확인하기

각 버전은 히스토리 탭에서 확인할 수 있습니다.

3단계: 롤백

각 버전을 선택하면 해당 버전의 노드를 한눈에 확인할 수 있습니다.

이 버전으로 롤백(Rollback to this version) 버튼을 클릭하면 해당 버전으로 돌아갈 수 있습니다.

만약 현재 작업 중인 내역에 대해 버전을 생성하지 않고 롤백을 한다면 작업 중인 모든 변경사항과 테스트 이력이 사라지며 해당 작업 내역을 되돌릴 수 없습니다.

따라서, 롤백을 하기 전에 현재 상태의 버전을 생성해 두는 것을 권장합니다.