[Ep.31] [Argo CD 운영 최적화 #1] Argo CD를 확장하여 멀티 클러스터 관리하기

🔹 Argo CD 멀티 클러스터 관리란?

Argo CD는 기본적으로 하나의 Kubernetes 클러스터에서 애플리케이션을 배포 및 관리할 수 있습니다.
하지만 멀티 클러스터 환경에서는 하나의 Argo CD 인스턴스로 여러 클러스터를 관리할 수 있습니다.

 

✅ 멀티 클러스터 관리가 필요한 이유

✔ 환경 분리 → Dev, Staging, Prod 등 서로 다른 클러스터에 애플리케이션을 배포
✔ 하나의 Argo CD에서 중앙 집중식으로 여러 클러스터 관리
✔ GitOps 기반으로 모든 클러스터의 동기화 상태 유지
✔ 운영 효율성 향상 및 배포 자동화 강화

 

✅ Argo CD 멀티 클러스터 관리 방식

방식	설명
Direct Cluster Mode	Argo CD가 여러 클러스터에 직접 연결하여 관리
App of Apps Pattern	중앙 관리용 Argo CD에서 여러 클러스터에 Application을 배포
ApplicationSet	자동으로 여러 클러스터에 동적으로 애플리케이션을 배포

---

🔹 1. Argo CD에서 멀티 클러스터를 추가하는 방법

Argo CD가 다른 클러스터를 관리하려면, 추가할 클러스터의 Kubeconfig 정보를 등록해야 합니다.

✅ 1️⃣ Argo CD CLI를 사용한 클러스터 추가 방법

argocd cluster add <context-name>

 

✅ 예제: staging-cluster를 추가하는 명령어

argocd cluster add staging-cluster

 

✅ 설명:
✔ <context-name> → kubectl config get-contexts 명령어로 확인 가능
✔ 추가한 클러스터는 argocd cluster list 명령어로 확인 가능

 

✅ 현재 등록된 클러스터 목록 확인

argocd cluster list

 

✅ 출력 예시:

SERVER                          NAME              STATUS      VERSION
https://34.120.0.1              staging-cluster  Connected   v1.24
https://35.200.1.2              prod-cluster     Connected   v1.24

---

🔹 2. 멀티 클러스터 배포를 위한 Application 예제

각 클러스터에 애플리케이션을 배포하려면, destination.server 값을 변경하여 클러스터를 지정해야 합니다.

✅ 여러 클러스터에 배포하는 Argo CD Application 예제

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: frontend-app
  namespace: argocd
spec:
  project: default

  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: k8s/frontend

  destination:
    server: https://34.120.0.1  # 배포할 클러스터 (staging-cluster)
    namespace: frontend

  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:
✔ destination.server → argocd cluster list에서 확인한 클러스터 주소 입력
✔ namespace: frontend → 애플리케이션이 배포될 네임스페이스
✔ syncPolicy.automated → Git 변경 사항이 자동으로 반영되도록 설정

 

✅ 다른 클러스터에도 동일한 애플리케이션을 배포하려면 destination.server만 변경

destination:
  server: https://35.200.1.2  # prod-cluster로 변경

---

🔹 3. App of Apps 패턴을 활용한 멀티 클러스터 배포

App of Apps 패턴은 중앙의 Argo CD가 여러 클러스터에 애플리케이션을 관리할 수 있도록 합니다.

✅ 1️⃣ App of Apps를 위한 Application 예제

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: multi-cluster-apps
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: apps

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

  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:
✔ multi-cluster-apps → 여러 클러스터의 애플리케이션을 관리하는 Argo CD Application
✔ repoURL, path → Git에서 관리하는 애플리케이션 목록이 저장된 경로
✔ destination.server: https://kubernetes.default.svc → Argo CD가 실행 중인 클러스터에서 관리

 

✅ 각 클러스터별 Application을 정의한 YAML 예제 (apps/ 디렉터리 내)

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: frontend-app-staging
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: k8s/frontend
  destination:
    server: https://34.120.0.1  # Staging 클러스터
    namespace: frontend
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: frontend-app-prod
  namespace: argocd
spec:
  project: default
  source:
    repoURL: https://github.com/example/repo.git
    targetRevision: main
    path: k8s/frontend
  destination:
    server: https://35.200.1.2  # Production 클러스터
    namespace: frontend
  syncPolicy:
    automated:
      prune: true
      selfHeal: true

 

✅ 설명:
✔ multi-cluster-apps에서 개별 클러스터별 Application을 관리
✔ 각 애플리케이션은 서로 다른 destination.server를 가짐

 

✅ App of Apps 적용 방법

argocd app sync multi-cluster-apps

 

✅ 배포된 애플리케이션 확인

argocd app list

---

🔹 4. Argo CD 멀티 클러스터 운영 시 고려할 점

✅ 1️⃣ RBAC을 활용한 클러스터별 접근 권한 설정
✔ 개발팀/운영팀 별로 특정 클러스터만 관리할 수 있도록 RBAC 적용 필요
✔ argocd-rbac-cm.yaml 설정에서 p, role:dev, applications, get, staging/*, allow 방식으로 클러스터 접근 제한 가능

 

✅ 2️⃣ 클러스터 간 네트워크 연결 설정
✔ Argo CD 서버가 여러 클러스터에 접근하려면 클러스터 간 VPN 설정 또는 Kubernetes API 접근 가능해야 함

 

✅ 3️⃣ App of Apps 패턴 사용 시 리포지토리 구조 정리
✔ 여러 클러스터를 관리할 경우, Git 저장소를 클러스터 별로 구분하거나 apps/ 디렉터리 구조를 일관성 있게 유지하는 것이 중요

---

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

🟢 Argo CD는 여러 Kubernetes 클러스터를 관리할 수 있으며, 멀티 클러스터 환경을 지원
🟢 App of Apps 패턴을 활용하면 중앙 Argo CD에서 모든 클러스터의 애플리케이션을 일괄 관리 가능
🟢 RBAC을 활용하여 팀별로 특정 클러스터 접근 권한을 제한 가능
🟢 클러스터 간 네트워크 연결 및 GitOps 방식으로 설정을 유지하여 운영의 일관성을 보장할 수 있음