자습서: Kubernetes에 카나리아 배포 전략 사용

1. Azure DevOps 프로젝트에서 파이프라인>환경으로 이동한 다음, 환경 또는 새 환경 만들기를 선택합니다.
2. 첫 번째 새 환경 화면에서 이름 아래에 akscanary를 입력하고, 리소스에서 Kubernetes를 선택하고, 다음을 선택합니다.
3. 다음과 같이 Kubernetes 리소스 화면을 채웁니다.
   • 공급자: Azure Kubernetes Service를 선택합니다.
   • Azure 구독: Azure 구독을 선택합니다.
   • 클러스터: AKS 클러스터를 선택합니다.
   • 네임스페이스: 새로 만들기를 선택하고 카나리아데모를 입력합니다.
4. 유효성 검사 및 만들기를 선택합니다.

카나리아 단계 추가

1. 파이프라인으로 이동하여 만든 파이프라인을 선택하고 편집을 선택합니다.

2. 전체 파이프라인 YAML을 다음 코드로 바꿉다.

   이 코드는 스테이지를 Docker@2 사용하기 위해 이전에 실행한 단계를 변경하고, 매니페스트 및 기타 디렉터리를 연속 단계를 사용할 아티팩트로 복사하는 두 단계를 더 추가합니다.

   또한 코드는 파이프라인의 뒷부분에서 더 쉽게 사용할 수 있도록 일부 값을 변수로 이동합니다. 변수에서 containerRegistry 컨테이너 레지스트리의 이름으로 바꿉 <example> 다.

   trigger:
   - main
   
   pool:
     vmImage: ubuntu-latest
   
   variables:
     imageName: azure-pipelines-canary-k8s
     dockerRegistryServiceConnection: azure-pipelines-canary-acr
     imageRepository: 'azure-pipelines-canary-k8s'
     containerRegistry: <example>.azurecr.io
     tag: '$(Build.BuildId)'
   
   stages:
   - stage: Build
     displayName: Build stage
     jobs:  
     - job: Build
       displayName: Build
       pool:
         vmImage: ubuntu-latest
       steps:
       - task: Docker@2
         displayName: Build and push image
         inputs:
           containerRegistry: $(dockerRegistryServiceConnection)
           repository: $(imageName)
           command: buildAndPush
           Dockerfile: app/Dockerfile
           tags: |
             $(tag)
   
       - publish: manifests
         artifact: manifests
   
       - publish: misc
         artifact: misc
   

3. YAML 파일의 끝에 다른 단계를 추가하여 카나리아 버전을 배포합니다. 값을 my-resource-group 리소스 그룹 및 my-aks-cluster Azure Kubernetes Service 클러스터 이름으로 바꿉니다.

   trigger:
   - main
   
   pool:
     vmImage: ubuntu-latest
   
   variables:
     imageName: azure-pipelines-canary-k8s
     dockerRegistryServiceConnection: azure-pipelines-canary-acr
     imageRepository: 'azure-pipelines-canary-k8s'
     containerRegistry: yourcontainerregistry.azurecr.io #update with container registry
     tag: '$(Build.BuildId)'
   
   stages:
   - stage: Build
     displayName: Build stage
     jobs:  
     - job: Build
       displayName: Build
       pool:
         vmImage: ubuntu-latest
       steps:
       - task: Docker@2
         displayName: Build and push image
         inputs:
           containerRegistry: $(dockerRegistryServiceConnection)
           repository: $(imageName)
           command: buildAndPush
           Dockerfile: app/Dockerfile
           tags: |
             $(tag)
   
       - publish: manifests
         artifact: manifests
   
       - publish: misc
         artifact: misc
   
   - stage: DeployCanary
     displayName: Deploy canary
     dependsOn: Build
     condition: succeeded()
   
     jobs:
     - deployment: Deploycanary
       displayName: Deploy canary
       pool:
         vmImage: ubuntu-latest
       environment: 'akscanary'
       strategy:
         runOnce:
           deploy:
             steps:
             - task: KubernetesManifest@1
               displayName: Create Docker Registry Secret
               inputs:
                 action: 'createSecret'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'my-resource-group'
                 kubernetesCluster: 'my-aks-cluster'
                 secretType: 'dockerRegistry'
                 secretName: 'my-acr-secret'
                 dockerRegistryEndpoint: 'azure-pipelines-canary-acr'
   
             - task: KubernetesManifest@1
               displayName: Deploy to Kubernetes cluster
               inputs:
                 action: 'deploy'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'my-resource-group'
                 kubernetesCluster: 'my-aks-cluster'
                 strategy: 'canary'
                 percentage: '25'
                 manifests: |
                   $(Pipeline.Workspace)/manifests/deployment.yml
                   $(Pipeline.Workspace)/manifests/service.yml
                 containers: '$(containerRegistry)/$(imageRepository):$(tag)'
                 imagePullSecrets: 'my-acr-secret'
   
             - task: KubernetesManifest@1
               displayName: Deploy Forbio to Kubernetes cluster
               inputs:
                 action: 'deploy'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'my-resource-group'
                 kubernetesCluster: 'my-aks-cluster'
                 manifests: '$(Pipeline.Workspace)/misc/*'
   

4. 유효성 검사 및 저장을 선택하고 파이프라인을 주 분기에 직접 저장합니다.

1. 파이프라인 릴리스>새>릴리스>파이프라인으로 이동합니다. 이름을 CanaryK8sDemo로 지정합니다.
2. 1단계에 대한 템플릿을 선택하는 후속 모델에서 빈 작업을 선택합니다. 스테이지 이름을 배포 카나리아로 지정 합니다.
3. 아티팩트 추가를 선택하고 GitHub를 선택합니다.
   • 기존 Git 서비스 연결을 선택하거나 포크된 리포지토리에 액세스할 수 있는 새 연결을 만듭니다. 그런 다음 원본(리포지토리) 드롭다운 목록에서 동일한 것을 선택합니다.
   • 기본 분기: main
   • 기본 버전: 기본 분기 최신 버전을 선택합니다.
   • 원본 별칭: azure-pipelines-canary-k8s
   • 추가를 선택하여 입력을 확인합니다.
4. 아티팩트 추가를 선택하고 이전에 선택한 컨테이너 레지스트리에 따라 "필수 구성 요소" 섹션에서 Azure Container Registry 또는 Docker Hub를 선택합니다. 입력 드롭다운 목록에 적절한 값을 제공하여 컨테이너 레지스트리를 찾습니다. 이미지를 이 아티팩트 별칭으로 제공하고 추가를 선택하여 입력을 확인합니다. 아티팩트가 추가되면 아티팩트 카드에서 번개 모양 아이콘을 선택하여 연속 배포 트리거를 사용하도록 설정합니다.
5. 만든 카나리아 배포 단계에서 1개의 작업, 0개의 작업 링크를 선택하여 작업 및 스테이지를 추가하기 위한 창으로 이동합니다.
6. 에이전트 작업을 선택합니다. 구성 창의 에이전트 풀 드롭다운 목록에서 Hosted Ubuntu 22.04를 선택합니다.
7. + 에이전트 작업 행의 로그온을 선택하여 새 작업을 추가합니다. 다음 구성을 사용하여 Kubernetes 매니페스트 배포 작업을 추가합니다 .
   • 표시 이름: 비밀 만들기
   • 작업: 비밀 만들기
   • Kubernetes 서비스 연결: azure-pipelines-canary-k8s
   • 네임스페이스: 배포하려는 클러스터 내의 네임스페이스입니다.
   • 비밀 유형: dockerRegistry
   • 비밀 이름: azure-pipelines-canary-k8s
   • Docker 레지스트리 서비스 연결: azure-pipelines-canary-k8s
8. 다음 구성을 사용하여 다른 Kubernetes 매니페스트 배포 작업을 추가합니다 .
   • 표시 이름: 카나리아 배포
   • 작업: 배포
   • Kubernetes 서비스 연결: azure-pipelines-canary-k8s
   • 네임스페이스: 배포하려는 클러스터 내의 네임스페이스입니다.
   • 전략: 카나리아
   • 백분율: 25
   • 매니페스트: azure-pipelines-canary-k8s/manifests/*
   • 컨테이너: <example>/azure-pipelines-canary-k8s:$(Release.Artifacts.image.BuildId), 컨테이너 레지스트리 URL로 바꿀 위치 <example> 입니다.
   • ImagePullSecrets: azure-pipelines-canary-k8s
9. 다음 구성을 사용하여 다른 Kubernetes 매니페스트 배포 작업을 추가합니다 .
   • 표시 이름: Fortio 및 ServiceMonitor 배포
   • 작업: 배포
   • Kubernetes 서비스 연결: azure-pipelines-canary-k8s
   • 네임스페이스: 배포하려는 클러스터 내의 네임스페이스입니다.
   • 전략: 없음
   • 매니페스트: azure-pipelines-canary-k8s/misc/*

1. akspromote라는 새 Kubernetes 환경을 만듭니다.
2. 환경 목록에서 새 akspromote 환경을 열고 승인 및 확인 탭에서 승인을 선택합니다.
3. 승인 화면에서 승인자 아래에 사용자 계정을 추가합니다.
4. 고급을 확장하고 승인자가 자신의 실행을 승인하도록 허용이 선택되어 있는지 확인합니다.
5. 만들기를 실행합니다.

파이프라인에 승격 및 거부 단계 추가

1. 파이프라인으로 이동하여 만든 파이프라인을 선택하고 편집을 선택합니다.

2. 변경 내용을 승격하는 YAML 파일의 끝에 다음 PromoteRejectCanary 단계를 추가합니다.

   - stage: PromoteRejectCanary
     displayName: Promote or Reject canary
     dependsOn: DeployCanary
     condition: succeeded()
   
     jobs:
     - deployment: PromoteCanary
       displayName: Promote Canary
       pool: 
         vmImage: ubuntu-latest
       environment: 'akspromote'
       strategy:
         runOnce:
           deploy:
             steps:      
             - task: KubernetesManifest@1
               displayName: Create Docker Registry Secret for akspromote
               inputs:
                 action: 'createSecret'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'my-resource-group'
                 kubernetesCluster: 'my-aks-cluster'
                 secretType: 'dockerRegistry'
                 secretName: 'my-acr-secret'
                 dockerRegistryEndpoint: 'azure-pipelines-canary-acr'
   
             - task: KubernetesManifest@1
               displayName: promote canary
               inputs:
                 action: 'promote'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'my-resource-group'
                 kubernetesCluster: 'my-aks-cluster'
                 strategy: 'canary'
                 manifests: '$(Pipeline.Workspace)/manifests/*'
                 containers: '$(containerRegistry)/$(imageRepository):$(tag)'
                 imagePullSecrets: 'my-acr-secret'
       ```
   
   

3. 변경 내용을 롤백하는 파일의 끝에 다음 RejectCanary단계를 추가합니다.

   - stage: RejectCanary
     displayName: Reject canary
     dependsOn: PromoteRejectCanary
     condition: failed()
   
     jobs:
     - deployment: RejectCanary
       displayName: Reject Canary
       pool: 
         vmImage: ubuntu-latest
       environment: 'akscanary'
       strategy:
         runOnce:
           deploy:
             steps:        
             - task: KubernetesManifest@1
               displayName: Create Docker Registry Secret for reject canary
               inputs:
                 action: 'createSecret'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'kubernetes-testing'
                 kubernetesCluster: 'my-aks-cluster'
                 secretType: 'dockerRegistry'
                 secretName: 'my-acr-secret'
                 dockerRegistryEndpoint: 'azure-pipelines-canary-acr'    
             - task: KubernetesManifest@1
               displayName: Reject canary deployment
               inputs:
                 action: 'reject'
                 connectionType: 'azureResourceManager'
                 azureSubscriptionConnection: 'azure-pipelines-canary-sc'
                 azureResourceGroup: 'my-resource-group'
                 kubernetesCluster: 'my-aks-cluster'
                 namespace: 'default'
                 strategy: 'canary'
                 manifests: '$(Pipeline.Workspace)/manifests/*'
       ```
   

4. 유효성 검사 및 저장을 선택하고 파이프라인을 주 분기에 직접 저장합니다.

1. 파이프라인 탭을 선택하여 파이프라인 보기로 돌아갑니다. 빈 작업 템플릿에 따라 카나리아 승격/거부라는 새 단계를 추가합니다.
2. 이 단계에 에이전트 없는 작업을 추가하고 이 작업의 순서를 이 단계의 첫 번째 작업으로 다시 정렬합니다. 이 에이전트 없는 작업의 이름을 승격/거부 입력으로 지정합니다.
3. 이 작업에 수동 개입 태스크를 추가하고 작업의 표시 이름을 카나리아 승격 또는 거부로 변경합니다.
4. 승격/거부 입력 에이전트 없는 작업 후에 현재 빈 에이전트 작업을 구성합니다.
   • 표시 이름: 카나리아 승격
   • 에이전트 풀: 호스트된 Ubuntu 22.04
   • 이 작업 실행: 이전 작업이 모두 성공한 경우에만 실행하도록 선택합니다.
5. 다음 구성을 사용하여 Kubernetes 매니페스트 배포 작업을 카나리아 승격 작업에 추가합니다.
   • 표시 이름: 카나리아 승격
   • 작업: 승격
   • Kubernetes 서비스 연결: azure-pipelines-canary-k8s
   • 네임스페이스: 배포하려는 클러스터 내의 네임스페이스입니다.
   • 전략: 카나리아
   • 백분율: 25
   • 매니페스트: azure-pipelines-canary-k8s/manifests/*
   • 컨테이너: <example>/azure-pipelines-canary-k8s:$(Release.Artifacts.image.BuildId)컨테이너 레지스트리 URL로 바꿉 <example> 니다.
   • ImagePullSecrets: azure-pipelines-canary-k8s
6. 카나리아 에이전트 승격 작업 후에 다음 구성을 사용하여 다른 에이전트 작업을 추가합니다.
   • 표시 이름: 카나리아 거부
   • 에이전트 풀: 호스트된 Ubuntu 22.04
   • 이 작업 실행: 이전 작업이 실패한 경우에만 실행하도록 선택합니다.
7. 다음 구성을 사용하여 Kubernetes 매니페스트 배포 작업을 카나리아 거부 작업에 추가합니다.
   • 표시 이름: 카나리아 거부
   • 작업: 거부
   • Kubernetes 서비스 연결: azure-pipelines-canary-k8s
   • 네임스페이스: 배포하려는 클러스터 내의 네임스페이스입니다.
   • 전략: 카나리아
   • 백분율: 25
   • 매니페스트: azure-pipelines-canary-k8s/manifests/*

1. 앱/app.py success_rate = 50success_rate = 100. 이 변경은 파이프라인을 트리거하고, 이미지를 빌드하고 컨테이너 레지스트리에 푸시하고, 스테이지를 트리거합니다 DeployCanary .
2. 환경에 대한 akspromote 승인을 구성했기 때문에 릴리스는 해당 단계를 실행하기 전에 대기합니다. 빌드 실행 요약 페이지에서 검토를 선택한 다음 승인을 선택합니다.

승인되면 파이프라인은 매니페스트/deployment.yml 안정적인 버전의 sampleapp 워크로드를 네임스페이스에 배포합니다.

1. 앱/app.py success_rate = 50success_rate = 100. 이 변경은 파이프라인을 트리거하여 이미지를 빌드하고 컨테이너 레지스트리로 푸시합니다. 이미지 푸시 이벤트에 앞서 설정된 연속 배포 트리거는 릴리스 파이프라인을 트리거합니다.
2. CanaryK8sDemo 릴리스 파이프라인에서 수동 개입을 기다리는 릴리스의 카나리아 수준 올리기/거부 단계를 선택합니다.
3. 다시 시작/거부를 선택한 다음, 후속 대화 상자에서 다시 시작을 선택합니다. 그러면 안정적인 버전의 워크로드(sampleapp매니페스트/deployment.yml 배포)가 네임스페이스에 배포됩니다.

1. 앱/app.py success_rate = 50success_rate = 100. 이 변경은 파이프라인을 트리거하고, 이미지를 빌드하고 컨테이너 레지스트리에 푸시하고, 스테이지를 트리거합니다 DeployCanary .
2. 환경에 대한 akspromote 승인을 구성했기 때문에 릴리스는 해당 단계를 실행하기 전에 대기합니다.
3. 빌드 실행 요약 페이지에서 검토를 선택한 다음, 후속 대화 상자에서 [거부]를 선택합니다. 이렇게 하면 배포가 거부됩니다.

거부되면 파이프라인은 코드 배포를 방지합니다.

1. 앱/app.py success_rate = 50success_rate = 100. 이 변경은 파이프라인을 트리거하여 이미지를 빌드하고 컨테이너 레지스트리로 푸시합니다. 이미지 푸시 이벤트에 앞서 설정된 연속 배포 트리거는 릴리스 파이프라인을 트리거합니다.
2. CanaryK8sDemo 릴리스 파이프라인에서 수동 개입을 기다리는 릴리스의 카나리아 수준 올리기/거부 단계를 선택합니다.
3. 다시 시작/거부를 선택한 다음, 후속 대화 상자에서 [거부]를 선택합니다. 이렇게 하면 배포가 거부됩니다.