GitHub 전달과 실패 복구
개발 전달, 승격, 후보 빌드와 정식 릴리스를 구분합니다.
Clowld Space 자체 개발 흐름의 확장 기능입니다. GitHub 권한과 일치하는 브랜치, 검사, 릴리스 워크플로가 필요합니다. 임의의 저장소를 연결한다고 전체 릴리스 파이프라인이 설치되지는 않습니다. GitHub 연동에서 설정을 시작하세요.
네 단계
| 단계 | 작업 | 완료 조건 |
|---|---|---|
| 개발 전달 | 기능 브랜치에서 dev로 PR을 만들고 Auto-merge 요청 | 요청은 대기 상태이며 실제 병합 후 브랜치에 반영 |
| 승격 | 검증된 dev 스냅샷을 promote/* PR로 main에 병합 | 승격 PR의 실제 병합 |
| 후보 빌드 | 특정 커밋의 산출물을 준비하고 검증 | 후보 워크플로 성공과 연결된 태스크의 후보 증거 확인 |
| 정식 릴리스 | 승인된 버전 Tag 생성 후 릴리스 워크플로 실행 | 정식 워크플로 성공. 후보 성공만으로는 릴리스가 아님 |
Auto-merge 요청 후 개발 에이전트는 전달을 마칠 수 있으며 GitHub가 검사와 병합을 처리합니다. 태스크 자동 완료에는 종료 키워드와 다른 열린 PR 여부 등의 조건이 적용됩니다. GitHub 연동을 참고하세요.
실패 알림
태스크 댓글에 결과, PR 또는 워크플로 링크, 커밋, 실패한 작업이 기록됩니다. 개발 복구는 열린 PR의 현재 커밋에서 Dev PR Gate가 실패해야 시작됩니다. 초안, 오래된 커밋, 취소만 된 개발 검사는 새 복구를 시작하지 않습니다.
승격에는 Promotion Gate를 사용합니다. Actions 읽기 권한과 workflow_job 구독이 있으면 개별 작업 실패를 조기에 알릴 수 있고, 없으면 전체 결과에서 보고할 수 있습니다. 후보와 정식 릴리스 결과는 해당 태스크 연결과 일치해야 합니다.
복구와 사람의 판단
조건에 맞는 실패는 시스템 조정 에이전트 Coco에 전달됩니다. 사용 가능한 에이전트, 런타임과 실행 권한이 필요하며 실패 댓글만으로 수정 실행을 보장하지 않습니다. 중복 Webhook은 복구 횟수에 중복 계산하지 않지만 같은 커밋의 새로운 실패 시도는 계산할 수 있습니다.
동일한 실패가 연속 두 번 또는 총 세 번의 복구 실패가 발생하면 자동 복구를 멈추고 사람의 판단을 요청합니다. 승격, 후보, 정식 릴리스에서는 기존 담당자를 유지합니다. 타임라인과 연결된 로그를 확인하고 차단 원인을 해결한 뒤 기존 승인 범위에서 계속하세요. 대기나 재시도는 성공이 아닙니다.
승격 성공이 릴리스 권한을 부여하지는 않습니다. 릴리스 승인이 없으면 의도 확인 단계에서 멈춥니다.
이 페이지는 현재 코드를 설명합니다. 이전 백엔드는 GitHub 연동의 자동 완료 설정과 버전 안내를 확인하세요.