[Ep.34] [Argo CD 운영 최적화 #4] Argo CD와 Argo Rollouts를 활용한 배포 전략

🔹 Argo Rollouts란?

Argo Rollouts는 Kubernetes에서 Blue-Green, Canary 배포와 같은 점진적 배포 전략을 지원하는 컨트롤러입니다.
Argo CD와 함께 사용하면 GitOps 방식으로 배포 전략을 선언적으로 관리할 수 있습니다.

 

 

✅ Argo Rollouts를 활용해야 하는 이유

 

✔ 서비스 무중단 배포 가능
✔ Canary 배포를 통해 신규 버전의 안정성 검증 가능
✔ 트래픽을 점진적으로 이동시키면서 오류 발생 시 롤백 가능
✔ Argo CD와 연계하여 GitOps 방식으로 배포 자동화 가능

 

 

✅ Argo Rollouts가 지원하는 배포 전략

배포 전략	설명
Blue-Green 배포	기존 버전(Blue)과 새로운 버전(Green)을 동시에 실행하고, 트래픽을 Green으로 전환
Canary 배포	신규 버전의 트래픽을 점진적으로 증가시키면서 모니터링 후 전체 전환
Progressive Delivery	Canary 배포를 더 세분화하여 A/B 테스트 및 실험적인 배포 가능

---

🔹 1. Argo CD에서 Argo Rollouts 활성화 방법

Argo Rollouts를 사용하려면 Argo CD에서 Rollout 리소스를 지원하도록 설정해야 합니다.

✅ Argo Rollouts 컨트롤러 설치 (Helm Chart 사용)

helm install argo-rollouts argo/argo-rollouts -n argo-rollouts --create-namespace

 

✅ 설명:
✔ argo-rollouts → Argo Rollouts 컨트롤러를 Kubernetes에 설치
✔ --create-namespace → argo-rollouts 네임스페이스가 없으면 생성

 

✅ 설치된 Rollouts 컨트롤러 확인

kubectl get pods -n argo-rollouts

 

✅ 출력 예시:

NAME                                 READY   STATUS    RESTARTS   AGE
argo-rollouts-7f69c98b74-xyz         1/1     Running   0          2m

---

🔹 2. Argo Rollouts를 활용한 Blue-Green 배포 예제

✅ Blue-Green 배포 전략을 적용한 Rollout 리소스

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: example-blue-green
  namespace: example
spec:
  replicas: 3  # 실행할 파드 수
  strategy:
    blueGreen:
      activeService: example-service  # 현재 서비스(Blue)
      previewService: example-preview  # 신규 버전 서비스(Green)
      autoPromotionEnabled: false  # 자동 승격 비활성화 (수동 전환)

  selector:
    matchLabels:
      app: example
  template:
    metadata:
      labels:
        app: example
    spec:
      containers:
        - name: example
          image: ghcr.io/example/app:v2  # 새로운 버전
          ports:
            - containerPort: 80

 

✅ 설명:
✔ blueGreen.activeService: example-service → 현재 버전(Blue) 서비스
✔ blueGreen.previewService: example-preview → 새로운 버전(Green) 서비스
✔ autoPromotionEnabled: false → 자동 승격을 비활성화하여 수동으로 전환 가능

 

✅ 서비스 리소스 정의

apiVersion: v1
kind: Service
metadata:
  name: example-service
  namespace: example
spec:
  selector:
    app: example
  ports:
    - port: 80

 

✅ 배포 후 새로운 버전(Green) 확인

kubectl get rollout example-blue-green -n example

 

✅ 출력 예시:

NAME                   STRATEGY     STATUS        ACTIVE SERVICE    PREVIEW SERVICE
example-blue-green     BlueGreen    Progressing   example-service   example-preview

 

✅ 새로운 버전으로 승격(트래픽 전환)

kubectl argo rollouts promote example-blue-green -n example

 

✅ 롤백(기존 버전으로 복구)

kubectl argo rollouts undo example-blue-green -n example

---

🔹 3. Argo Rollouts를 활용한 Canary 배포 예제

✅ Canary 배포 전략을 적용한 Rollout 리소스

apiVersion: argoproj.io/v1alpha1
kind: Rollout
metadata:
  name: example-canary
  namespace: example
spec:
  replicas: 3  # 실행할 파드 수
  strategy:
    canary:
      steps:
        - setWeight: 20  # 20% 트래픽을 신규 버전으로 전환
        - pause: {duration: 60s}  # 60초 대기 후 다음 단계 진행
        - setWeight: 50  # 50% 트래픽 전환
        - pause: {}  # 수동 승격 대기

  selector:
    matchLabels:
      app: example
  template:
    metadata:
      labels:
        app: example
    spec:
      containers:
        - name: example
          image: ghcr.io/example/app:v2  # 신규 버전
          ports:
            - containerPort: 80

 

✅ 설명:
✔ steps.setWeight: 20 → 초기 트래픽 20%를 신규 버전에 할당
✔ pause: {duration: 60s} → 60초 동안 상태 모니터링 후 다음 단계 진행
✔ setWeight: 50 → 50% 트래픽을 신규 버전에 할당
✔ pause: {} → 사용자가 직접 승격할 때까지 대기

 

✅ 현재 배포 진행 상태 확인

kubectl argo rollouts get rollout example-canary -n example

 

✅ 출력 예시:

NAME             STRATEGY   STATUS        STEP
example-canary   Canary     Progressing   2/4

 

✅ 수동 승격(100% 트래픽 전환)

kubectl argo rollouts promote example-canary -n example

 

✅ 롤백(기존 버전으로 복구)

kubectl argo rollouts undo example-canary -n example

---

🔹 4. Argo CD와 Argo Rollouts 연동

Argo CD에서 Canary 배포 또는 Blue-Green 배포를 자동으로 관리하려면,
다음과 같이 Argo CD Application에 Rollout 리소스를 추가해야 합니다.

✅ Argo CD Application에서 Argo Rollouts 배포

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: example-rollout-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: rollouts  # Rollout 매니페스트 경로

  destination:
    server: https://kubernetes.default.svc
    namespace: example

  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:
✔ source.path: rollouts → Rollout 리소스가 저장된 Git 경로
✔ syncPolicy.automated → 자동 동기화 활성화

 

✅ Argo CD에서 배포 동기화 실행

argocd app sync example-rollout-app

 

✅ 배포된 Argo Rollouts 상태 확인

kubectl get rollouts -n example

---

🔹 결론: 이번 글에서 배운 핵심 내용 정리

🟢 Argo Rollouts를 사용하면 Canary, Blue-Green 배포 전략을 GitOps 방식으로 자동화 가능
🟢 Argo CD와 Argo Rollouts를 연동하면 Kubernetes 배포를 점진적으로 적용 가능
🟢 배포 실패 시 Rollback 기능을 활용하여 안정적인 운영 가능
🟢 GitOps 기반으로 배포 전략을 선언적으로 관리하여 운영 부담을 줄일 수 있음