배포 이벤트 및 CI 설정

Coroid는 귀하의 CI/CD에서 승인할 때에만 릴리스를 배포로 표시합니다. 이 페이지에서는 파이프라인이 배포 상황을 어떻게 보고하는지, Coroid가 배포를 시작하는지 아니면 자체적으로 실행되는지를 설명합니다.

아래의 모든 설정은 프로젝트의 설정 내 각 환경별로 구성됩니다.설정 → 릴리스 → 배포 파이프라인. 거기서 보고용 토큰을 생성하세요. 소유자나 관리자는 이 토큰을 한 번만 확인할 수 있습니다. 해당 환경의 CI 파이프라인에 비밀 값으로 저장하세요. Coroid는 해시값만 보관하며, 토큰을 교체하면 기존 토큰은 즉시 무효화됩니다. 이 토큰은 오직 해당 프로젝트와 환경에 대해서만 보고 기능을 수행할 수 있습니다. 절대 안 함 저장소 파일이나 브라우저 요청에 포함시키지 마세요.

GitHub 작업 및 GitLab CI/CD#

원하신다면**배포 대상…**릴리스 페이지의 버튼을 선택하세요.**Coroid는 GitHub 작업 워크플로우를 시작합니다.또는Coroid는 GitLab CI/CD 파이프라인을 시작합니다.**환경의 배포 파이프라인 설정에서 지정하세요. 정확한 배포 작업 이름, 브랜치 또는 태그 참조, 필요한 경우 GitHub 워크플로우 파일명을 입력하세요. 이 참조는 요청 시점에 릴리스 커밋을 가리켜야 합니다. GitHub 워크플로우는coroid_release_id, coroid_attempt_id, coroid_commit_sha, 및coroid_environment입력값을 받습니다. GitLab는 이에 상응하는 대문자 형태의COROID_*변수를 사용합니다. 이러한 값을 활용하여 정확한 SHA와 시도 횟수를 배포하고 보고할 수 있습니다.

환경 콜백 토큰은 GitHub 작업 비밀 값 또는 GitLab CI/CD 마스킹된 변수에 저장하세요.running이벤트를 배포 작업 시작 시 전송하고 종료 시에는succeeded, failed, 또는cancelled이벤트를 전송하세요. Coroid는 구성된 파이프라인의 성공 여부를 판단하기 전에 제공업체의 실행 내역, 커밋, 지정된 작업을 확인합니다. 로그를 확인하려면 제공업체의 실행 URL을 참고하세요.Coroid 프로덕션 워크플로우구체적인 GitHub 작업 예제가 포함되어 있으며, 비밀 값 이름과 작업 내용을 귀하의 저장소에 맞게 조정하면 됩니다.

일반 CI 콜백#

외부 파이프라인은 디스패치를 활성화하지 않고도 동일한 이벤트를 전송할 수 있습니다. 환경별 범위가 지정된 베어러 토큰으로 인증하세요. 엔드포인트는 다음과 같은 버전형 구조의 JSON를 수락합니다:

POST /api/v1/release-deployment-events
Authorization: Bearer <environment-callback-token>
Content-Type: application/json

{
  "schemaVersion": 1,
  "eventId": "ci:run-812:production:succeeded",
  "providerRunId": "run-812",
  "projectId": "<project-uuid>",
  "environmentKey": "production",
  "repository": "owner/repository",
  "commitSha": "0123456789abcdef0123456789abcdef01234567",
  "status": "succeeded",
  "occurredAt": "2026-09-24T12:00:00Z",
  "runUrl": "https://ci.example.com/runs/812"
}

포함하세요releaseId및attemptIdCoroid가 요청한 실행 상황을 보고할 때 사용합니다.failureReason는 실행 실패 원인을 설명할 수 있습니다.queued, running, succeeded, failed, 또는cancelled에 대해 사용하세요status. 하나의providerRunId실행 과정 내내 유지하고 각 상태 전환마다 고유한eventId. 동일한 이벤트를 재시도할 경우 ID는 그대로 유지되며, 새로운 CI 실행 시에는 새로운 실행 ID가 필요합니다. 이벤트 타임스탬프는 최신이어야 합니다. Coroid는 이를 적용하기 전에 저장소, 환경, 커밋, 자격 증명 범위, 종료 상태를 확인하며, 상충되는 이벤트는 검토를 위해 보류됩니다. 준비된 릴리스 없이 유효한 배포가 이루어지면 관찰 가능한 릴리스가 생성되며, 이는 사전 승인된 후보와는 명확히 구분됩니다.

콜백 기능이 없는 파이프라인의 경우, 소유자나 관리자는외부 배포 기록릴리스 페이지에서 선택하세요. 환경, 일치하는 커밋, 시간, 사유 또는 증거 URL을 입력하세요. 결과적으로 생성되는 수동 증명서는 Coroid가 CI를 실행했거나 게이트를 통과했다고 주장하지 않고도 결과를 기록합니다.

관련 항목#

• 릴리스 설정
• 릴리스
• 복구 및 릴리스 트레인