[Ep.8] [Argo CD 운영 #3] Argo CD의 애플리케이션(Application) 개념과 Kubernetes 리소스 관리

 

🔹 Argo CD에서 애플리케이션(Application)이란?

 

Argo CD에서 **애플리케이션(Application)**은 Kubernetes 클러스터에서 관리되는 모든 리소스의 집합을 의미합니다.

즉, Argo CD는 Git 저장소에 정의된 애플리케이션의 선언적 매니페스트를 읽고,

이를 Kubernetes 클러스터에 배포하고 동기화(Sync)하는 역할을 합니다.

 

✅ Argo CD 애플리케이션의 특징

✔ GitOps 원칙 기반 → Git 저장소에 정의된 상태를 Kubernetes에 자동 반영

✔ 선언적(Declarative) 방식 → YAML 파일을 사용하여 정의

✔ 자동화된 동기화 → Git 상태 변경 시 자동 업데이트 가능

✔ 리소스 모니터링 → Kubernetes 리소스의 상태를 지속적으로 감시

 

---

🔹 Argo CD 애플리케이션의 주요 개념

 

✅ 1. 애플리케이션(Application) CRD

 

Argo CD에서 애플리케이션은 Kubernetes의 **Custom Resource Definition(CRD)**로 관리됩니다.

즉, Application이라는 Kubernetes 리소스로 등록되며, 이를 통해 Argo CD가 리소스를 감시하고 관리합니다.

 

✅ 2. 프로젝트(Project) 기반 애플리케이션 관리

 

Argo CD는 여러 애플리케이션을 “프로젝트(Project)” 단위로 그룹화하여 관리할 수 있습니다.

이를 통해 **RBAC(Role-Based Access Control)**을 적용하거나, 특정 네임스페이스에 배포되는 애플리케이션을 제어할 수 있습니다.

 

✅ 3. 애플리케이션 동기화(Sync) 및 상태 모니터링

 

Argo CD는 애플리케이션이 Git 상태와 일치하는지 지속적으로 감시하며,

OutOfSync 상태 발생 시 자동 또는 수동으로 동기화 작업을 수행합니다.

 

---

🔹 Argo CD 애플리케이션 매니페스트(YAML) 예제

 

아래는 Argo CD에서 애플리케이션을 정의하는 YAML 예제입니다.

apiVersion: argoproj.io/v1alpha1  # Argo CD의 API 버전 지정
kind: Application  # Argo CD에서 관리하는 애플리케이션 리소스
metadata:
  name: example-app  # 애플리케이션 이름
  namespace: argocd  # Argo CD 네임스페이스
spec:
  project: default  # Argo CD에서 관리하는 프로젝트 이름
  source:
    repoURL: https://github.com/example/repo.git  # 애플리케이션의 Git 저장소 URL
    targetRevision: HEAD  # 최신 버전을 사용
    path: manifests  # 애플리케이션 매니페스트가 위치한 디렉터리
  destination:
    server: https://kubernetes.default.svc  # Kubernetes API 서버 주소
    namespace: example-app  # 배포할 네임스페이스
  syncPolicy:
    automated:
      prune: true  # Git 상태와 다를 경우 불필요한 리소스 자동 삭제
      selfHeal: true  # Kubernetes 리소스가 변경되었을 경우 원래 상태로 자동 복구

 

✅ 설명

• repoURL → Git 저장소의 URL

• targetRevision → 적용할 Git 브랜치 또는 태그

• path → Git 저장소 내의 매니페스트 파일이 위치한 디렉터리

• destination → 배포될 Kubernetes 클러스터 및 네임스페이스

• syncPolicy → 애플리케이션을 자동 동기화하는 설정

 

---

🔹 애플리케이션 동기화(Sync) 및 배포 원리

 

Argo CD는 GitOps 원칙에 따라 Git 저장소에 저장된 애플리케이션의 선언적 상태와 Kubernetes 클러스터의 실제 상태를 비교하여 동기화합니다.

 

✅ 1. 동기화 상태(Sync Status)

Sync 상태	설명
Synced	애플리케이션이 Git 상태와 동일
OutOfSync	애플리케이션이 Git 상태와 불일치
Unknown	애플리케이션 상태를 확인할 수 없음

 

✅ 2. 자동 동기화(Automated Sync) 설정

 

Argo CD는 syncPolicy 설정을 통해 자동으로 애플리케이션을 동기화할 수 있습니다.

syncPolicy:
  automated:
    prune: true  # 불필요한 리소스 자동 삭제
    selfHeal: true  # Kubernetes 리소스가 수동 변경되었을 경우 자동 복구

✔ prune: true → Git에서 삭제된 리소스는 Kubernetes에서도 삭제됨

✔ selfHeal: true → Kubernetes 리소스가 변경되면 Git 상태로 자동 복구

 

---

🔹 Argo CD 애플리케이션 CLI 명령어

 

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

argocd app list

 

✅ 2. 애플리케이션 상세 정보 확인

argocd app get example-app

 

✅ 3. 애플리케이션 동기화(Sync)

argocd app sync example-app

 

✅ 4. 애플리케이션 롤백(Rollback)

argocd app rollback example-app 2

 

---

🔹 애플리케이션 롤백 시 이전 버전 확인 방법

 

Argo CD에서 애플리케이션을 롤백할 때 **버전 번호(예: 2)**는 해당 애플리케이션의 배포 이력을 조회하여 확인할 수 있습니다.

 

✅ 애플리케이션의 배포 이력(Revision) 확인

argocd app history example-app

 

💡 예상 출력 값

ID  DATE                      COMMIT         SYNC STATUS  HEALTH STATUS  PARAMETERS
1   2025-03-10 12:00:00 UTC   a1b2c3d        Synced       Healthy        replicas=3
2   2025-03-12 15:30:00 UTC   d4e5f6g        OutOfSync    Degraded       replicas=2
3   2025-03-15 10:45:00 UTC   h7i8j9k        Synced       Healthy        replicas=3

 

✅ 롤백할 버전 선택

 

위의 배포 이력에서 ID가 2인 경우, 이를 롤백하려면 다음 명령어를 실행하면 됩니다.

argocd app rollback example-app 2

 

💡 예상 출력 값

Rolled back 'example-app' to revision 2.

 

✅ 정리

• 배포 이력 조회: argocd app history <APP_NAME>

• 롤백할 버전 확인: ID 값 확인

• 특정 버전으로 롤백: argocd app rollback <APP_NAME> <ID>