릴리스 설정은 프로젝트의 다른 설정과 함께 저장됩니다. 프로젝트를 열고, "설정"을 선택하세요.설정, 그 다음 "릴리스"를 확장하세요.릴리스. 총 세 개의 화면이 있으며, 각 화면은 하나의 질문에 대한 답을 제공합니다.
- 환경
- 릴리스는 어디로 배포되나요? 배포 지점을 추가하고 순서를 정하세요.
- 승인 규칙
- 배포 전에 반드시 충족되어야 할 조건은 무엇인가요? 환경별 승인, 역할, 체크리스트 및 긴급 수정 규칙이 적용됩니다.
- 배포 파이프라인
- 누가 배포하며, Coroid는 어떻게 결과를 확인하나요? 귀사의 파이프라인 또는 Coroid가 배포를 시작하며, 보고용 토큰을 통해 CI/CD가 결과를 확인할 수 있습니다.
소유자와 관리자만 릴리스 설정을 변경할 수 있으며, 다른 사용자는 해당 설정을 확인만 할 수 있습니다. 먼저 저장소를 연결해야 하는데, 모든 릴리스는 저장소 내의 특정 커밋을 가리키기 때문입니다.
환경
릴리스가 전달되는 대상과 순서는 무엇인가요?
모든 프로젝트는 운영 환경에서 시작됩니다. 스테이징이나 QA와 같이 배포할 다른 환경을환경 추가. 각 환경에 이름을 지정하세요. Coroid는 이름에서 키를 추출하는 것을 권장하며, 예시로는staging. CI/CD는 배포 보고 시 해당 키를 사용하므로, 파이프라인에서 활용되기 시작하면 이 키의 안정성을 유지해야 합니다.
순서는 다음 항목을 이용해 지정할 수 있습니다:이후에 실행됨Staging이 선행되지 않으면 바로 Production으로 배포할 수 없으며, Staging 이후에 Production이 오는 경우 경로는 Staging › Production이 됩니다. 릴리스 페이지에는 이 롤아웃 순서가 표시되며, 승인 규칙에서는 앞단계 환경의 배포가 성공해야만 다음 단계로 진행할 수 있도록 설정할 수 있습니다.
승인 규칙
릴리스가 해당 환경에 배포되기 전에 충족되어야 할 조건은 무엇인가요?
상단에서 대상 환경을 선택하세요. 규칙은 환경별로 적용되므로 Staging 환경은 완화된 기준을 적용하고 Production 환경은 엄격한 기준을 적용할 수 있습니다.
- 필요한 승인 횟수: 승인을 위해 필요한 인원의 수입니다. 0으로 설정하면 검증 절차를 통과하는 즉시 릴리스가 배포됩니다.
- 승인 권한이 있는 사용자: 승인을 할 수 있는 조직 내 역할을 지정합니다.
- 요청자와 승인자를 분리하기: 배포를 시작한 사람은 해당 릴리스를 승인할 수 없으며, 릴리스 노트를 편집한 사람도 그 내용을 승인할 수 없습니다.
- 품질 검사 통과: 항상 활성화됩니다. 프로젝트의 품질 그래프와 함께
release_validation해당 트리거는 정확한 커밋을 대상으로 실행됩니다. 프로젝트의 품질 설정에서 해당 그래프를 게시하세요. - 이전 환경 먼저 배포하기: 현재 환경에 배포되기 전에 반드시 앞선 단계 환경에 먼저 배포되어 있어야 합니다.
- 승인된 릴리스 노트: 현재 노트는 승인이 필요하며, 이후의 수정에도 별도의 승인이 필요합니다.
- 체크리스트: 릴리스 페이지에서 담당자가 확인하는 수동 단계로, 예시로는 "데이터베이스 마이그레이션 검토"가 있습니다. 항목을 필수 또는 선택 사항으로 지정할 수 있습니다. 필수 항목의 경우 일시적인 예외를 허용할 수 있습니다. 소유자나 관리자는 예외 사유와 최대 24시간의 유효 기간을 기록하며, 해당 예외는 특정 커밋 및 환경에만 적용됩니다.
- 핫픽스 규칙: 긴급 수정을 위한 완화된 규칙으로, 승인 횟수와 이전 환경 및 노트 승인 여부가 적용 대상입니다. 품질 검사와 필수 체크리스트 항목은 항상 적용되며, 핫픽스는 소유자와 관리자만 승인할 수 있습니다.
선택하기게시 규칙를 눌러 저장하세요. 게시하면 규칙의 새 버전이 생성됩니다. 기존 버전에서 부여된 승인은 더 이상 유효하지 않으므로 진행 중인 릴리스는 다시 승인을 요청합니다. 게시된 규칙이 없는 환경은 검사를 통과할 수 없으며, 시스템에서 이를 알려줍니다.
배포 파이프라인
누가 배포를 시작하며, Coroid는 어떻게 발생한 상황을 파악할까요?
상단에서 환경을 선택한 뒤 배포 시작 방식을 지정하세요:
- 내 파이프라인이 자동으로 배포함: 기존 프로세스를 그대로 유지합니다. Coroid는 CI/CD에서 배포 정보를 전달받거나, 소유자나 관리자가 릴리스 페이지에 외부 배포 내역을 기록할 때 배포 내용을 기록합니다.
- Coroid가 GitHub Actions 워크플로우를 시작함또는Coroid가 GitLab CI/CD 파이프라인을 시작함: 프로젝트 리포지토리가 해당 제공업체를 사용하는 경우에 표시됩니다. 릴리스 커밋을 가리키는 브랜치 또는 태그, GitHub용 워크플로우 파일, 배포를 수행하는 작업의 정확한 이름을 입력하세요. Coroid는 실행을 시작하기 전에 해당 참조를 확인하고, 성공으로 인정하기 전에 지정된 작업을 확인합니다.
아래의배포 보고서에서 환경용 보고서 토큰을 생성하여 CI/CD에 비밀 값으로 저장하세요. Coroid는 토큰을 한 번만 표시하며 해시값만 보관합니다. 토큰을 교체하면 기존 토큰은 즉시 무효화됩니다. 동일한 화면에서는 파이프라인에 필요한 엔드포인트, 프로젝트 ID, 환경 키뿐 아니라 보고서 수신 여부도 확인할 수 있습니다.배포 이벤트 및 CI 설정에 이벤트 형식과 예시가 포함되어 있습니다.
조직 간 설정 이전
설정 내보내기 및 가져오기는 환경, 순서, 파이프라인 구성, 게시된 규칙(핫픽스 규칙 포함)을 포함합니다. 보고서 토큰은 절대 내보내지 않습니다. 가져온 후에는 새 토큰을 생성해야 합니다.