[Ep.33] [Argo CD 운영 최적화 #3] Argo CD와 CI/CD 파이프라인 최적화

🔹 Argo CD와 CI/CD의 연계 개요

Argo CD는 GitOps 방식으로 Kubernetes 애플리케이션을 관리하는 강력한 도구이지만,
CI/CD 파이프라인과 연계하면 빌드, 배포 자동화가 더욱 강력해집니다.

 

✅ Argo CD와 CI/CD 파이프라인을 결합해야 하는 이유

✔ CI(Continuous Integration) → 애플리케이션 빌드 및 컨테이너 이미지 생성 자동화
✔ CD(Continuous Deployment) → Argo CD가 Git 변경 사항을 감지하여 자동 배포
✔ 자동화된 롤백(Rollback) → 배포 실패 시 Argo CD가 이전 버전으로 복구 가능
✔ 멀티 스테이지 배포 지원 → Dev → Staging → Production 환경으로 점진적 배포 가능

 

✅ Argo CD와 CI/CD 연동 방식

연동 방식	설명
Git Webhook	GitHub/GitLab Webhook을 활용하여 변경 사항을 Argo CD에 알림
Argo CD API	CI/CD 파이프라인에서 Argo CD API를 호출하여 배포 트리거
GitOps 방식	CI에서 Kubernetes 매니페스트 변경 후 Git Push, Argo CD가 감지하여 배포

---

🔹 1. Argo CD와 GitHub Actions을 활용한 CI/CD 자동화

Argo CD는 Git에 저장된 매니페스트를 자동으로 배포하므로,
GitHub Actions을 활용하여 컨테이너 이미지를 빌드하고 Kubernetes 매니페스트를 업데이트할 수 있습니다.

✅ 1️⃣ GitHub Actions을 활용한 CI/CD 파이프라인 예제

name: Deploy with Argo CD

on:
  push:
    branches:
      - main  # main 브랜치에 Push 발생 시 실행

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v2  # GitHub 저장소 코드 다운로드

      - name: Build Docker image
        run: |
          docker build -t ghcr.io/example/app:${{ github.sha }} .  # GitHub Container Registry에 이미지 빌드
          docker push ghcr.io/example/app:${{ github.sha }}  # 빌드한 이미지 푸시

      - name: Update Kubernetes manifests
        run: |
          sed -i "s|image: ghcr.io/example/app:.*|image: ghcr.io/example/app:${{ github.sha }}|g" k8s/deployment.yaml
          git config user.name "GitHub Actions"
          git config user.email "actions@github.com"
          git add k8s/deployment.yaml
          git commit -m "Update deployment image to ${{ github.sha }}"
          git push origin main  # 매니페스트 업데이트 후 Git에 Push

  deploy:
    needs: build
    runs-on: ubuntu-latest
    steps:
      - name: Trigger Argo CD Sync
        run: |
          argocd app sync example-app  # Argo CD에서 배포 동기화 실행

 

✅ 설명:
✔ build 단계 → Docker 이미지를 빌드하고 GitHub Container Registry(GHCR)에 Push
✔ Update Kubernetes manifests 단계 → 새 이미지를 Kubernetes 매니페스트에 반영 후 Git에 Push
✔ deploy 단계 → argocd app sync를 실행하여 Argo CD가 변경 사항을 동기화

 

✅ Argo CD Sync 명령어

argocd app sync example-app

 

✅ Argo CD에서 현재 배포 상태 확인

argocd app get example-app

---

🔹 2. GitOps 방식을 활용한 배포 자동화

Argo CD는 GitOps 방식을 기반으로 배포를 자동화하므로,
CI/CD 파이프라인에서 Git에 Kubernetes 매니페스트를 업데이트하는 방식이 최적화된 전략입니다.

✅ GitOps 방식으로 배포하는 Argo CD Application 예제

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: example-app
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: k8s  # Kubernetes 매니페스트가 저장된 디렉터리

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

  syncPolicy:
    automated:
      prune: true  # Git에서 삭제된 리소스를 Kubernetes에서도 자동 삭제
      selfHeal: true  # Kubernetes 리소스가 변경되었을 경우 원래 상태로 자동 복구

 

✅ 설명:
✔ source.repoURL → Kubernetes 매니페스트가 저장된 Git 리포지토리 지정
✔ syncPolicy.automated → Git 변경 사항을 자동으로 배포

 

✅ Git Push 시 Argo CD가 자동으로 배포
1️⃣ 개발자가 Kubernetes 매니페스트 변경 후 Git에 Push
2️⃣ Argo CD가 변경 사항을 감지하여 자동으로 배포

---

🔹 3. Argo CD와 Argo Workflows를 활용한 CI/CD 파이프라인 구축

Argo CD와 Argo Workflows를 함께 활용하면 컨테이너 기반의 워크플로우를 실행하고 자동으로 애플리케이션을 배포할 수 있습니다.

✅ Argo Workflows를 활용한 배포 파이프라인 예제

apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
  generateName: deploy-workflow-
spec:
  entrypoint: deploy
  templates:
    - name: deploy
      steps:
        - - name: build-image
            template: build

        - - name: update-manifest
            template: update

        - - name: sync-argo
            template: sync

    - name: build
      container:
        image: docker:latest
        command: ["sh", "-c"]
        args: ["docker build -t ghcr.io/example/app:latest . && docker push ghcr.io/example/app:latest"]

    - name: update
      container:
        image: alpine/git
        command: ["sh", "-c"]
        args: ["git clone https://github.com/example/repo.git && cd repo && sed -i 's|image:.*|image: ghcr.io/example/app:latest|' k8s/deployment.yaml && git commit -am 'Update image' && git push"]

    - name: sync
      container:
        image: argoproj/argocd-cli
        command: ["sh", "-c"]
        args: ["argocd app sync example-app"]

 

✅ 설명:
✔ build → 컨테이너 이미지를 빌드하고 GHCR에 Push
✔ update → Kubernetes 매니페스트 업데이트 후 Git에 Push
✔ sync → Argo CD에서 배포 동기화 실행

 

✅ Argo Workflows 실행 명령어

argo submit deploy-workflow.yaml --watch

---

🔹 4. CI/CD 파이프라인 최적화 시 고려할 점

✅ 1️⃣ 이미지 태그 관리
✔ CI/CD 파이프라인에서 latest 태그 대신 Git SHA 또는 버전 태그를 활용하여 롤백 가능하게 관리

 

✅ 2️⃣ 단계별 배포(Blue-Green, Canary) 적용
✔ Argo Rollouts를 활용하여 단계별 배포(Blue-Green, Canary 배포)를 적용하여 안정성 강화

 

✅ 3️⃣ GitOps 기반으로 모든 변경 사항을 Git에 저장
✔ CI/CD 파이프라인에서 Kubernetes 매니페스트를 Git에 반영 후 Argo CD가 배포

---

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

🟢 GitHub Actions과 Argo CD를 연계하여 CI/CD 자동화 가능
🟢 Argo Workflows를 활용하여 복잡한 배포 파이프라인을 자동화 가능
🟢 GitOps 방식으로 배포 자동화하면 변경 사항 추적 및 롤백 용이
🟢 Argo CD와 CI/CD 연계를 통해 배포 효율성을 극대화 가능