ArgoCD 설치 및 GitOps 기반 애플리케이션 배포

 

🎯 개요

 

이 글에서는 ArgoCD를 활용하여 Kubernetes 애플리케이션을 GitOps 방식으로 배포하는 방법을 설명합니다.

Git을 단일 소스로 사용하고, ArgoCD가 Git 저장소 변경 사항을 감지하여 자동으로 Kubernetes에 배포하는 방식입니다.

 

✅ 목표

• Helm을 사용하여 ArgoCD 설치

• ArgoCD UI 및 CLI를 통해 배포 관리

• GitHub 저장소와 연결하여 GitOps 방식으로 애플리케이션 자동 배포

• Helm values.yaml을 활용하여 환경별 설정 관리

 

---

 

🛠 1️⃣ ArgoCD 설치 (Helm 사용)

 

ArgoCD는 Kubernetes에 배포되며, Helm을 사용하면 간편하게 설치할 수 있습니다.

 

---

 

✅ 1-1. Helm Chart를 이용한 ArgoCD 설치

helm repo add argo https://argoproj.github.io/argo-helm
helm repo update
helm install argocd argo/argo-cd -n argocd --create-namespace

 

✅ 설치된 ArgoCD 확인

kubectl get pods -n argocd

 

출력 예시:

NAME                                    READY   STATUS    RESTARTS   AGE
argocd-application-controller-0         1/1     Running   0          30s
argocd-redis-xxxxxxxxxx-xxxxx           1/1     Running   0          30s
argocd-repo-server-xxxxxxxxxx-xxxxx     1/1     Running   0          30s
argocd-server-xxxxxxxxxx-xxxxx          1/1     Running   0          30s

🔹 모든 Pod가 Running 상태이면 설치가 정상적으로 완료됨!

 

---

 

✅ 1-2. ArgoCD 웹 UI 접속

 

ArgoCD의 기본 argocd-server 서비스는 ClusterIP로 배포되므로,

외부에서 접근하려면 포트를 변경해야 합니다.

kubectl patch svc argocd-server -n argocd -p '{"spec": {"type": "LoadBalancer"}}'

 

✅ 변경 후, EXTERNAL-IP 확인

kubectl get svc -n argocd

 

출력 예시:

NAME                    TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)
argocd-server           LoadBalancer   10.43.150.132    192.168.1.100   8070:30343/TCP

🔹 브라우저에서 http://192.168.1.100:8070에 접속 가능!

 

---

 

✅ 1-3. ArgoCD 로그인

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 --decode

 

✅ 초기 계정 정보

• ID: admin

• PW: (위에서 조회한 비밀번호)

 

CLI에서 로그인하려면:

argocd login http://192.168.1.100:8070 --username admin --password <PASSWORD> --insecure

 

---

 

🛠 2️⃣ ArgoCD Application 구성 및 배포

 

이제 ArgoCD에서 Git 저장소와 연결하고, Kubernetes 애플리케이션을 배포하는 Application을 생성합니다.

 

---

 

✅ 2-1. GitHub 저장소 등록

 

먼저 GitHub 사용자 이름 및 Personal Access Token(PAT)을 직접 입력하지 않도록 환경 변수로 관리합니다.

export GIT_USERNAME="your-username"
export GIT_PASSWORD="your-token"
export GIT_REPO_URL="https://github.com/your-org/your-repo.git"

 

✅ ArgoCD에 Git 저장소 등록

argocd repo add $GIT_REPO_URL --username $GIT_USERNAME --password $GIT_PASSWORD

 

✅ ArgoCD에서 저장소 확인

argocd repo list

 

출력 예시:

TYPE  NAME      REPO                                        USERNAME
git   gitops    https://github.com/your-org/your-repo.git  your-username

 

---

 

✅ 2-2. ArgoCD Application YAML 생성

 

아래 YAML을 사용하여 Helm Chart를 기반으로 애플리케이션을 배포합니다.

 

📁 argocd-application.yaml

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: rag-fastapi  # ArgoCD에서 관리할 애플리케이션 이름
  namespace: argocd  # ArgoCD가 관리하는 네임스페이스
spec:
  project: default  # 기본 프로젝트 (여러 프로젝트를 운영하는 경우 변경 가능)
  source:
    repoURL: https://github.com/your-org/your-repo.git  # Git 저장소 URL
    path: rag-fastapi-structured/helm  # Git 저장소 내 Helm Chart 경로
    targetRevision: main  # Git의 특정 브랜치 또는 태그 (보통 `main` 또는 `develop`)
    helm:
      valueFiles:
        - values.yaml  # Helm 배포 시 사용할 values 파일 지정
  destination:
    namespace: fastapi  # 애플리케이션이 배포될 네임스페이스
    server: https://kubernetes.default.svc  # 배포할 Kubernetes 클러스터 주소
  syncPolicy:
    automated:
      prune: true  # Git에서 삭제된 리소스를 자동으로 삭제
      selfHeal: true  # 클러스터 상태가 Git과 다르면 자동 복구

 

✅ 애플리케이션을 ArgoCD에 적용

kubectl apply -f argocd-application.yaml

 

---

 

✅ 2-3. ArgoCD에서 배포 상태 확인

argocd app get rag-fastapi

 

✅ 출력 예시

Name:               rag-fastapi
Repo:               https://github.com/your-org/your-repo.git
Target:             main
Path:               rag-fastapi-structured/helm
Sync Status:        Synced
Health Status:      Healthy

👉 SYNCED 상태이면 GitHub와 동기화 완료!

 

 

---

 

🎯 최종 정리

1. Helm을 사용하여 ArgoCD 설치 (helm install argocd argo/argo-cd -n argocd)

2. ArgoCD 웹 UI 및 CLI에서 로그인 (argocd login)

3. GitHub 저장소를 환경 변수로 관리하여 ArgoCD에 등록 (argocd repo add $GIT_REPO_URL ...)

4. Helm Chart 기반의 Application을 생성하여 자동 배포 (kubectl apply -f argocd-application.yaml)

5. argocd app get rag-fastapi를 실행하여 배포 상태 확인