자동 배포 (CI/CD 파이프라인)

Nexus Agent Platform은 버전업이나 신규 기능 출시, 안정성 개선 작업을 손쉽게 관리할 수 있도록 GitHub Actions 파이프라인에 최적화되어 설계되었습니다.

빌드 파이프라인

이 프로젝트에는 GitHub Release에 배포판(.whl)을 자동으로 추가하는 GitHub Actions(publish.yml)가 준비되어 있습니다.

파이프라인 트리거 요건

# 1. pyproject.toml과 __init__.py의 버전을 일치시킨다.
# 2. 커밋을 찍고 버전을 태깅한다.
git tag v0.4.13
git push origin main && git push origin v0.4.13

버전 태깅이 origin 레포지토리에 푸시되면 깃허브 액션이 실행되어, frontend 빌드를 유도한 뒤 통합 휠 빌드를 거쳐 Release Attach로 최종 업로드됩니다.

문서 자동화 파이프라인 연계 방안

해당 플랫폼의 파이프라인 마지막 단계에서 본 문서 페이지 리포지토리(예: track_platform_docs)로 트리거 훅(webhook)을 날릴 수 있습니다. 그러면 웹훅을 받은 문서 레포지토리의 Actions(deploy.yml)가 최신 릴리즈된 track_platform 파이썬 패키지를 설치해 pydoc-markdown를 가동하여, 새로운 버전에 맞는 API Reference와 문서를 Cloudflare Pages에 자동 재배포할 수 있습니다.

참고: CI/CD 상에서 Private Package 상태인 Nexus Agent 파이썬 패키지를 설치해야 하는 경우 GITHUB_TOKEN 환경변수가 유효한지 사전에 점검해야 합니다.