• 배포 추적 설정 방법
  • 예: ArgoCD의 배포 추적

외부 배포 도구의 배포 추적

GitLab은 내장 배포 솔루션을 제공하지만, Heroku 또는 ArgoCD와 같은 외부 배포 도구를 사용하는 것이 더 좋을 수 있습니다.
GitLab은 이러한 외부 도구로부터 배포 이벤트를 수신하고 GitLab 내에서 배포를 추적할 수 있도록 합니다.
예를 들어, 추적 설정을 통해 다음과 같은 기능을 사용할 수 있습니다:

• 병합 요청이 언제 배포되었는지 및 어떤 환경으로 배포되었는지 확인.
• 환경 또는 배포 날짜별로 병합 요청 필터링.
• DevOps Research and Assessment (DORA) 메트릭.
• 환경 및 배포 보기.
• 배포별로 새로 포함된 병합 요청 추적.

배포 추적 설정 방법

외부 배포 도구는 일반적으로 배포 상태가 변경될 때 추가 API 요청을 실행하기 위한 웹후크를 제공합니다.
귀하의 도구를 구성하여 GitLab 배포 API에 요청을 할 수 있습니다. 이벤트 및 API 요청 흐름의 개요는 다음과 같습니다:

• 배포가 시작되면, 상태가 running인 배포 생성.
• 배포가 성공하면, 배포 상태를 success로 업데이트.
• 배포가 실패하면, 배포 상태를 failed로 업데이트.

예: ArgoCD의 배포 추적

ArgoCD 웹후크를 사용하여 배포 이벤트를 GitLab 배포 API로 전송할 수 있습니다.
다음은 ArgoCD가 새 리비전의 배포를 성공적으로 완료했을 때 GitLab에 success 배포 기록을 생성하는 예 설정입니다:

1. 새 웹후크를 생성합니다. 다음 매니페스트 파일을 저장하고 kubectl apply -n argocd -f <manifiest-file-path>로 적용할 수 있습니다:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: argocd-notifications-cm
   data:
     trigger.on-deployed: |
       - description: 애플리케이션이 동기화되고 건강함. 커밋당 한 번 트리거됨.
         oncePer: app.status.sync.revision
         send:
         - gitlab-deployment-status
         when: app.status.operationState.phase in ['Succeeded'] and app.status.health.status == 'Healthy'
     template.gitlab-deployment-status: |
       webhook:
         gitlab:
           method: POST
           path: /projects/<your-project-id>/deployments
           body: |
             {
               "status": "success",
               "environment": "production",
               "sha": "{{.app.status.operationState.operation.sync.revision}}",
               "ref": "main",
               "tag": "false"
             }
     service.webhook.gitlab: |
       url: https://gitlab.com/api/v4
       headers:
       - name: PRIVATE-TOKEN
         value: <your-access-token>
       - name: Content-type
         value: application/json
   

2. 애플리케이션에서 새 구독을 생성합니다:

   kubectl patch app <your-app-name> -n argocd -p '{"metadata": {"annotations": {"notifications.argoproj.io/subscribe.on-deployed.gitlab":""}}}' --type merge