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

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

버전 관리 필요성

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

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

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

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

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

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

버전 관리 기준

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

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

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

• 주요 버전(Major):

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

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

• 부 버전(Minor):

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

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

• 수 버전(Patch):

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

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

예시

1단계: 버전 생성하기

캔버스 우측 상단의 Publish 버튼을 클릭하고 Create Version 을 선택합니다.

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

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

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

버전이 생성되면 캔버스 우측 상단의 Version History 버튼을 눌러 기록을 관리할 수 있습니다.