배포

배포 트리거

방식	트리거	API
수동	프로젝트 헤더의 “Deploy” 버튼	POST /api/projects/{id}/deploy
자동	Git push	GitHub webhook → POST /api/webhook/github

배포 라이프사이클

pending → building → deploying → success
                                → failed

실패한 배포는 POST /api/deployments/{id}/retry로 재시도할 수 있습니다.

파이프라인 시각화

배포 상세 페이지(/$wsId/deployments/$deployId)에서 4단계 파이프라인을 확인할 수 있습니다.

단계	설명
Created	배포 생성 (항상 완료)
Building	빌드 진행 상태
Deploying	배포 진행 상태
Result	최종 성공/실패

각 단계에 타임스탬프가 표시되며, 실패한 단계는 빨간색으로 강조됩니다.

빌드 콜백

빌드는 GitHub Actions에서 수행되며, 완료 시 콜백을 통해 상태가 업데이트됩니다.

GitHub Actions → POST /api/webhook/builder/callback
→ { build_id, run_id, status, conclusion, image_ref, timestamp }
→ 빌드 상태 업데이트 → 배포 상태 전이

알아두기

• 재시도는 실패한 배포만 가능합니다 (다른 상태에서는 409).
• 배포 목록은 최신순 정렬, 프로젝트 개요에서는 최근 5개만 표시됩니다.
• 비활성화된 프로젝트는 배포할 수 없습니다 (409).