ArgoCD란 무엇인지, 설치부터 설정, 활용까지

🔧 ArgoCD란? 설치부터 설정, 실전 활용까지 완벽 가이드

“Git에 Push하면 자동으로 Kubernetes에 배포되도록 만들 수 없을까?”
바로 그 해답이 ArgoCD입니다.

---

🧠 ArgoCD란?

**ArgoCD(Argo Continuous Delivery)**는 GitOps 방식의 Kubernetes 애플리케이션 배포 도구입니다. Git 저장소를 **단일 소스 오브 트루스(Single Source of Truth)**로 삼아, Git에 정의된 상태와 실제 클러스터 상태를 비교하고 자동으로 동기화해줍니다.

주요 특징:

• ✅ Git 기반 배포 자동화 (GitOps)
• ✅ UI / CLI / API 모두 제공
• ✅ Helm, Kustomize, YAML 등 다양한 형식 지원
• ✅ 실시간 상태 모니터링 및 롤백 기능
• ✅ 멀티 클러스터 지원

---

🔧 설치하기

✅ 전제 조건

• Kubernetes 클러스터가 구성되어 있어야 합니다 (minikube, kind, EKS 등)
• kubectl 명령어 사용 가능해야 합니다

📥 설치 명령어

kubectl create namespace argocd

kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml

⏳ 설치 확인

kubectl get pods -n argocd

모든 pod가 Running 상태가 될 때까지 기다립니다.

---

🌐 ArgoCD 접속하기

기본적으로 argocd-server는 ClusterIP로 설치되므로 외부에서 접속하려면 다음 중 하나를 선택하세요:

🔹 방법 1: 포트포워딩 (로컬 테스트용)

kubectl port-forward svc/argocd-server -n argocd 8080:443

→ 브라우저에서 https://localhost:8080 접속

🔹 방법 2: Ingress 또는 NodePort 설정

선택적으로 Ingress를 구성하거나 argocd-server 서비스를 NodePort로 변경하여 외부에서 접근할 수 있습니다.

---

🔑 로그인하기

▶️ 기본 로그인 정보

# admin 초기 비밀번호 확인
kubectl get secret argocd-initial-admin-secret -n argocd -o jsonpath="{.data.password}" | base64 -d && echo

→ ID: admin, 비밀번호: 위에서 확인한 값

▶️ CLI 로그인

# CLI 설치 (macOS 기준)
brew install argocd

# 로그인
argocd login localhost:8080 --username admin --password <비밀번호>

---

📁 애플리케이션 배포하기

1. Git 저장소에 Kubernetes manifest 파일 올리기

예:

my-app/
  └── k8s/
       ├── deployment.yaml
       ├── service.yaml

GitHub에 푸시해둡니다.

2. ArgoCD에 애플리케이션 등록

✅ CLI 방식

argocd app create my-app \
  --repo https://github.com/your-username/your-repo.git \
  --path k8s \
  --dest-server https://kubernetes.default.svc \
  --dest-namespace default

✅ UI 방식

• “New App” 클릭
• Git 저장소 정보, 경로(path), 클러스터, 네임스페이스 지정

---

🔄 배포 및 동기화

수동 동기화

argocd app sync my-app

또는 UI에서 Sync 버튼 클릭

자동 동기화 설정 (Auto Sync)

argocd app set my-app --sync-policy automated

→ Git에 Push하면 자동 배포됩니다 🎉

---

🔁 상태 확인 및 롤백

argocd app get my-app
argocd app history my-app
argocd app rollback my-app <revision>

UI에서도 쉽게 롤백 가능합니다.

---

💡 GitOps 흐름 정리

개발 → Git에 Push → ArgoCD 감지 → Kubernetes 자동 배포

Git이 배포 상태의 기준(GitOps)이 되며, 인프라 코드와 애플리케이션 배포가 일관되고 안전하게 관리됩니다.

---

🧩 보너스: Helm, Kustomize 지원

ArgoCD는 단순한 YAML뿐 아니라 다음도 지원합니다:

• Helm Charts (--helm)
• Kustomize (--kustomize)
• Jsonnet 등

---

“CI는 GitHub Actions, CD는 ArgoCD” – 가장 깔끔한 배포 파이프라인의 시작입니다.