Agentria에서 서비스를 운영할 때 가장 중요한 것 중 하나가 바로 버전 관리입니다.

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

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

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

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

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

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

버전 관리 기준

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

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

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

• 주요 버전(Major):

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

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

• 부 버전(Minor):

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

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

• 수 버전(Patch):

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

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

예시

버전 올리기

Agentria에서 버전을 올리는 과정은 캔버스 안에서 쉽게 수행할 수 있습니다.

캔버스 편집 화면 우측 상단에서 Publish 버튼을 클릭합니다.

메뉴에서 Create Version (Temporary) 를 선택합니다.

모달창에서 버전 번호를 입력할 수 있습니다.

• 이때 반드시 버전 관리 기준에 따라 올바른 형식을 지정합니다.

Create 버튼을 누르면 새로운 버전이 생성됩니다.

버전 히스토리

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

• 모든 버전은 버전 순서대로 나열됩니다.

버전 관리 원칙

버전 관리를 효과적으로 하기 위해 다음의 원칙을 지키는 것이 좋습니다.

• 작은 단위로 자주 버전 업데이트: 큰 단위로 한꺼번에 변경하기보다는, 작은 단위로 버전을 개선해나가는 것이 관리 측면에서 용이합니다.

• 변경 내역 문서화: 새로운 버전을 올릴 때마다 간단히 문서화를 진행하면 협업에 도움이 됩니다.

• 테스트 후 배포: 특히 주요 버전/부 버전 업데이트 시 반드시 검증 과정을 거친 후 배포해야 안정적입니다.