[Ep.7] [Argo CD 운영 #2] Argo CD 웹 UI 탐색: 주요 기능과 활용법

🔹 Argo CD 웹 UI란?

Argo CD는 웹 UI, CLI, API를 통해 Kubernetes 애플리케이션을 관리할 수 있습니다.
그중 웹 UI는 배포 상태를 직관적으로 확인하고, 동기화(Sync) 및 롤백(Rollback) 등의 작업을 간편하게 수행할 수 있는 강력한 도구입니다.

 

✅ Argo CD 웹 UI의 주요 기능:
✔ 전체 애플리케이션 목록 및 상태 모니터링
✔ 특정 애플리케이션의 동기화(Sync) 및 롤백(Rollback)
✔ 애플리케이션의 리소스 트리 및 로그 조회
✔ Kubernetes 클러스터 및 프로젝트 관리

---

🔹 Argo CD 웹 UI 접속 방법

✅ 1. 포트 포워딩을 이용한 로컬 접속

Argo CD는 기본적으로 내부 네트워크에서 실행되므로, 로컬에서 접근하려면 포트 포워딩이 필요합니다.

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

 

이제 브라우저에서 다음 주소로 접속하면 웹 UI에 접근할 수 있습니다.

https://localhost:8080

---

✅ 2. LoadBalancer 또는 Ingress를 이용한 외부 접속

프로덕션 환경에서는 LoadBalancer 또는 Ingress를 사용하여 Argo CD에 접근할 수 있습니다.

방법 1: LoadBalancer 서비스 노출

kubectl get svc -n argocd

 

출력 예시:

NAME            TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)
argocd-server   LoadBalancer   10.100.200.1     192.168.1.100   443:31234/TCP

이 경우, https://192.168.1.100으로 접속하면 Argo CD UI를 사용할 수 있습니다.

방법 2: Ingress를 통한 도메인 접근

Helm을 사용하여 Ingress를 설정하면, https://argocd.example.com과 같이 도메인으로 접근할 수도 있습니다.

server:
  ingress:
    enabled: true
    hosts:
      - argocd.example.com

---

✅ 3. Argo CD 로그인

Argo CD 웹 UI 로그인 페이지에서 admin 계정으로 로그인합니다.
초기 비밀번호는 다음 명령어를 실행하여 확인할 수 있습니다.

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

보안을 위해 로그인 후 비밀번호를 변경하는 것이 좋습니다.

---

🔹 Argo CD 웹 UI 주요 기능 살펴보기

✅ 1. 애플리케이션 대시보드

그림 1) argocd 대시보드 초기화면

 

Argo CD 웹 UI에 로그인하면, 그림 1)과 같이 현재 배포된 애플리케이션 목록을 확인할 수 있습니다.
각 애플리케이션에는 **배포 상태(Sync Status)와 건강 상태(Health Status)**가 표시됩니다.

 

상태	설명
Synced	애플리케이션이 Git 저장소의 선언된 상태와 일치함
OutOfSync	애플리케이션이 Git 상태와 다름 (수동/자동 동기화 필요)
Healthy	모든 Kubernetes 리소스가 정상적으로 동작 중
Degraded	일부 리소스가 오류 상태
Missing	선언된 리소스가 클러스터에서 발견되지 않음

---

✅ 2. 애플리케이션 상세 페이지

그림 2) 어플리케이션 상세 페이지

 

그림 2와 같이 특정 애플리케이션을 클릭하면 애플리케이션의 세부 정보를 확인할 수 있습니다.

• 애플리케이션의 배포 상태 및 동기화 상태 확인
• 각 리소스(Pod, Service, Deployment 등)의 상태 모니터링
• 이벤트 로그 및 에러 메시지 확인

---

✅ 3. 애플리케이션 동기화(Sync) 및 롤백(Rollback)

🔹 애플리케이션 동기화(Sync)

Git 저장소에서 변경 사항이 발생하면 "OutOfSync" 상태로 표시됩니다.
이때 "SYNC" 버튼을 클릭하면 Git의 최신 상태로 Kubernetes 리소스가 업데이트됩니다.

 

그림 3) History & Rollback 화면

 

🔹 특정 커밋으로 롤백(Rollback)

• 배포 중 오류가 발생하면 이전 상태로 롤백 가능
• 그림 3)과 같이 "HISTORY & ROLLBACK" 탭에서 특정 버전을 선택하고 "ROLLBACK" 버튼 클릭

---

✅ 4. 리소스 트리 및 실시간 로그 조회

 

그림 4) Pod 로그 화면

 

Argo CD UI에서는 위의 그림 2)와 같이 각 리소스가 어떻게 배포되었는지 시각적으로 확인할 수 있습니다.

• 리소스 트리: 애플리케이션의 모든 Kubernetes 리소스를 계층 구조로 표시
• Pod 로그 보기: 그림 4)와 같이 실행 중인 컨테이너의 로그를 실시간으로 확인

---

✅ 5. 프로젝트 및 사용자 관리

Argo CD는 RBAC(Role-Based Access Control)를 통해 프로젝트별 접근 권한을 설정할 수 있습니다.

• 프로젝트(Project) 생성: 특정 애플리케이션 그룹을 별도로 관리
• 사용자(Role) 및 권한 설정: 개발자, 관리자 등 역할 기반 접근 제어

---

🔹 Argo CD 웹 UI 주요 기능 정리

 

기능	설명
대시보드	전체 애플리케이션 목록 및 상태 확인
애플리케이션 상세 보기	배포 상태, 리소스 트리, 로그 확인
동기화(Sync)	Git 변경 사항을 Kubernetes에 반영
롤백(Rollback)	이전 배포 버전으로 복구
리소스 트리	애플리케이션의 리소스를 계층 구조로 시각화
RBAC 관리	프로젝트 및 사용자 접근 제어 설정

---

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

🟢 Argo CD 웹 UI를 활용하면 Kubernetes 애플리케이션을 직관적으로 관리 가능
🟢 포트 포워딩, LoadBalancer, Ingress를 이용하여 UI에 접근하는 방법 학습
🟢 애플리케이션 동기화(Sync), 롤백(Rollback), 로그 조회 등의 기능을 UI에서 쉽게 실행 가능
🟢 RBAC 설정을 통해 프로젝트 및 사용자 권한을 관리할 수 있음