[Ep.6] [Argo CD 운영 #1] Argo CD CLI 설치 및 기본 명령어 사용법

 

🔹 Argo CD CLI란?

 

Argo CD는 웹 UI, CLI(Command Line Interface), API를 통해 애플리케이션을 관리할 수 있습니다.

그중 CLI는 자동화 및 운영 관리를 위해 필수적인 도구로, GitOps 워크플로우를 효율적으로 제어할 수 있습니다.

 

✅ CLI를 사용하면 다음과 같은 작업이 가능합니다:

✔ Argo CD 서버에 로그인하고 인증 관리

✔ 애플리케이션 생성, 삭제 및 동기화(Sync)

✔ 배포 상태 확인 및 롤백 수행

✔ Kubernetes 클러스터 목록 조회 및 관리

 

---

🔹 Argo CD CLI 설치 방법

 

✅ 1. macOS에서 설치

Homebrew를 사용하여 간단하게 설치할 수 있습니다.

brew install argocd

 

✅ 2. Linux에서 설치

리눅스 환경에서는 바이너리를 다운로드하여 설치합니다.

VERSION=$(curl --silent "https://api.github.com/repos/argoproj/argo-cd/releases/latest" | grep -Po '"tag_name": "\K.*?(?=")')
curl -sLO https://github.com/argoproj/argo-cd/releases/download/$VERSION/argocd-linux-amd64
chmod +x argocd-linux-amd64
sudo mv argocd-linux-amd64 /usr/local/bin/argocd

 

✅ 3. Windows에서 설치

Windows 사용자는 choco를 이용하여 설치할 수 있습니다.

choco install argocd-cli

 

✅ 설치 후, 정상적으로 동작하는지 확인

argocd version

 

💡 예상 출력 값

argocd: v2.6.5
BuildDate: 2023-10-11T12:00:00Z
GitCommit: a1b2c3d
GoVersion: go1.19

 

 

---

🔹 Argo CD CLI 기본 명령어 사용법

 

✅ 1. Argo CD 서버 로그인

 

Argo CD CLI를 사용하려면 먼저 서버에 로그인해야 합니다.

argocd login <ARGOCD_SERVER>

 

💡 예제:

argocd login argocd.example.com --username admin --password <비밀번호>

🔹 <ARGOCD_SERVER>는 Argo CD 서버 주소이며, 기본적으로 localhost:8080을 사용할 수도 있습니다.

 

🔹 첫 로그인 후에는 보안을 위해 비밀번호 변경을 권장합니다.

argocd account update-password

 

 

---

✅ 2. 애플리케이션 목록 조회

 

Argo CD에 등록된 애플리케이션을 확인할 수 있습니다.

argocd app list

 

💡 예상 출력 값

NAME        CLUSTER      STATUS      HEALTH   SYNC STATUS
frontend    in-cluster   Deployed    Healthy  Synced
backend     in-cluster   Degraded    OutOfSync

 

 

---

✅ 3. 애플리케이션 생성

 

Argo CD에서 새로운 애플리케이션을 CLI를 통해 생성할 수 있습니다.

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

 

✅ 주요 옵션 설명

• --repo → Git 저장소 URL

• --path → 매니페스트가 위치한 경로

• --dest-server → Kubernetes 클러스터 API 서버 주소

• --dest-namespace → 배포될 네임스페이스

 

---

✅ 4. 애플리케이션 동기화(Sync) 및 상태 확인

 

애플리케이션의 Git 변경 사항을 Kubernetes 클러스터와 동기화할 수 있습니다.

argocd app sync my-app

 

💡 예상 출력 값

Application 'my-app' is now synced

 

애플리케이션의 현재 상태를 확인하려면 다음 명령어를 사용합니다.

argocd app get my-app

 

💡 예상 출력 값

Name:               my-app
Project:            default
Sync Status:        Synced
Health Status:      Healthy

 

 

---

✅ 5. 애플리케이션 롤백

 

Git의 특정 커밋 또는 배포 이력으로 애플리케이션을 롤백할 수 있습니다.

argocd app rollback my-app 2

🔹 2는 이전 배포 버전을 의미하며, 최신 버전부터 숫자가 감소하는 방식입니다.

 

---

🔹 Argo CD 애플리케이션 삭제 및 Cascade 옵션 이해

 

✅ 6. 애플리케이션 삭제

argocd app delete my-app

 

💡 예상 출력 값

Application 'my-app' deleted

 

 

---

✅ Cascade 옵션의 종류 및 동작 방식

 

옵션	설명
--cascade=true	애플리케이션과 관련된 모든 리소스를 함께 삭제 (기본값)
--cascade=false	애플리케이션만 삭제하고 리소스는 유지

 

✅ Cascade 옵션 사용 예시

# 애플리케이션과 모든 리소스를 삭제 (기본값)
argocd app delete my-app --cascade=true

# 애플리케이션만 삭제하고 리소스 유지
argocd app delete my-app --cascade=false

 

 

---

🔹 Argo CD 애플리케이션이 삭제되지 않는 경우 해결 방법

 

1️⃣ Finalizer 문제 (삭제 대기 상태)

kubectl patch application my-app -n argocd --type=json -p='[{"op": "remove", "path": "/metadata/finalizers"}]'
kubectl delete application my-app -n argocd

 

---

2️⃣ Argo CD 자동 복원 (Git 저장소에서 다시 생성됨)

argocd app delete my-app --cascade=true --grpc-web

🔹 Git 저장소에서 애플리케이션 매니페스트도 함께 제거해야 합니다.

 

---

3️⃣ OwnerReferences 문제 (상위 리소스에 의해 보호됨)

kubectl patch application my-app -n argocd --type=json -p='[{"op": "remove", "path": "/metadata/ownerReferences"}]'
kubectl delete application my-app -n argocd

 

 

---

4️⃣ Argo CD 컨트롤러 문제

kubectl rollout restart deployment argocd-application-controller -n argocd
argocd app delete my-app --cascade=true