Argo Rollouts

프로세스

1. OpenShift Container Platform 웹 콘솔에 클러스터 관리자로 로그인합니다.
2. 관리자 화면에서 Operator → 설치된 Operator 를 클릭합니다.
3. 프로젝트 드롭다운 메뉴에서 RolloutManager CR(사용자 정의 리소스)을 생성하고 구성할 프로젝트를 생성하거나 선택합니다.
4. 설치된 Operator에서 Red Hat OpenShift GitOps 를 선택합니다.
5. 세부 정보 탭의 제공된 API 섹션에서 RolloutManager 창에서 인스턴스 생성 을 클릭합니다.

6. RolloutManager 생성 페이지에서 YAML 보기를 선택하고 기본 YAML을 사용하거나 요구 사항에 따라 편집합니다.

   예: RolloutManager CR

   apiVersion: argoproj.io/v1alpha1
   kind: RolloutManager
   metadata:
     name: argo-rollout
     namespace: openshift-gitops
   spec: {}

   Copy to Clipboard Toggle word wrap

7. 생성을 클릭합니다.
8. RolloutManager 탭의 RolloutManagers 섹션에서 RolloutManager 인스턴스의 Status 필드가 Phase: Available 로 표시되는지 확인합니다.

9. 왼쪽 탐색 창에서 네임스페이스 범위 지원 리소스 생성을 확인합니다.

   • 워크로드 → 배포를 클릭하여 argo-rollouts 배포를 실행 중인 1개의 Pod 중 1 개로 표시된 상태에서 사용할 수 있는지 확인합니다.
   • 워크로드 → 시크릿을 클릭하여 argo-rollouts-notification-secret 시크릿을 사용할 수 있는지 확인합니다.
   • 네트워킹 → 서비스를 클릭하여 argo-rollouts-metrics 서비스를 사용할 수 있는지 확인합니다.
   • 사용자 관리 → 역할을 클릭하여 argo-rollouts 역할 및 argo-rollouts-aggregate-to-admin,argo-rollouts-aggregate-to-edit, argo-rollouts-aggregate-to-view 클러스터 역할을 사용할 수 있는지 확인합니다.
   • 사용자 관리 → RoleBindings 를 클릭하여 argo-rollouts 역할 바인딩을 사용할 수 있는지 확인합니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에 클러스터 관리자로 로그인합니다.
2. 관리자 화면에서 Operator → 설치된 Operator 를 클릭합니다.
3. 프로젝트 드롭다운 메뉴를 클릭하고 RolloutManager CR이 포함된 프로젝트를 선택합니다.
4. 설치된 Operator에서 Red Hat OpenShift GitOps 를 선택합니다.
5. RolloutManager 탭을 클릭하여 RolloutManagers 섹션에서 RolloutManager 인스턴스를 찾습니다.
6. 인스턴스를 클릭합니다.
7. 드롭다운 메뉴에서 작업 → 롤아웃 삭제 를 클릭하고 삭제 를 클릭하여 대화 상자에서 확인합니다.
8. RolloutManager 탭의 RolloutManagers 섹션에서 RolloutManager 인스턴스를 더 이상 사용할 수 없는지 확인합니다.

9. 왼쪽 탐색 창에서 네임스페이스 범위의 지원 리소스가 삭제되었는지 확인합니다.

   • 워크로드 → 배포를 클릭하여 argo-rollouts 배포가 삭제되었는지 확인합니다.
   • 워크로드 → 시크릿을 클릭하여 argo-rollouts-notification-secret 시크릿이 삭제되었는지 확인합니다.
   • 네트워킹 → 서비스를 클릭하여 argo-rollouts-metrics 서비스가 삭제되었는지 확인합니다.
   • 사용자 관리 → 역할을 클릭하여 argo-rollouts 역할 및 argo-rollouts-aggregate-to-admin,argo-rollouts-aggregate-to-edit, argo-rollouts-aggregate-to-view 클러스터 역할이 삭제되었는지 확인합니다.
   • 사용자 관리 → RoleBindings 를 클릭하여 argo-rollouts 역할 바인딩이 삭제되었는지 확인합니다.

프로세스

1. 다음 명령을 실행하여 Argo Rollouts CLI 바이너리 kubectl-argo-rollouts 의 최신 버전을 다운로드합니다.

   $ curl -LO https://github.com/argoproj/argo-rollouts/releases/latest/download/kubectl-argo-rollouts-linux-amd64

   Copy to Clipboard Toggle word wrap

2. 다음 명령을 실행하여 kubectl-argo-rollouts 바이너리가 실행 가능한지 확인합니다.

   $ chmod +x ./kubectl-argo-rollouts-linux-amd64

   Copy to Clipboard Toggle word wrap

3. 다음 명령을 실행하여 kubectl-argo-rollouts 바이너리를 시스템 경로로 이동합니다.

   # mv ./kubectl-argo-rollouts-linux-amd64 /usr/local/bin/kubectl-argo-rollouts

   Copy to Clipboard Toggle word wrap
   중요

   이 명령을 실행할 수 있는 슈퍼유저 권한이 있는지 확인합니다.

4. 다음 명령을 실행하고 유사한 출력을 수신하여 플러그인이 올바르게 설치되었는지 확인합니다.

   $ oc argo rollouts version

   Copy to Clipboard Toggle word wrap

   출력 예

   kubectl-argo-rollouts: v1.6.6+737ca89
     BuildDate: 2024-02-13T15:39:31Z 

   1

   
     GitCommit: 737ca89b42e4791e96e05b438c2b8540737a2a1a
     GitTreeState: clean
     GoVersion: go1.20.14 

   2

   
     Compiler: gc
     Platform: linux/amd64 

   3

   Copy to Clipboard Toggle word wrap

   1

   Argo Rollouts 바이너리의 빌드 날짜 정보입니다.

   2

   Argo Rollouts 바이너리를 빌드하는 데 사용되는 Go 언어의 버전입니다.

   3

   Argo Rollouts 바이너리를 빌드하는 데 사용되는 플랫폼입니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에 로그인합니다.
2. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator 를 클릭합니다.
3. 설치된 Operator 목록에서 Red Hat OpenShift GitOps 를 선택하고 Argo CD 탭을 클릭합니다.
4. openshift-gitops 네임스페이스의 Argo CD 탭에서 Argo CD 인스턴스를 선택합니다.

5. YAML 을 클릭하고 다음 구성을 추가하여 Argo Rollouts UI를 구성합니다.

   Argo CD CR에서 Argo 롤아웃 UI 활성화 예

   apiVersion: argoproj.io/v1beta1
   kind: ArgoCD
   metadata:
     name: argocd
   spec:
     server:
       enableRolloutsUI: true 

   1

   Copy to Clipboard Toggle word wrap

   1

   이 값을 true 로 설정하여 enableRolloutsUI 필드를 구성합니다.

6. 저장을 클릭합니다.
7. 웹 콘솔의 관리자 화면에서 메뉴 → OpenShift GitOps → 클러스터 Argo CD 로 이동합니다. Argo CD 웹 UI의 로그인 페이지가 새 창에 표시됩니다.

8. Argo CD 웹 UI에서 Argo 롤아웃 UI에 액세스하려면 Argo 롤아웃 리소스가 포함된 샘플 애플리케이션을 구성합니다.

   참고

   enableRolloutsUI 필드는 Argo CD 서버 배포 Pod를 다시 시작하므로 Argo Rollouts 확장을 사용하여 Argo CD 웹 UI에서 활성화하는 데 몇 초가 걸립니다.

프로세스

1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 롤아웃 을 클릭합니다.
2. 프로젝트 드롭다운 메뉴에서 롤아웃 사용자 정의 리소스(CR)를 생성하고 구성할 프로젝트를 생성하거나 선택합니다.

3. 롤아웃 생성 을 클릭하고 YAML 보기에 다음 구성을 입력합니다.

   apiVersion: argoproj.io/v1alpha1
   kind: Rollout
   metadata:
     name: rollouts-demo
   spec:
     replicas: 5
     strategy:
       canary: 

   1

   
         steps: 

   2

   
         - setWeight: 20 

   3

   
         - pause: {}  

   4

   
         - setWeight: 40
         - pause: {duration: 45}  

   5

   
         - setWeight: 60
         - pause: {duration: 20}
         - setWeight: 80
         - pause: {duration: 10}
     revisionHistoryLimit: 2
     selector:
       matchLabels:
         app: rollouts-demo
     template: 

   6

   
       metadata:
         labels:
           app: rollouts-demo
       spec:
         containers:
         - name: rollouts-demo
           image: argoproj/rollouts-demo:blue
           ports:
           - name: http
             containerPort: 8080
             protocol: TCP
           resources:
             requests:
               memory: 32Mi
               cpu: 5m

   Copy to Clipboard Toggle word wrap

   1

   롤아웃에서 사용해야 하는 배포 전략입니다.

   2

   롤아웃 단계를 지정합니다. 이 예에서는 20%, 40%, 60 % 및 80%의 트래픽을 카나리아 버전으로 점진적으로 라우팅합니다.

   3

   카나리아 버전으로 이동해야 하는 트래픽의 백분율입니다. 값 20은 트래픽의 20%가 카나리아 버전으로 전달됨을 의미합니다.

   4

   승격 요청을 찾을 때까지 무기한 중지하려면 Argo Rollouts 컨트롤러에 지정합니다.

   5

   Argo Rollouts 컨트롤러에 45초 동안 일시 중지하도록 지정합니다. 기간 값은 초(s), 분(m) 또는 시간(h)으로 설정할 수 있습니다. 예를 들어 1시간 동안 1h 를 지정할 수 있습니다. 값을 지정하지 않으면 duration 값은 기본값을 초로 설정합니다.

   6

   생성할 Pod를 지정합니다.

4. 생성을 클릭합니다.

   참고

   생성 시 롤아웃을 빠르게 사용할 수 있도록 Argo Rollouts 컨트롤러는 .spec.template.spec.containers.image 필드에 지정된 argoproj/rollouts-demo:blue 초기 컨테이너 이미지를 안정적인 버전으로 자동으로 처리합니다. 초기 인스턴스에서 Rollout 리소스 생성은 모든 트래픽을 애플리케이션의 안정적인 버전으로 라우팅하고 트래픽이 카나리아 버전으로 전송되는 부분을 건너뜁니다. 그러나 이후의 모든 애플리케이션에서 .spec.template.spec.containers.image 필드를 수정하여 업그레이드하면 Argo Rollouts 컨트롤러는 다음과 같이 카나리아 단계를 수행합니다.

5. 다음 명령을 실행하여 롤아웃이 올바르게 생성되었는지 확인합니다.

   $ oc argo rollouts list rollouts -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   출력 예

   NAME           STRATEGY   STATUS        STEP  SET-WEIGHT  READY  DESIRED  UP-TO-DATE  AVAILABLE
   rollouts-demo  Canary     Healthy       8/8   100         5/5    5        5           5

   Copy to Clipboard Toggle word wrap

6. rollouts-demo 롤아웃을 대상으로 하는 Kubernetes 서비스를 생성합니다.

   1. 웹 콘솔의 관리자 화면에서 네트워킹 → 서비스를 클릭합니다.

   2. 서비스 생성 을 클릭하고 YAML 보기에 다음 구성을 입력합니다.

      apiVersion: v1
      kind: Service
      metadata:
        name: rollouts-demo
      spec:
        ports: 

      1

      
        - port: 80
          targetPort: http
          protocol: TCP
          name: http
      
        selector: 

      2

      
          app: rollouts-demo

      Copy to Clipboard Toggle word wrap

      1

      컨테이너 내부에서 실행하기 위해 애플리케이션에서 사용하는 포트의 이름을 지정합니다.

      2

      selector 필드의 콘텐츠가 Rollout CR(사용자 정의 리소스)과 동일한지 확인합니다.

   3. 생성을 클릭합니다.

      롤아웃은 카나리아 ReplicaSet 의 Pod 템플릿 해시를 사용하여 생성된 서비스를 자동으로 업데이트합니다. 예를 들어 rollouts-pod-template-hash: 687d76d795.

7. 다음 명령을 실행하여 롤아웃 진행을 확인합니다.

   $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   출력 예

   Name:            rollouts-demo
   Namespace:       spring-petclinic
   Status:          ✔ Healthy
   Strategy:        Canary
     Step:          8/8
     SetWeight:     100
     ActualWeight:  100
   Images:          argoproj/rollouts-demo:blue (stable)
   Replicas:
     Desired:       5
     Current:       5
     Updated:       5
     Ready:         5
     Available:     5
   
   NAME                                       KIND        STATUS     AGE    INFO
   ⟳ rollouts-demo                            Rollout     ✔ Healthy  4m50s
   └──# revision:1
      └──⧉ rollouts-demo-687d76d795           ReplicaSet  ✔ Healthy  4m50s  stable
         ├──□ rollouts-demo-687d76d795-75k57  Pod         ✔ Running  4m49s  ready:1/1
         ├──□ rollouts-demo-687d76d795-bv5zf  Pod         ✔ Running  4m49s  ready:1/1
         ├──□ rollouts-demo-687d76d795-jsxg8  Pod         ✔ Running  4m49s  ready:1/1
         ├──□ rollouts-demo-687d76d795-rsgtv  Pod         ✔ Running  4m49s  ready:1/1
         └──□ rollouts-demo-687d76d795-xrmrj  Pod         ✔ Running  4m49s  ready:1/1

   Copy to Clipboard Toggle word wrap

   롤아웃이 생성되면 롤아웃의 Status 필드에 Phase: Healthy 가 표시되는지 확인할 수 있습니다.

8. 롤아웃 탭의 롤아웃 섹션에서 rollouts-demo 롤아웃의 Status 필드가 Phase: Healthy 로 표시되는지 확인합니다.

   작은 정보

   또는 다음 명령을 실행하여 롤아웃이 정상인지 확인할 수 있습니다.

   $ oc argo rollouts status rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   출력 예

   Healthy

   Copy to Clipboard Toggle word wrap

프로세스

1. 롤아웃에 배포된 컨테이너 이미지를 수정하여 애플리케이션의 새 카나리아 버전을 시뮬레이션합니다.

   1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 롤아웃 으로 이동합니다.
   2. 기존 rollouts-demo 롤아웃을 선택하고 YAML 보기에서 argoproj/rollouts-demo:blue to argoproj/rollouts-demo:yellow 에서 .spec.template.spec.containers.image 값을 수정합니다.

   3. 저장을 클릭한 다음 다시 로드 를 클릭합니다.

      롤아웃에 배포된 컨테이너 이미지가 수정되고 롤아웃에서 새 카나리아 배포를 시작합니다.

      참고

      Rollout CR의 .spec.strategy.canary.steps 필드에 정의된 setWeight 속성에 따라 처음 경로에 대한 트래픽의 20%가 카나리아 버전에 도달하고 승격 요청이 수신될 때까지 롤아웃이 무기한 일시 중지됩니다.

      카나리아 버전으로 전송되는 트래픽의 20%가 있고 승격 요청이 후속 단계에서 지정될 때까지 롤아웃이 무기한 정지되는 경로의 예

      spec:
        replicas: 5
        strategy:
          canary: 

      1

      
            steps: 

      2

      
            - setWeight: 20 

      3

      
            - pause: {}  

      4

      
        # (...)

      Copy to Clipboard Toggle word wrap

      1

      롤아웃에서 사용해야 하는 배포 전략입니다.

      2

      롤아웃 단계입니다. 이 예에서는 20%, 40%, 60 % 및 80%의 트래픽을 카나리아 버전으로 점진적으로 라우팅합니다.

      3

      카나리아 버전으로 이동해야 하는 트래픽의 백분율입니다. 값 20은 트래픽의 20%가 카나리아 버전으로 전달됨을 의미합니다.

      4

      Argo Rollouts 컨트롤러에 사양으로 승격 요청을 찾을 때까지 무기한 정지합니다.

2. 다음 명령을 실행하여 롤아웃 진행을 확인합니다.

   $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR이 정의된 네임스페이스를 지정합니다.

   출력 예

   Name:            rollouts-demo
   Namespace:       spring-petclinic
   Status:          ॥ Paused
   Message:         CanaryPauseStep
   Strategy:        Canary
     Step:          1/8
     SetWeight:     20
     ActualWeight:  20
   Images:          argoproj/rollouts-demo:blue (stable)
                    argoproj/rollouts-demo:yellow (canary)
   Replicas:
     Desired:       5
     Current:       5
     Updated:       1
     Ready:         5
     Available:     5
   
   NAME                                       KIND        STATUS     AGE    INFO
   ⟳ rollouts-demo                            Rollout     ॥ Paused   9m51s
   ├──# revision:2
   │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy  99s    canary
   │     └──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running  98s    ready:1/1
   └──# revision:1
      └──⧉ rollouts-demo-687d76d795           ReplicaSet  ✔ Healthy  9m51s  stable
         ├──□ rollouts-demo-687d76d795-75k57  Pod         ✔ Running  9m50s  ready:1/1
         ├──□ rollouts-demo-687d76d795-jsxg8  Pod         ✔ Running  9m50s  ready:1/1
         ├──□ rollouts-demo-687d76d795-rsgtv  Pod         ✔ Running  9m50s  ready:1/1
         └──□ rollouts-demo-687d76d795-xrmrj  Pod         ✔ Running  9m50s  ready:1/1

   Copy to Clipboard Toggle word wrap

   롤아웃의 업데이트 전략 구성에 지정된 일시 중지 기간이 없기 때문에 롤아웃이 일시 중지된 상태입니다.

3. 이전 단계를 반복하여 새로 배포된 버전의 애플리케이션을 테스트하고 예상대로 작동하는지 확인합니다. 예를 들어 브라우저를 통해 애플리케이션과 상호 작용하여 애플리케이션을 확인하고 테스트를 실행하거나 컨테이너 로그를 관찰합니다.

   롤아웃은 다음 단계로 이동할 때까지 일시 중지된 상태로 유지됩니다.

프로세스

1. Argo Rollouts CLI에서 다음 명령을 실행하여 애플리케이션의 새 카나리아 버전을 시뮬레이션합니다.

   $ oc argo rollouts promote rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   출력 예

   rollout 'rollouts-demo' promoted

   Copy to Clipboard Toggle word wrap

   이렇게 하면 카나리아 버전에서 트래픽 가중치가 40%로 증가합니다.

2. 다음 명령을 실행하여 롤아웃이 나머지 단계를 통해 진행되는지 확인합니다.

   $ oc argo rollouts get rollout rollouts-demo -n <namespace> --watch 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   롤아웃 CR에 정의된 나머지 단계에는 일시 중지: {duration: 45} )가 설정된 기간이 있으므로 Argo Rollouts 컨트롤러는 해당 기간을 기다린 다음 다음 단계로 자동으로 이동합니다.

   모든 단계가 성공적으로 완료되면 새 ReplicaSet 오브젝트가 stable 복제본 세트로 표시됩니다.

   출력 예

   Name:            rollouts-demo
   Namespace:       spring-petclinic
   Status:          ✔ Healthy
   Strategy:        Canary
     Step:          8/8
     SetWeight:     100
     ActualWeight:  100
   Images:          argoproj/rollouts-demo:yellow (stable)
   Replicas:
     Desired:       5
     Current:       5
     Updated:       5
     Ready:         5
     Available:     5
   
   NAME                                       KIND        STATUS        AGE   INFO
   ⟳ rollouts-demo                            Rollout     ✔ Healthy     14m
   ├──# revision:2
   │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy     6m5s  stable
   │     ├──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running     6m4s  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-g9kd5  Pod         ✔ Running     2m4s  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-2ptpp  Pod         ✔ Running     78s   ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-tmk6c  Pod         ✔ Running     58s   ready:1/1
   │     └──□ rollouts-demo-6cf78c66c5-zv6lx  Pod         ✔ Running     47s   ready:1/1
   └──# revision:1
      └──⧉ rollouts-demo-687d76d795           ReplicaSet  • ScaledDown  14m

   Copy to Clipboard Toggle word wrap

프로세스

1. Argo Rollouts CLI에서 다음 명령을 실행하여 컨테이너 이미지 버전을 업데이트하고 argoproj/rollouts-demo:yellow 에서 argoproj/rollouts-demo:red 로 .spec.template.spec.containers.image 값을 수정합니다.

   $ oc argo rollouts set image rollouts-demo rollouts-demo=argoproj/rollouts-demo:red -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR(사용자 정의 리소스)이 정의된 네임스페이스를 지정합니다.

   출력 예

   rollout "rollouts-demo" image updated

   Copy to Clipboard Toggle word wrap

   롤아웃에 배포된 컨테이너 이미지가 수정되고 롤아웃에서 새 카나리아 배포를 시작합니다.

2. 롤아웃이 일시 중지된 상태에 도달할 때까지 기다립니다.

3. 롤아웃이 rollouts-demo:red 카나리아 버전을 배포하고 다음 명령을 실행하여 일시 중지된 상태에 도달하는지 확인합니다.

   $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR이 정의된 네임스페이스를 지정합니다.

   출력 예

   Name:            rollouts-demo
   Namespace:       spring-petclinic
   Status:          ॥ Paused
   Message:         CanaryPauseStep
   Strategy:        Canary
     Step:          1/8
     SetWeight:     20
     ActualWeight:  20
   Images:          argoproj/rollouts-demo:red (canary)
                    argoproj/rollouts-demo:yellow (stable)
   Replicas:
     Desired:       5
     Current:       5
     Updated:       1
     Ready:         5
     Available:     5
   
   NAME                                       KIND        STATUS        AGE    INFO
   ⟳ rollouts-demo                            Rollout     ॥ Paused      17m
   ├──# revision:3
   │  └──⧉ rollouts-demo-5747959bdb           ReplicaSet  ✔ Healthy     75s    canary
   │     └──□ rollouts-demo-5747959bdb-fdrsg  Pod         ✔ Running     75s    ready:1/1
   ├──# revision:2
   │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy     9m45s  stable
   │     ├──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running     9m44s  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-2ptpp  Pod         ✔ Running     4m58s  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-tmk6c  Pod         ✔ Running     4m38s  ready:1/1
   │     └──□ rollouts-demo-6cf78c66c5-zv6lx  Pod         ✔ Running     4m27s  ready:1/1
   └──# revision:1
      └──⧉ rollouts-demo-687d76d795           ReplicaSet  • ScaledDown  17m

   Copy to Clipboard Toggle word wrap

4. 다음 명령을 실행하여 롤아웃 업데이트를 중지합니다.

   $ oc argo rollouts abort rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR이 정의된 네임스페이스를 지정합니다.

   출력 예

   rollout 'rollouts-demo' aborted

   Copy to Clipboard Toggle word wrap

   Argo Rollouts 컨트롤러는 애플리케이션의 카나리아 리소스를 삭제하고 안정적인 버전으로 롤백합니다.

5. 롤아웃을 중단한 후 다음 명령을 실행하여 카나리아 ReplicaSet 이 0 복제본으로 확장되었는지 확인합니다.

   $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR이 정의된 네임스페이스를 지정합니다.

   출력 예

   Name:            rollouts-demo
   Namespace:       spring-petclinic
   Status:          ✖ Degraded
   Message:         RolloutAborted: Rollout aborted update to revision 3
   Strategy:        Canary
     Step:          0/8
     SetWeight:     0
     ActualWeight:  0
   Images:          argoproj/rollouts-demo:yellow (stable)
   Replicas:
     Desired:       5
     Current:       5
     Updated:       0
     Ready:         5
     Available:     5
   
   NAME                                       KIND        STATUS        AGE    INFO
   ⟳ rollouts-demo                            Rollout     ✖ Degraded    24m
   ├──# revision:3
   │  └──⧉ rollouts-demo-5747959bdb           ReplicaSet  • ScaledDown  7m38s  canary
   ├──# revision:2
   │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy     16m    stable
   │     ├──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running     16m    ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-2ptpp  Pod         ✔ Running     11m    ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-tmk6c  Pod         ✔ Running     11m    ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-zv6lx  Pod         ✔ Running     10m    ready:1/1
   │     └──□ rollouts-demo-6cf78c66c5-mlbsh  Pod         ✔ Running     4m47s  ready:1/1
   └──# revision:1
      └──⧉ rollouts-demo-687d76d795           ReplicaSet  • ScaledDown  24m

   Copy to Clipboard Toggle word wrap

   롤아웃 상태는 애플리케이션이 이전 안정 버전으로 롤백되었지만 현재 롤아웃이 원하는 버전인 빨간색 이 아니며 .spec.template.spec.containers.image 필드 내에 설정된 롤아웃이 없음을 나타냅니다.

   참고

   Degraded 상태는 애플리케이션의 상태를 반영하지 않습니다. 이는 원하는 컨테이너 이미지 버전과 실행 중인 컨테이너 이미지 버전이 일치하지 않음을 나타냅니다.

6. 다음 명령을 실행하여 컨테이너 이미지 버전을 이전 안정 버전, 노란색 으로 업데이트하고 .spec.template.spec.containers.image 값을 수정합니다.

   $ oc argo rollouts set image rollouts-demo rollouts-demo=argoproj/rollouts-demo:yellow -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR이 정의된 네임스페이스를 지정합니다.

   출력 예

   rollout "rollouts-demo" image updated

   Copy to Clipboard Toggle word wrap

   롤아웃은 분석 및 승격 단계를 건너뛰고 이전 안정된 버전, 노란색 및 빠른 속도로 롤백하여 안정적인 ReplicaSet 배포를 추적합니다.

7. 다음 명령을 실행하여 롤아웃 상태가 Healthy 로 즉시 표시되는지 확인합니다.

   $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout CR이 정의된 네임스페이스를 지정합니다.

   출력 예

   Name:            rollouts-demo
   Namespace:       spring-petclinic
   Status:          ✔ Healthy
   Strategy:        Canary
     Step:          8/8
     SetWeight:     100
     ActualWeight:  100
   Images:          argoproj/rollouts-demo:yellow (stable)
   Replicas:
     Desired:       5
     Current:       5
     Updated:       5
     Ready:         5
     Available:     5
   
   NAME                                       KIND        STATUS        AGE  INFO
   ⟳ rollouts-demo                            Rollout     ✔ Healthy     63m
   ├──# revision:4
   │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy     55m  stable
   │     ├──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running     55m  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-2ptpp  Pod         ✔ Running     50m  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-tmk6c  Pod         ✔ Running     50m  ready:1/1
   │     ├──□ rollouts-demo-6cf78c66c5-zv6lx  Pod         ✔ Running     50m  ready:1/1
   │     └──□ rollouts-demo-6cf78c66c5-mlbsh  Pod         ✔ Running     44m  ready:1/1
   ├──# revision:3
   │  └──⧉ rollouts-demo-5747959bdb           ReplicaSet  • ScaledDown  46m
   └──# revision:1
      └──⧉ rollouts-demo-687d76d795           ReplicaSet  • ScaledDown  63m

   Copy to Clipboard Toggle word wrap

프로세스

1. Route 오브젝트를 생성합니다.

   1. 웹 콘솔의 관리자 화면에서 네트워킹 → 경로를 클릭합니다.
   2. 경로 생성을 클릭합니다.

   3. 경로 생성 페이지에서 YAML 보기를 클릭하고 다음 스니펫을 추가합니다. 다음 예제에서는 rollouts-demo-route 라는 경로를 생성합니다.

      apiVersion: route.openshift.io/v1
      kind: Route
      metadata:
        name: rollouts-demo-route
      spec:
        port:
          targetPort: http 

      1

      
        tls: 

      2

      
          insecureEdgeTerminationPolicy: Redirect
          termination: edge
        to:
          kind: Service
          name: argo-rollouts-stable-service 

      3

      
          weight: 100 

      4

      
      
        alternateBackends:
          - kind: Service
            name: argo-rollouts-canary-service 

      5

      
            weight: 0 

      6

      Copy to Clipboard Toggle word wrap

      1

      컨테이너 내부에서 실행하기 위해 애플리케이션에서 사용하는 포트의 이름을 지정합니다.

      2

      경로를 보호하는 데 사용되는 TLS 구성을 지정합니다.

      3

      대상 안정적인 서비스의 이름입니다.

      4

      이 필드는 Route Rollout 플러그인에 의해 안정적인 가중치로 자동 수정됩니다.

      5

      대상 카나리아 서비스의 이름입니다.

      6

      이 필드는 Route Rollout 플러그인에 의해 카나리아 가중치로 자동 수정됩니다.

   4. 생성 을 클릭하여 경로를 생성합니다. 그런 다음 경로 페이지에 표시됩니다.

2. 경로에서 참조할 서비스를 생성합니다.

   1. 웹 콘솔의 관리자 화면에서 네트워킹 → 서비스를 클릭합니다.
   2. 서비스 생성을 클릭합니다.

   3. 서비스 생성 페이지에서 YAML 보기를 클릭하고 다음 스니펫을 추가합니다. 다음 예제에서는 argo-rollouts-canary-service 라는 카나리아 서비스를 생성합니다. 카나리아 트래픽은 이 서비스로 이동합니다.

      apiVersion: v1
      kind: Service
      metadata:
        name: argo-rollouts-canary-service
      spec:
        ports: 

      1

      
        - port: 80
          targetPort: http
          protocol: TCP
          name: http
      
        selector: 

      2

      
          app: rollouts-demo

      Copy to Clipboard Toggle word wrap

      1

      컨테이너 내부에서 실행하기 위해 애플리케이션에서 사용하는 포트의 이름을 지정합니다.

      2

      selector 필드의 콘텐츠가 안정적인 서비스 및 롤아웃 CR(사용자 정의 리소스)과 동일한지 확인합니다.

      중요

      Route 오브젝트에 지정된 카나리아 서비스의 이름이 Service 오브젝트에 지정된 카나리아 서비스의 이름과 일치하는지 확인합니다.

   4. 생성 을 클릭하여 카나리아 서비스를 생성합니다.

      롤아웃은 카나리아 ReplicaSet 의 Pod 템플릿 해시를 사용하여 생성된 서비스를 자동으로 업데이트합니다. 예를 들어 rollouts-pod-template-hash: 7bf84f9696.

   5. 이 단계를 반복하여 stable 서비스를 생성합니다. 다음 예제에서는 argo-rollouts-stable-service 라는 안정적인 서비스를 생성합니다. 안정적인 트래픽이 이 서비스로 전달됩니다.

      apiVersion: v1
      kind: Service
      metadata:
        name: argo-rollouts-stable-service
      spec:
        ports: 

      1

      
        - port: 80
          targetPort: http
          protocol: TCP
          name: http
      
        selector: 

      2

      
          app: rollouts-demo

      Copy to Clipboard Toggle word wrap

      1

      컨테이너 내부에서 실행하기 위해 애플리케이션에서 사용하는 포트의 이름을 지정합니다.

      2

      selector 필드의 콘텐츠가 카나리아 서비스 및 롤아웃 CR과 동일한지 확인합니다.

      중요

      Route 오브젝트에 지정된 안정적인 서비스의 이름이 Service 오브젝트에 지정된 stable 서비스의 이름과 일치하는지 확인합니다.

   6. 생성 을 클릭하여 안정적인 서비스를 생성합니다.

      롤아웃은 안정적인 ReplicaSet 의 Pod 템플릿 해시를 사용하여 생성된 서비스를 자동으로 업데이트합니다. 예를 들어 rollouts-pod-template-hash: 1b6a7733.

3. Rollout CR을 생성하여 Route 및 Service 오브젝트를 참조합니다.

   1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 롤아웃 으로 이동합니다.

   2. 롤아웃 생성 페이지에서 YAML 보기를 클릭하고 다음 스니펫을 추가합니다. 다음 예제에서는 rollouts-demo 라는 롤아웃 CR을 생성합니다.

      apiVersion: argoproj.io/v1alpha1
      kind: Rollout
      metadata:
        name: rollouts-demo
      spec:
        template: 

      1

      
          metadata:
            labels:
              app: rollouts-demo
          spec:
            containers:
            - name: rollouts-demo
              image: argoproj/rollouts-demo:blue
              ports:
              - name: http
                containerPort: 8080
                protocol: TCP
              resources:
                requests:
                  memory: 32Mi
                  cpu: 5m
      
        revisionHistoryLimit: 2
        replicas: 5
        strategy:
          canary:
            canaryService: argo-rollouts-canary-service 

      2

      
            stableService: argo-rollouts-stable-service 

      3

      
            trafficRouting:
              plugins:
                argoproj-labs/openshift:
                  routes:
                    - rollouts-demo-route  

      4

      
            steps: 

      5

      
            - setWeight: 30
            - pause: {}
            - setWeight: 60
            - pause: {}
        selector: 

      6

      
          matchLabels:
            app: rollouts-demo

      Copy to Clipboard Toggle word wrap

      1

      생성할 Pod를 지정합니다.

      2

      이 값은 생성된 카나리아 서비스 의 이름과 일치해야 합니다.

      3

      이 값은 생성된 안정적인 서비스 의 이름과 일치해야 합니다.

      4

      이 값은 생성된 Route CR의 이름과 일치해야 합니다.

      5

      롤아웃 단계를 지정합니다. 이 예에서는 카나리아 버전으로 트래픽의 30%, 60% 및 100%를 모두 라우팅합니다.

      6

      selector 필드의 콘텐츠가 카나리아 및 안정적인 서비스의 내용과 동일한지 확인합니다.

   3. 생성을 클릭합니다.
   4. 롤아웃 탭의 롤아웃 섹션에서 롤아웃 의 상태 필드에 단계: Healthy 가 표시되는지 확인합니다.

4. 경로가 100%의 트래픽을 안정적인 버전의 애플리케이션으로 유도하는지 확인합니다.

   참고

   Rollout 리소스의 첫 번째 인스턴스가 생성되면 롤아웃은 안정적이고 카나리아 애플리케이션 버전으로 전달될 트래픽 양을 조정합니다. 초기 인스턴스에서 Rollout 리소스 생성은 모든 트래픽을 애플리케이션의 안정적인 버전으로 라우팅하고 트래픽이 카나리아 버전으로 전송되는 부분을 건너뜁니다.

   1. 네트워킹 → 경로로 이동하여 확인할 경로 리소스를 찾습니다.

   2. YAML 탭을 선택하고 다음 스니펫을 확인합니다.

      예: Route

      kind: Route
      metadata:
        name: rollouts-demo-route
      spec:
        alternateBackends:
        - kind: Service
          name: argo-rollouts-canary-service
          weight: 0 

      1

      
        # (...)
        to:
          kind: Service
          name: argo-rollouts-stable-service
          weight: 100 

      2

      Copy to Clipboard Toggle word wrap

      1

      값 0 은 트래픽의 0%가 카나리아 버전으로 전달됨을 의미합니다.

      2

      값 100 은 트래픽의 100%가 안정적인 버전으로 전달됨을 의미합니다.

5. 롤아웃에 배포된 컨테이너 이미지를 수정하여 애플리케이션의 새 카나리아 버전을 시뮬레이션합니다.

   1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 롤아웃 으로 이동합니다.

   2. 기존 롤아웃 을 선택하고 argoproj/rollouts-demo:blue to argoproj/rollouts-demo:yellow 에서 .spec.template.spec.containers.image 값을 수정합니다.

      결과적으로 롤아웃에 배포된 컨테이너 이미지가 수정되고 롤아웃에서 새 카나리아 배포를 시작합니다.

      참고

      Rollout 리소스의 .spec.strategy.canary.steps 필드에 정의된 setWeight 속성에 따라 처음 경로에 대한 트래픽의 30%가 카나리아 버전에 도달하고 트래픽의 70%가 안정적인 버전으로 이동합니다. 트래픽의 30%가 카나리아 버전으로 전달된 후 롤아웃이 일시 중지됩니다.

      카나리아 버전으로 전송되는 트래픽의 30 %와 stable 버전으로 향하는 70 %의 경로의 예.

      spec:
        alternateBackends:
        - kind: Service
          name: argo-rollouts-canary-service
          weight: 30
        # (...)
        to:
          kind: Service
          name: argo-rollouts-stable-service
          weight: 70

      Copy to Clipboard Toggle word wrap

6. Argo Rollouts CLI에서 다음 명령을 실행하여 애플리케이션의 새 카나리아 버전을 시뮬레이션합니다.

   $ oc argo rollouts promote rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   이렇게 하면 카나리아 버전의 트래픽 가중치가 60%이고 안정적인 버전의 40%가 증가합니다.

   카나리아 버전으로 전송되는 트래픽의 60 %와 stable 버전으로 향하는 40 %의 경로의 예.

   spec:
     alternateBackends:
     - kind: Service
       name: argo-rollouts-canary-service
       weight: 60
     # (...)
     to:
       kind: Service
       name: argo-rollouts-stable-service
       weight: 40

   Copy to Clipboard Toggle word wrap

7. 카나리아 버전의 트래픽 가중치를 100%로 늘리고 다음 명령을 실행하여 애플리케이션의 이전 안정적인 버전의 트래픽을 삭제합니다.

   $ oc argo rollouts promote rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   카나리아 버전으로 전송되는 트래픽의 0%와 stable 버전으로 100%가 전달되는 경로의 예.

   spec:
     # (...)
     to:
       kind: Service
       name: argo-rollouts-stable-service
       weight: 100

   Copy to Clipboard Toggle word wrap

프로세스

1. 메시에 대한 인바운드 트래픽을 수락할 게이트웨이 오브젝트를 만듭니다.

   1. 다음 스니펫 콘텐츠를 사용하여 YAML 파일을 생성합니다.

      rollouts-demo-gateway라는 게이트웨이의 예

      apiVersion: networking.istio.io/v1alpha3
      kind: Gateway
      metadata:
        name: rollouts-demo-gateway 

      1

      
      spec:
        selector:
          istio: ingressgateway 

      2

      
        servers:
        - port:
            number: 80
            name: http
            protocol: HTTP
          hosts:
          - "*"

      Copy to Clipboard Toggle word wrap

      1

      게이트웨이의 이름입니다.

      2

      수신 게이트웨이의 이름을 지정합니다. 게이트웨이는 노출된 포트 및 프로토콜을 구성하지만 트래픽 라우팅 구성은 포함되지 않습니다.

   2. 다음 명령을 실행하여 YAML 파일을 적용합니다.

      $ oc apply -f gateway.yaml

      Copy to Clipboard Toggle word wrap

2. 카나리아 및 안정적인 버전의 애플리케이션에 대한 서비스를 생성합니다.

   1. 웹 콘솔의 관리자 화면에서 네트워킹 → 서비스로 이동합니다.
   2. 서비스 생성을 클릭합니다.

   3. 서비스 생성 페이지에서 YAML 보기를 클릭하고 다음 스니펫을 추가합니다. 다음 예제에서는 rollouts-demo-stable 이라는 안정적인 서비스를 생성합니다. 안정적인 트래픽이 이 서비스로 전달됩니다.

      apiVersion: v1
      kind: Service
      metadata:
        name: rollouts-demo-stable
      spec:
        ports: 

      1

      
        - port: 80
          targetPort: http
          protocol: TCP
          name: http
        selector: 

      2

      
          app: rollouts-demo

      Copy to Clipboard Toggle word wrap

      1

      컨테이너 내부에서 실행하기 위해 애플리케이션에서 사용하는 포트의 이름을 지정합니다.

      2

      selector 필드의 콘텐츠가 안정적인 service 및 Rollout CR에서 동일한지 확인합니다.

   4. 생성 을 클릭하여 안정적인 서비스를 생성합니다.

   5. 서비스 생성 페이지에서 YAML 보기를 클릭하고 다음 스니펫을 추가합니다. 다음 예제에서는 rollouts-demo-canary 라는 카나리아 서비스를 생성합니다. 카나리아 트래픽은 이 서비스로 이동합니다.

      apiVersion: v1
      kind: Service
      metadata:
        name: rollouts-demo-canary
      spec:
        ports: 

      1

      
        - port: 80
          targetPort: http
          protocol: TCP
          name: http
        selector: 

      2

      
          app: rollouts-demo

      Copy to Clipboard Toggle word wrap

      1

      컨테이너 내부에서 실행하기 위해 애플리케이션에서 사용하는 포트의 이름을 지정합니다.

      2

      selector 필드의 콘텐츠가 카나리아 서비스 및 롤아웃 CR에서 동일한지 확인합니다.

   6. 생성 을 클릭하여 카나리아 서비스를 생성합니다.

3. 들어오는 트래픽을 안정적인 카나리아 서비스로 라우팅하는 VirtualService를 생성합니다.

   1. YAML 파일을 생성한 후 다음 YAML을 이 파일에 복사합니다. 다음 예제에서는 rollouts-demo-vsvc 라는 VirtualService 를 생성합니다.

      apiVersion: networking.istio.io/v1alpha3
      kind: VirtualService
      metadata:
        name: rollouts-demo-vsvc
      spec:
        gateways:
        - rollouts-demo-gateway 

      1

      
        hosts:
        - rollouts-demo-vsvc.local
        http:
        - name: primary
          route:
          - destination:
              host: rollouts-demo-stable 

      2

      
              port:
                number: 15372 

      3

      
            weight: 100
          - destination:
              host: rollouts-demo-canary 

      4

      
              port:
                number: 15372
            weight: 0
        tls: 

      5

      
        - match:
          - port: 3000
            sniHosts:
            - rollouts-demo-vsvc.local
          route:
          - destination:
              host: rollouts-demo-stable
            weight: 100
          - destination:
              host: rollouts-demo-canary
            weight: 0

      Copy to Clipboard Toggle word wrap

      1

      게이트웨이의 이름입니다.

      2

      대상 안정적인 서비스의 이름입니다.

      3

      트래픽을 수신하는 데 사용되는 포트 번호를 지정합니다.

      4

      대상 카나리아 서비스의 이름입니다.

      5

      VirtualService를 보호하는 데 사용되는 TLS 구성을 지정합니다.

   2. 다음 명령을 실행하여 YAML 파일을 적용합니다.

      $ oc apply -f virtual-service.yaml

      Copy to Clipboard Toggle word wrap

4. Rollout CR을 생성합니다. 이 예에서는 Istio 가 트래픽 관리자로 사용됩니다.

   1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 롤아웃 으로 이동합니다.

   2. 롤아웃 생성 페이지에서 YAML 보기를 클릭하고 다음 스니펫을 추가합니다. 다음 예제에서는 rollouts-demo 라는 롤아웃 CR을 생성합니다.

      apiVersion: argoproj.io/v1alpha1
      kind: Rollout
      metadata:
        name: rollouts-demo
      spec:
        replicas: 5
        strategy:
          canary:
            canaryService: rollouts-demo-canary 

      1

      
            stableService: rollouts-demo-stable 

      2

      
            trafficRouting:
              istio:
                virtualServices:
                - name: rollouts-demo-vsvc
                  routes:
                  - primary
            steps: 

      3

      
            - setWeight: 20
            - pause: {}
            - setWeight: 40
            - pause: {}
            - setWeight: 60
            - pause: {duration: 30}
            - setWeight: 80
            - pause: {duration: 60}
        revisionHistoryLimit: 2
        selector: 

      4

      
          matchLabels:
            app: rollouts-demo
        template:
          metadata:
            labels:
              app: rollouts-demo
              istio-injection: enabled
          spec:
            containers:
            - name: rollouts-demo
              image: argoproj/rollouts-demo:blue
              ports:
              - name: http
                containerPort: 8080
                protocol: TCP
              resources:
                requests:
                  memory: 32Mi
                  cpu: 5m

      Copy to Clipboard Toggle word wrap

      1

      이 값은 생성된 카나리아 서비스 의 이름과 일치해야 합니다.

      2

      이 값은 생성된 안정적인 서비스 의 이름과 일치해야 합니다.

      3

      롤아웃 단계를 지정합니다. 이 예에서는 카나리아 버전으로 트래픽의 20%, 40%, 60% 및 100%를 모두 라우팅합니다.

      4

      selector 필드의 콘텐츠가 카나리아 및 안정적인 서비스의 내용과 동일한지 확인합니다.

   3. 생성을 클릭합니다.
   4. 롤아웃 탭의 롤아웃 섹션에서 롤아웃 의 상태 필드에 단계: Healthy 가 표시되는지 확인합니다.

5. 경로가 100%의 트래픽을 안정적인 버전의 애플리케이션으로 유도하는지 확인합니다.

   1. 다음 명령을 실행하여 롤아웃 진행을 확인합니다.

      $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

      1

      Copy to Clipboard Toggle word wrap

      1

      Rollout 리소스가 정의된 네임스페이스를 지정합니다.

      출력 예

      Name:            rollouts-demo
      Namespace:       argo-rollouts
      Status:          ✔ Healthy
      Strategy:        Canary
        Step:          8/8
        SetWeight:     100
        ActualWeight:  100
      Images:          argoproj/rollouts-demo:blue (stable)
      Replicas:
        Desired:       5
        Current:       5
        Updated:       5
        Ready:         5
        Available:     5
      
      NAME                                       KIND        STATUS     AGE    INFO
      ⟳ rollouts-demo                            Rollout     ✔ Healthy  4m50s
      └──# revision:1
         └──⧉ rollouts-demo-687d76d795           ReplicaSet  ✔ Healthy  4m50s  stable
            ├──□ rollouts-demo-687d76d795-75k57  Pod         ✔ Running  4m49s  ready:1/1
            ├──□ rollouts-demo-687d76d795-bv5zf  Pod         ✔ Running  4m49s  ready:1/1
            ├──□ rollouts-demo-687d76d795-jsxg8  Pod         ✔ Running  4m49s  ready:1/1
            ├──□ rollouts-demo-687d76d795-rsgtv  Pod         ✔ Running  4m49s  ready:1/1
            └──□ rollouts-demo-687d76d795-xrmrj  Pod         ✔ Running  4m49s  ready:1/1

      Copy to Clipboard Toggle word wrap

      참고

      Rollout 리소스의 첫 번째 인스턴스가 생성되면 롤아웃은 안정적이고 카나리아 애플리케이션 버전으로 전달될 트래픽 양을 조정합니다. 초기 인스턴스에서 Rollout 리소스 생성은 모든 트래픽을 애플리케이션의 안정적인 버전으로 라우팅하고 트래픽이 카나리아 버전으로 전송되는 부분을 건너뜁니다.

   2. 서비스 메시가 안정적인 서비스에 대한 트래픽의 100%와 카나리아 서비스에 대해 0%를 전송하는지 확인하려면 다음 명령을 실행합니다.

      $ oc describe virtualservice/rollouts-demo-vsvc -n <namespace>

      Copy to Clipboard Toggle word wrap

   3. 터미널에 표시된 다음 출력을 확인합니다.

      route
      - destination:
          host: rollouts-demo-stable
        weight: 100 

      1

      
      - destination:
          host: rollouts-demo-canary
        weight: 0 

      2

      Copy to Clipboard Toggle word wrap

      1

      값 100 은 트래픽의 100%가 안정적인 버전으로 전달됨을 의미합니다.

      2

      값 0 은 트래픽의 0%가 카나리아 버전으로 전달됨을 의미합니다.

6. 롤아웃에 배포된 컨테이너 이미지를 수정하여 애플리케이션의 새 카나리아 버전을 시뮬레이션합니다.

   1. 다음 명령을 실행하여 argoproj/rollouts-demo:blue to argoproj/rollouts-demo:yellow 에서 .spec.template.spec.containers.image 값을 수정합니다.

      $ oc argo rollouts set image rollouts-demo rollouts-demo=argoproj/rollouts-demo:yellow -n <namespace>

      Copy to Clipboard Toggle word wrap

      결과적으로 롤아웃에 배포된 컨테이너 이미지가 수정되고 롤아웃에서 새 카나리아 배포를 시작합니다.

      참고

      Rollout 리소스의 .spec.strategy.canary.steps 필드에 정의된 setWeight 속성에 따라 처음에 경로에 대한 트래픽의 20%가 카나리아 버전에 도달하고 트래픽의 80%가 안정적인 버전으로 이동합니다. 트래픽의 20%가 카나리아 버전으로 전달된 후 롤아웃이 일시 중지됩니다.

   2. 다음 명령을 실행하여 롤아웃 진행을 확인합니다.

      $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

      1

      Copy to Clipboard Toggle word wrap

      1

      Rollout 리소스가 정의된 네임스페이스를 지정합니다.

      다음 예에서 트래픽의 80%가 안정적인 서비스로 라우팅되고 트래픽의 20%는 카나리아 서비스로 라우팅됩니다. 그런 다음 수동으로 다음 수준으로 승격할 때까지 배포가 무기한 일시 중지됩니다.

      출력 예

      Name:            rollouts-demo
      Namespace:       argo-rollouts
      Status:          ॥ Paused
      Message:         CanaryPauseStep
      Strategy:        Canary
        Step:          1/8
        SetWeight:     20
        ActualWeight:  20
      Images:          argoproj/rollouts-demo:blue (stable)
                       argoproj/rollouts-demo:yellow (canary)
      Replicas:
        Desired:       5
        Current:       6
        Updated:       1
        Ready:         6
        Available:     6
      
      NAME                                       KIND        STATUS     AGE    INFO
      ⟳ rollouts-demo                            Rollout     ॥ Paused   6m51s
      ├──# revision:2
      │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy  99s    canary
      │     └──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running  98s    ready:1/1
      └──# revision:1
         └──⧉ rollouts-demo-687d76d795           ReplicaSet  ✔ Healthy  9m51s  stable
            ├──□ rollouts-demo-687d76d795-75k57  Pod         ✔ Running  9m50s  ready:1/1
            ├──□ rollouts-demo-687d76d795-jsxg8  Pod         ✔ Running  9m50s  ready:1/1
            ├──□ rollouts-demo-687d76d795-rsgtv  Pod         ✔ Running  9m50s  ready:1/1
            └──□ rollouts-demo-687d76d795-xrmrj  Pod         ✔ Running  9m50s  ready:1/1

      Copy to Clipboard Toggle word wrap

      안정적인 버전으로 향하는 80%의 트래픽과 카나리아 버전으로 전송되는 트래픽의 20%를 예로 들 수 있습니다.

      route
      - destination:
          host: rollouts-demo-stable
        weight: 80 

      1

      
      - destination:
          host: rollouts-demo-canary
        weight: 20 

      2

      Copy to Clipboard Toggle word wrap

      1

      값 80 은 트래픽의 80%가 안정적인 버전으로 전달됨을 의미합니다.

      2

      값 20 은 트래픽의 20%가 카나리아 버전으로 전달됨을 의미합니다.

7. 배포를 다음 승격 단계로 수동으로 승격합니다.

   $ oc argo rollouts promote rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   1. 다음 명령을 실행하여 롤아웃 진행을 확인합니다.

      $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

      1

      Copy to Clipboard Toggle word wrap

      1

      Rollout 리소스가 정의된 네임스페이스를 지정합니다.

      다음 예에서 트래픽의 60%는 안정적인 서비스로 라우팅되고 트래픽의 40%는 카나리아 서비스로 라우팅됩니다. 그런 다음 수동으로 다음 수준으로 승격할 때까지 배포가 무기한 일시 중지됩니다.

      출력 예

      Name:            rollouts-demo
      Namespace:       argo-rollouts
      Status:          ॥ Paused
      Message:         CanaryPauseStep
      Strategy:        Canary
        Step:          3/8
        SetWeight:     40
        ActualWeight:  40
      Images:          argoproj/rollouts-demo:blue (stable)
                       argoproj/rollouts-demo:yellow (canary)
      Replicas:
        Desired:       5
        Current:       7
        Updated:       2
        Ready:         7
        Available:     7
      
      NAME                                       KIND        STATUS     AGE    INFO
      ⟳ rollouts-demo                            Rollout     ॥ Paused   9m21s
      ├──# revision:2
      │  └──⧉ rollouts-demo-6cf78c66c5           ReplicaSet  ✔ Healthy  99s    canary
      │     └──□ rollouts-demo-6cf78c66c5-zrgd4  Pod         ✔ Running  98s    ready:1/1
      └──# revision:1
         └──⧉ rollouts-demo-687d76d795           ReplicaSet  ✔ Healthy  9m51s  stable
            ├──□ rollouts-demo-687d76d795-75k57  Pod         ✔ Running  9m50s  ready:1/1
            ├──□ rollouts-demo-687d76d795-jsxg8  Pod         ✔ Running  9m50s  ready:1/1
            ├──□ rollouts-demo-687d76d795-rsgtv  Pod         ✔ Running  9m50s  ready:1/1
            └──□ rollouts-demo-687d76d795-xrmrj  Pod         ✔ Running  9m50s  ready:1/1

      Copy to Clipboard Toggle word wrap

      안정적인 버전으로 전송되는 60 % 트래픽의 예와 카나리아 버전으로 향하는 40%의 트래픽입니다.

      route
      - destination:
          host: rollouts-demo-stable
        weight: 60 

      1

      
      - destination:
          host: rollouts-demo-canary
        weight: 40 

      2

      Copy to Clipboard Toggle word wrap

      1

      값 60 은 트래픽의 60 %가 안정적인 버전으로 전달됨을 의미합니다.

      2

      값 40 은 트래픽의 40%가 카나리아 버전으로 전달됨을 의미합니다.

8. 카나리아 버전의 트래픽 가중치를 100%로 늘리고 다음 명령을 실행하여 애플리케이션의 이전 안정적인 버전의 트래픽을 삭제합니다.

   $ oc argo rollouts promote rollouts-demo -n <namespace> 

   1

   Copy to Clipboard Toggle word wrap

   1

   Rollout 리소스가 정의된 네임스페이스를 지정합니다.

   1. 다음 명령을 실행하여 롤아웃 진행을 확인합니다.

      $ oc argo rollouts get rollout rollouts-demo --watch -n <namespace> 

      1

      Copy to Clipboard Toggle word wrap

      1

      Rollout 리소스가 정의된 네임스페이스를 지정합니다.

프로세스

1. 웹 콘솔의 관리자 화면에서 Administration → CustomResourceDefinitions 로 이동합니다.
2. 서브스크립션을 검색하고 Subscription CRD를 클릭합니다.
3. Instances 탭을 클릭한 다음 openshift-gitops-operator 서브스크립션을 클릭합니다.

4. YAML 탭을 클릭하고 YAML 파일을 편집합니다.

   1. .spec.config.env 속성에 값이 true 로 설정된 NAMESPACE_SCOPED_ARGO_ROLLOUTS 환경 변수를 지정합니다.

      네임스페이스 범위의 Argo 롤아웃 설치 구성 예

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: openshift-gitops-operator
      spec:
        # (...)
        config:
          env:
            - name: NAMESPACE_SCOPED_ARGO_ROLLOUTS
              value: 'true' 

      1

      Copy to Clipboard Toggle word wrap

      1

      'true' 로 설정된 값은 네임스페이스 범위 설치를 활성화합니다. 값을 'false' 로 설정하거나 지정하지 않으면 설치 기본값은 cluster-scoped mode입니다.

   2. 저장을 클릭합니다.

      Red Hat OpenShift GitOps Operator는 네임스페이스 범위 설치 내에서 Argo Rollouts 사용자 정의 리소스를 쉽게 조정할 수 있습니다.

5. GitOps 컨테이너의 로그를 확인하여 Red Hat OpenShift GitOps Operator에서 네임스페이스 범위 Argo Rollouts 설치를 활성화했는지 확인합니다.

   1. 웹 콘솔의 관리자 화면에서 워크로드 → Pod 로 이동합니다.
   2. openshift-gitops-operator-controller-manager Pod를 클릭한 다음 로그 탭을 클릭합니다.
   3. 다음 로그 문을 찾습니다. namespaced -scoped 모드에서 실행 중입니다. 이 성명은 Red Hat OpenShift GitOps Operator가 네임스페이스 범위 Argo Rollouts 설치를 활성화했음을 나타냅니다.

6. RolloutManager 리소스를 생성하여 네임스페이스 범위의 Argo Rollouts 설치를 완료합니다.

   1. Operator → 설치된 Operator → Red Hat OpenShift GitOps 로 이동하여 RolloutManager 탭을 클릭합니다.
   2. RolloutManager 생성 을 클릭합니다.

   3. YAML 보기를 선택하고 다음 스니펫을 입력합니다.

      네임스페이스 범위 Argo 롤아웃 설치에 대한 RolloutManager CR의 예

      apiVersion: argoproj.io/v1alpha1
      kind: RolloutManager
      metadata:
        name: rollout-manager
        namespace: my-application 

      1

      
      spec:
        namespaceScoped: true

      Copy to Clipboard Toggle word wrap

      1

      네임스페이스 범위 Argo Rollouts 인스턴스를 설치할 프로젝트의 이름을 지정합니다.

   4. 생성을 클릭합니다.

      RolloutManager CR이 생성되면 Red Hat OpenShift GitOps가 네임스페이스 범위 Argo Rollouts 인스턴스를 선택한 네임스페이스에 설치하기 시작합니다.

7. 네임스페이스 범위의 설치에 성공했는지 확인합니다.

   1. RolloutManager 탭의 RolloutManagers 섹션에서 RolloutManager 인스턴스의 Status 필드가 Phase: Available 인지 확인합니다.

   2. RolloutManagers 섹션의 YAML 탭에서 다음 출력을 검사하여 설치에 성공했는지 확인합니다.

      네임스페이스 범위의 Argo 롤아웃 설치 YAML 파일의 예

      spec:
        namespaceScoped: true
      status:
        conditions:
          lastTransitionTime: '2024-07-10T14:20:5z`
          message: ''
          reason: Success
          status: 'True' 

      1

      
          type: 'Reconciled'
        phase: Available
        rolloutController: Available

      Copy to Clipboard Toggle word wrap

      1

      이 상태는 네임스페이스 범위의 Argo 롤아웃 설치가 성공적으로 활성화되었음을 나타냅니다.

      클러스터 범위의 설치가 클러스터에 이미 존재하는 동안 네임스페이스별 Argo Rollouts 인스턴스를 설치하려고 하면 오류 메시지가 표시됩니다.

      오류 메시지가 포함된 잘못된 설치의 예

      spec:
        namespaceScoped: true
      status:
        conditions:
         lastTransitionTime: '2024-07-10T14:10:7z`
         message: 'when Subscription has environment variable NAMESPACE_SCOPED_ARGO_ROLLOUTS set to False, there may not exist any namespace-scoped RolloutManagers: only a single cluster-scoped RolloutManager is supported'
         reason: InvalidRolloutManagerScope
         status: 'False' 

      1

      
         type: 'Reconciled'
        phase: Failure
        rolloutController: Failure

      Copy to Clipboard Toggle word wrap

      1

      이 상태는 네임스페이스 범위의 Argo 롤아웃 설치가 성공적으로 활성화되지 않았음을 나타냅니다. 설치 기본값은 cluster-scoped 모드입니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에 클러스터 관리자로 로그인합니다.
2. 관리자 화면에서 Operator → 설치된 Operator 를 클릭합니다.
3. 프로젝트 드롭다운 메뉴에서 RolloutManager CR(사용자 정의 리소스)을 생성하고 구성할 프로젝트를 생성하거나 선택합니다.
4. 설치된 Operator에서 Red Hat OpenShift GitOps 를 선택합니다.
5. 세부 정보 탭의 제공된 API 섹션에서 RolloutManager 창에서 인스턴스 생성 을 클릭합니다.

6. RolloutManager 생성 페이지에서 YAML 보기를 선택하고 YAML 을 편집합니다.

   RolloutManager CR에서 트래픽 관리 및 메트릭 플러그인 구성 추가 예

   apiVersion: argoproj.io/v1alpha1
   kind: RolloutManager
   metadata:
     name: argo-rollouts
   spec:
     plugins:
       trafficManagement:
         - name: argoproj-labs/gatewayAPI 

   1

   
           location: https://github.com/sample-metric-plugin 

   2

   
       metric:
         - name: argoproj-labs/sample-prometheus 

   3

   
           location: https://github.com/sample-trafficrouter-plugin 

   4

   
           sha256: dac10cbf57633c9832a17f8c27d2ca34aa97dd3d 

   5

   Copy to Clipboard Toggle word wrap

   1

   trafficManagement 플러그인의 이름을 지정합니다.

   2

   trafficManagement 플러그인의 위치를 지정합니다.

   3

   메트릭 플러그인의 이름을 지정합니다.

   4

   메트릭 플러그인의 위치를 지정합니다.

   5

   선택 사항: Rollouts 컨트롤러에서 다운로드하여 설치하는 플러그인 바이너리의 SHA256 서명을 지정합니다.

7. 생성을 클릭합니다.
8. RolloutManager 탭의 RolloutManagers 섹션에서 RolloutManager 인스턴스의 Status 필드가 Phase: Available 로 표시되는지 확인합니다.

9. 다음 단계를 완료하여 트래픽 관리 및 메트릭 플러그인이 올바르게 설치되었는지 확인합니다.

   1. 관리자 관점에서 워크로드 → ConfigMap 을 클릭합니다.

   2. argo-rollouts-config 구성 맵을 클릭합니다.

      결과적으로 RolloutManager CR에 정의된 플러그인이 argo-rollouts-config 구성 맵에서 업데이트됩니다.

      argo-rollouts-config ConfigMap에서 업데이트된 트래픽 관리 및 메트릭 플러그인의 예

      kind: ConfigMap
      apiVersion: v1
      metadata:
        name: argo-rollouts-config
        namespace: argo-rollouts
        labels:
          app.kubernetes.io/component: argo-rollouts
          app.kubernetes.io/name: argo-rollouts
          app.kubernetes.io/part-of: argo-rollouts
      data:
        metricPlugins: |
            - name: "argoproj-labs/sample-prometheus" 

      1

      
              location: https://github.com/sample-metric-plugin 

      2

      
              sha256: dac10cbf57633c9832a17f8c27d2ca34aa97dd3d 

      3

      
        trafficRouterPlugins: |
          - name: argoproj-labs/gatewayAPI 

      4

      
            location: https://github.com/sample-metric-plugin 

      5

      
            sha256: "" 

      6

      
          - name: argoproj-labs/openshift 

      7

      
            location: file:/plugins/rollouts-trafficrouter-openshift/openshift-route-plugin 

      8

      
            sha256: "" 

      9

      Copy to Clipboard Toggle word wrap

      1

      메트릭 플러그인의 이름을 지정합니다.

      2

      메트릭 플러그인의 위치를 지정합니다.

      3

      메트릭 플러그인의 sha256 서명을 지정합니다.

      4

      trafficmanagement 플러그인의 이름을 지정합니다.

      5

      trafficmanagement 플러그인의 위치를 지정합니다.

      6

      trafficmanagement 플러그인의 sha256 서명을 지정합니다.

      7

      기본 trafficmanagement 플러그인의 이름을 지정합니다.

      8

      기본 trafficmanagement 플러그인의 위치를 지정합니다.

      9

      trafficmanagement 플러그인의 sha256 서명을 지정합니다.

   RolloutManager CR을 통해 트래픽 및 메트릭 플러그인을 직접 구성하면 롤아웃 프로세스를 간소화하고 오류 발생 가능성을 줄이며 환경 전체에서 플러그인 관리를 일관되게 유지할 수 있습니다. 이를 통해 배포 절차를 단순화하면서 제어 및 유연성이 향상됩니다.

프로세스

1. OpenShift Container Platform 웹 콘솔에 클러스터 관리자로 로그인합니다.
2. 관리자 화면에서 Operator → 설치된 Operator 를 클릭합니다.
3. 프로젝트 드롭다운 메뉴에서 RolloutManager CR을 생성하고 구성할 프로젝트를 생성하거나 선택합니다.
4. 설치된 Operator에서 Red Hat OpenShift GitOps 를 선택합니다.
5. 세부 정보 탭의 제공된 API 섹션에서 RolloutManager 창에서 인스턴스 생성 을 클릭합니다.

6. RolloutManager 생성 페이지에서 YAML 보기를 선택하고 YAML 을 편집합니다.

   RolloutManager CR에서 ha 필드 활성화 예

   apiVersion: argoproj.io/v1alpha1
   kind: RolloutManager
   metadata:
     name: argo-rollouts
     namespace: openshift-gitops
   spec:
     ha:
       enabled: true 

   1

   Copy to Clipboard Toggle word wrap

   1

   고가용성이 활성화되어 있는지 여부를 지정합니다. 값을 true 로 설정하면 고가용성이 활성화됩니다.

7. 생성을 클릭합니다.
8. RolloutManager 탭의 RolloutManagers 섹션에서 RolloutManager 인스턴스의 Status 필드에 Phase: Available 이 표시되는지 확인합니다.

9. 다음 단계를 완료하여 롤아웃 배포 상태를 확인합니다.

   1. 관리자 관점에서 워크로드 → 배포를 클릭합니다.
   2. argo-rollouts 배포를 클릭합니다.
   3. 세부 정보 탭을 클릭하고 롤아웃 배포의 복제본 수가 이제 2로 설정되어 있는지 확인합니다.

   4. YAML 탭을 클릭하고 다음 구성이 표시되는지 확인합니다.

      Argo 롤아웃 배포 구성 파일의 예

      kind: Deployment
      metadata:
        name: argo-rollouts
        namespace: openshift-gitops
      spec:
        replicas: 2 

      1

      
        selector:
          matchLabels:
            app.kubernetes.io/name: argo-rollouts
        template:
          metadata:
            creationTimestamp: null
            labels:
              app.kubernetes.io/name: argo-rollouts
          spec:
            containers:
                args:
                  - '--leader-elect'
                  - 'true' 

      2

      Copy to Clipboard Toggle word wrap

      1

      Pod 수를 지정합니다.

      2

      --leader-elect=true 플래그가 Rollouts 배포에 전달되도록 지정합니다. 이 플래그가 기본적으로 true 로 설정되어 있지만 명시적으로 설정하면 리더 선택이 일관되게 적용됩니다.

프로세스

1. 웹 콘솔의 관리자 화면에서 Operator → 설치된 Operator → Red Hat OpenShift GitOps → 서브스크립션 으로 이동합니다.
2. 작업 목록을 클릭한 다음 서브스크립션 편집을 클릭합니다.

3. openshift-gitops-operator Subscription 세부 정보 페이지의 YAML 탭에서 Argo CD 인스턴스의 네임스페이스를 CLUSTER_SCOPED_ARGO_ROLLOUTS_NAMESPACES 환경 변수에 추가하여 서브스크립션 YAML 파일을 편집합니다.

   CLUSTER_SCOPED_ARGO_ROLLOUTS_NAMESPACES 환경 변수 구성 예

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-gitops-operator
   spec:
     config:
      env:
       - name: NAMESPACE_SCOPED_ARGO_ROLLOUTS
         value: 'false' 

   1

   
       - name: CLUSTER_SCOPED_ARGO_ROLLOUTS_NAMESPACES
         value: <list_of_namespaces_in_the_cluster-scoped_Argo_CD_instances> 

   2

   
    ...

   Copy to Clipboard Toggle word wrap

   1

   클러스터 범위 설치를 활성화하거나 비활성화하려면 이 값을 지정합니다. 값을 'false' 로 설정하면 클러스터 범위 설치를 활성화했습니다. 'true' 로 설정된 경우 네임스페이스 범위 설치를 활성화했습니다. 값이 비어 있으면 false 로 설정됩니다.

   2

   클러스터 범위 Argo Rollouts 인스턴스를 호스팅할 수 있는 쉼표로 구분된 네임스페이스 목록을 지정합니다(예: test-123-cluster-scoped,test-456-cluster-scoped ).

4. 저장 및 다시 로드 를 클릭합니다.