[Ep.15] [Argo CD 운영 #10] Argo CD를 활용한 다중 클러스터(Multi-Cluster) 배포 전략

🔹 Argo CD에서 다중 클러스터 배포란?

Argo CD는 기본적으로 단일 Kubernetes 클러스터뿐만 아니라 여러 개의 클러스터(Multi-Cluster)를 관리할 수 있는 기능을 제공합니다.
이를 활용하면 하나의 Argo CD 인스턴스에서 여러 개의 Kubernetes 클러스터를 동시에 배포 및 관리할 수 있습니다.

 

✅ 다중 클러스터 배포가 필요한 이유

✔ Dev, Staging, Prod 환경을 분리하여 운영 가능
✔ 다양한 지역(Region)에 배포하여 가용성을 높임
✔ 테넌트별(각 팀별) 클러스터를 따로 관리 가능
✔ 하나의 Argo CD에서 중앙 집중식으로 여러 클러스터를 제어 가능

---

🔹 Argo CD 다중 클러스터 구성 방식

Argo CD에서 다중 클러스터 배포를 지원하는 방식은 크게 두 가지가 있습니다.

구성 방식	설명	장점	단점
싱글 컨트롤러 (Single Argo CD, Multi-Cluster)	하나의 Argo CD가 여러 클러스터를 관리	중앙 집중식 관리 가능	네트워크 장애 시 특정 클러스터 접근 불가
클러스터별 독립 운영 (Argo CD Per Cluster)	각 클러스터마다 Argo CD를 별도로 운영	클러스터 간 완전한 독립성 확보	관리할 Argo CD 개수가 증가

✅ 싱글 컨트롤러 방식이 일반적으로 추천되며, 이를 활용하면 하나의 Argo CD에서 여러 클러스터를 동시 제어 가능

---

🔹 Argo CD에서 새로운 클러스터 등록하기

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

argocd cluster list

 

✅ 출력 예시:

SERVER                          NAME      STATUS
https://kubernetes.default.svc  in-cluster   Successful

위와 같이 기본적으로 Argo CD는 자신이 배포된 클러스터만 관리합니다.
추가적인 클러스터를 등록하려면 관리할 Kubernetes 클러스터의 Kubeconfig 정보를 추가해야 합니다.

---

✅ 2. 새로운 클러스터 등록하기

다른 클러스터를 Argo CD에 추가하려면, 먼저 해당 클러스터에 대한 kubeconfig 정보를 가져온 후 아래 명령어를 실행합니다.

argocd cluster add <CONTEXT_NAME>

 

✅ 예제 (클러스터가 staging-cluster일 경우)

argocd cluster add staging-cluster

이 명령어를 실행하면, 해당 클러스터에 argocd-manager 서비스 계정이 생성되고,
Argo CD가 해당 클러스터를 제어할 수 있는 권한이 부여됩니다.

 

✅ 등록된 클러스터 다시 확인:

argocd cluster list

 

✅ 출력 예시:

SERVER                          NAME             STATUS
https://kubernetes.default.svc  in-cluster      Successful
https://10.1.1.100:6443         staging-cluster Successful

이제 staging-cluster가 추가된 것을 확인할 수 있습니다.

---

✅ 3. 다중 클러스터를 활용한 애플리케이션 배포

이제 Application 리소스를 정의할 때, 특정 클러스터를 대상으로 배포할 수 있습니다.

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

 

✅ 설명:

• destination.server → 클러스터의 API 서버 주소를 입력
• destination.namespace → 배포할 네임스페이스 지정
• syncPolicy → 자동 동기화 및 Self-Healing 활성화

---

🔹 Argo CD 다중 클러스터 배포 시 고려할 점

✅ 1. 클러스터 간 네트워크 연결 필요

• Argo CD가 다중 클러스터를 관리하려면, 각 클러스터의 API 서버가 접근 가능해야 함
• VPN, VPC Peering, Private Link 등을 활용하여 네트워크 연결 가능

✅ 2. RBAC(Role-Based Access Control) 설정

• 클러스터별로 배포 권한을 제어하려면 Argo CD RBAC을 활용
• 특정 프로젝트(Project)에서 특정 클러스터로만 배포 가능하도록 설정 가능

✅ 3. GitOps 기반으로 클러스터를 프로비저닝

• Terraform, Crossplane 등을 사용하여 GitOps 방식으로 클러스터를 자동 생성 및 관리

---

🔹 Argo CD 다중 클러스터 CLI 명령어 정리

명령어	설명
argocd cluster list	등록된 클러스터 목록 확인
argocd cluster add <CONTEXT_NAME>	새로운 클러스터 등록
argocd cluster remove <CONTEXT_NAME>	클러스터 등록 해제
argocd app create <APP>	새로운 애플리케이션 생성
argocd app sync <APP>	애플리케이션 동기화 실행

 

✅ 클러스터 제거:

argocd cluster remove staging-cluster

 

✅ 애플리케이션 동기화:

argocd app sync example-app-staging

---

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

🟢 Argo CD는 다중 클러스터(Multi-Cluster) 배포를 지원하며, 중앙 집중식으로 여러 클러스터를 관리 가능
🟢 싱글 컨트롤러 방식과 클러스터별 독립 운영 방식 중 운영 환경에 맞는 전략을 선택해야 함
🟢 argocd cluster add 명령어를 사용하여 새로운 클러스터를 추가하고, Application YAML에서 클러스터를 지정 가능
🟢 RBAC을 활용하여 특정 프로젝트(Project)에서 특정 클러스터로만 배포 가능하도록 제한할 수 있음
🟢 GitOps 방식으로 클러스터를 자동화하면 운영 효율성을 극대화할 수 있음