[Ep.12] [Argo CD 운영 #7] Argo CD의 롤백(Rollback) 및 배포 이력 관리

🔹 Argo CD에서 롤백(Rollback)이란?

Argo CD는 GitOps 기반의 배포 자동화 도구로, 애플리케이션의 변경 이력을 추적하고 특정 버전으로 롤백(Rollback)할 수 있는 기능을 제공합니다.
애플리케이션이 정상적으로 동작하지 않거나 문제가 발생했을 때,
Argo CD를 사용하여 손쉽게 이전 버전으로 복구할 수 있습니다.

 

✅ Argo CD의 롤백 주요 개념
✔ 배포 이력(Deployment History)을 자동으로 저장
✔ 이전 배포 버전으로 쉽게 롤백 가능
✔ Git 저장소 기반의 롤백 및 Kubernetes 상태 롤백 지원
✔ CLI 및 UI에서 롤백 실행 가능

---

🔹 Argo CD 배포 이력(Deployment History) 관리

Argo CD는 각 애플리케이션의 배포 이력을 자동으로 저장하며,
이를 기반으로 특정 버전으로 롤백할 수 있습니다.

✅ 배포 이력 조회

애플리케이션의 배포 이력을 확인하려면 CLI 또는 UI를 사용할 수 있습니다.

argocd app history example-app

 

출력 예시:

ID  REVISION        STATUS      SOURCE
1   8f7c2d1        Deployed    https://github.com/example/repo.git
2   a1b4e5f        Deployed    https://github.com/example/repo.git
3   c9d3f9a        Degraded    https://github.com/example/repo.git

 

✔ ID → 배포 버전 번호
✔ REVISION → Git 커밋 해시 값
✔ STATUS → 현재 배포 상태

 

배포 이력은 기본적으로 10개까지 저장되며, 필요에 따라 변경할 수 있습니다.

---

🔹 Argo CD 롤백(Rollback) 수행 방법

✅ 1. 특정 버전으로 롤백하기

이전 배포 버전으로 롤백하려면 다음 명령어를 사용합니다.

argocd app rollback example-app 2

 

✅ 설명:

• example-app → 롤백할 애플리케이션 이름
• 2 → 배포 이력에서 선택한 버전 ID

롤백 후 애플리케이션 상태 확인:

argocd app get example-app

---

✅ 2. Argo CD UI를 사용한 롤백 방법

1️⃣ Argo CD 웹 UI에서 애플리케이션 선택
2️⃣ "HISTORY & ROLLBACK" 버튼 클릭
3️⃣ 특정 버전을 선택한 후 "ROLLBACK" 버튼 클릭
4️⃣ 롤백이 완료되면 상태를 확인

---

🔹 Git 기반 롤백 vs Kubernetes 상태 롤백

Argo CD는 Git 기반 롤백과 Kubernetes 상태 롤백 두 가지 방식을 지원합니다.

 

롤백 방식	설명
Git 기반 롤백	Git 저장소에서 이전 커밋을 체크아웃하여 다시 배포
Kubernetes 상태 롤백	이전 배포 상태로 되돌림 (Git 변경 없음)

 

✅ Git 기반 롤백

git revert HEAD
git push origin main
argocd app sync example-app

• Git에서 이전 커밋으로 되돌린 후, Argo CD에서 동기화 실행

✅ Kubernetes 상태 롤백

argocd app rollback example-app 2

• 현재 Git 상태를 유지한 채 Kubernetes의 배포 이력만 롤백

🚀 운영 환경에서는 Git 기반 롤백이 권장되며, 긴급 복구 시 Kubernetes 상태 롤백을 활용할 수 있음

---

🔹 롤백 시 고려해야 할 사항

✅ 1. 롤백 후에도 Git 상태 유지 필요

• GitOps 방식에서는 Git 저장소가 단일 신뢰 원천(Source of Truth)이므로,
  롤백 후에도 Git 상태를 업데이트해야 함.
• Git에서 revert 후 다시 push를 수행하는 것이 권장됨.

git revert HEAD
git push origin main
argocd app sync example-app

---

✅ 2. 롤백 후 동기화(Sync) 설정

• 롤백 후 자동 동기화를 원할 경우 selfHeal 기능을 활성화해야 함.

syncPolicy:
  automated:
    selfHeal: true

• Git 상태를 유지하려면 prune: true 옵션을 추가하는 것이 좋음.

syncPolicy:
  automated:
    prune: true
    selfHeal: true

---

🔹 Argo CD 롤백 및 배포 이력 CLI 명령어 정리

명령어	설명
argocd app history <APP>	애플리케이션 배포 이력 확인
argocd app rollback <APP> <VERSION>	특정 배포 버전으로 롤백
argocd app get <APP>	애플리케이션 상태 확인
argocd app sync <APP>	Git 저장소와 Kubernetes 상태 동기화
git revert HEAD && git push	Git 기반 롤백 수행

 

✅ 롤백 후 동기화:

argocd app sync example-app

 

✅ Git 기반 롤백:

git revert HEAD
git push origin main
argocd app sync example-app

 

✅ Kubernetes 상태 롤백:

argocd app rollback example-app 2

---

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

🟢 Argo CD는 배포 이력을 자동으로 저장하며, 특정 버전으로 롤백할 수 있는 기능 제공
🟢 Git 기반 롤백과 Kubernetes 상태 롤백을 지원하며, 운영 환경에서는 Git 기반 롤백이 권장됨
🟢 CLI 및 UI에서 손쉽게 롤백 수행 가능하며, 롤백 후 동기화(Sync) 작업 필요
🟢 롤백 후에도 Git 상태를 유지하려면 git revert 및 push 작업이 필요