[Ep.42] [Argo CD 확장 #2] Argo CD API 및 CLI를 활용한 자동화 배포 파이프라인 구축

🔹 Argo CD API 및 CLI를 활용해야 하는 이유

Argo CD는 CLI(Command Line Interface) 및 REST API 를 제공하여 GitOps 기반의 배포를 더욱 자동화할 수 있습니다.
이를 활용하면 CI/CD 파이프라인과 쉽게 연동하여 코드 변경 시 자동으로 배포가 이루어질 수 있도록 설정 가능합니다.

 

✅ Argo CD API 및 CLI 활용이 필요한 이유

✔ GitOps 자동화 배포를 CI/CD 파이프라인과 연동 가능
✔ 애플리케이션을 CLI 명령어 또는 API 호출로 배포 가능
✔ 자동 롤백, 배포 상태 조회, 동기화 실행을 스크립트에서 제어 가능
✔ Argo CD의 REST API를 활용하여 애플리케이션을 원격으로 관리 가능

---

🔹 1. Argo CD CLI를 활용한 배포 자동화

✅ 1.1 Argo CD CLI 설치

Argo CD CLI는 로컬 환경에서 Argo CD 서버와 상호작용할 수 있도록 도와줍니다.

# Mac 설치 (Homebrew)
brew install argocd

# Linux 설치
curl -sSL -o /usr/local/bin/argocd https://github.com/argoproj/argo-cd/releases/latest/download/argocd-linux-amd64
chmod +x /usr/local/bin/argocd

 

✅ Argo CD CLI 버전 확인

argocd version

 

✅ 출력 예시:

argocd: v2.5.0

---

✅ 1.2 Argo CD CLI를 활용한 애플리케이션 배포

📌 Argo CD 로그인

argocd login argocd.example.com --username admin --password mypassword

 

✅ 설명:
✔ argocd login → Argo CD 서버에 로그인
✔ --username admin → 관리자 계정으로 로그인

 

📌 애플리케이션 동기화 (배포 실행)

argocd app sync example-app

 

✅ 설명:
✔ argocd app sync → Git 저장소와 Kubernetes 클러스터를 동기화하여 배포 실행

 

📌 배포 상태 확인

argocd app get example-app

 

✅ 출력 예시:

NAME             STATUS     SYNC STATUS
example-app     Healthy    Synced

---

✅ 1.3 Argo CD CLI를 활용한 롤백

배포 중 문제가 발생하면 Argo CD CLI를 활용하여 이전 버전으로 롤백할 수 있습니다.

argocd app rollback example-app 2

 

✅ 설명:
✔ rollback example-app 2 → 애플리케이션을 두 번째 이전 버전으로 롤백

 

✅ 롤백 후 상태 확인

argocd app history example-app

 

✅ 출력 예시:

ID  COMMIT   STATUS     SYNC STATUS
4   89f2d3a  Deployed   Synced
3   c7a1e2b  Deployed   Synced
2   b5d1f4c  RolledBack Synced

---

🔹 2. Argo CD REST API를 활용한 자동화 배포

Argo CD는 REST API를 제공하여 CI/CD 파이프라인에서 원격으로 배포 및 동기화를 실행할 수 있습니다.

✅ 2.1 Argo CD API 인증 토큰 생성

Argo CD REST API를 사용하려면 JWT 토큰 기반의 인증이 필요합니다.

argocd account generate-token --account admin

 

✅ 출력 예시:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ...

✅ 이제 REST API 호출 시 인증 헤더에 Authorization: Bearer <TOKEN>을 추가해야 합니다.

---

✅ 2.2 Argo CD API를 활용한 애플리케이션 목록 조회

curl -X GET -H "Authorization: Bearer " \
    https://argocd.example.com/api/v1/applications

 

✅ 출력 예시:

{
  "items": [
    {
      "metadata": {
        "name": "example-app",
        "namespace": "argocd"
      },
      "status": {
        "sync": {
          "status": "Synced"
        }
      }
    }
  ]
}

---

✅ 2.3 Argo CD API를 활용한 배포 동기화 실행

curl -X POST -H "Authorization: Bearer " \
    https://argocd.example.com/api/v1/applications/example-app/sync

 

✅ 설명:
✔ POST /applications/example-app/sync → Argo CD에서 Git 상태와 동기화 실행

 

✅ 동기화 상태 확인 API 호출

curl -X GET -H "Authorization: Bearer " \
    https://argocd.example.com/api/v1/applications/example-app

---

🔹 3. GitHub Actions와 Argo CD API를 활용한 배포 자동화

CI/CD 파이프라인에서 코드가 변경되면 자동으로 Argo CD를 통해 배포할 수 있습니다.

✅ 3.1 GitHub Actions 배포 파이프라인 예제

📌 .github/workflows/deploy.yml

name: Deploy with Argo CD

on:
  push:
    branches:
      - main  # main 브랜치에 Push 시 배포 실행

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v2

      - name: Sync Application with Argo CD
        run: |
          curl -X POST -H "Authorization: Bearer ${{ secrets.ARGOCD_TOKEN }}" \
              https://argocd.example.com/api/v1/applications/example-app/sync

 

✅ 설명:
✔ on.push.branches: main → 메인 브랜치에 변경 사항이 발생하면 배포 자동 실행
✔ curl -X POST ... /sync → Argo CD API를 호출하여 애플리케이션 동기화 실행
✔ secrets.ARGOCD_TOKEN → GitHub Actions에서 Argo CD API 호출을 위한 토큰 저장

 

✅ GitHub Actions CI/CD 배포 실행

git push origin main

 

✅ 출력 예시 (GitHub Actions 로그)

✅ Sync Application with Argo CD
Successfully triggered sync for example-app.

---

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

🟢 Argo CD CLI를 활용하여 애플리케이션을 동기화하고 롤백 가능
🟢 Argo CD REST API를 활용하여 원격에서 애플리케이션을 배포 가능
🟢 GitHub Actions와 Argo CD API를 연동하여 자동화 배포 파이프라인 구축 가능
🟢 CI/CD 환경에서 GitOps 방식으로 배포를 자동화할 수 있음