[Ep.5] [GitOps와 Argo CD의 기초 #5] Argo CD 설치 가이드: Helm을 활용해 Kubernetes에 배포하는 방법

🔹 Argo CD 설치 개요

Argo CD를 Kubernetes 클러스터에 배포하는 방법에는 여러 가지가 있습니다.

• kubectl을 이용한 수동 설치
• YAML 매니페스트를 직접 적용
• Helm Chart를 활용한 배포 (추천 방법)

이번 글에서는 Helm Chart를 활용하여 Argo CD를 Kubernetes에 배포하는 방법을 다룹니다.
Helm을 사용하면 설치가 간편하고, 구성을 커스터마이징하기 쉽기 때문입니다.

---

🔹 Argo CD 설치를 위한 사전 준비 사항

✅ 1. Kubernetes 클러스터 준비

Argo CD는 Kubernetes 환경에서 실행되므로, 사전에 클러스터가 준비되어 있어야 합니다.

# 클러스터 상태 확인
kubectl cluster-info
kubectl get nodes

✅ 2. Helm 설치 확인

Helm은 Kubernetes의 패키지 매니저로, Helm Chart를 이용해 Argo CD를 손쉽게 설치할 수 있습니다.

# Helm이 설치되어 있는지 확인
helm version

 

Helm이 설치되지 않았다면 다음 명령어를 사용해 설치할 수 있습니다.

# Helm 설치 (Linux/Mac)
curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

---

🔹 Helm을 사용한 Argo CD 설치

✅ 1. Argo CD Helm Chart 저장소 추가

먼저, Argo CD의 Helm Chart 저장소를 추가해야 합니다.

helm repo add argo https://argoproj.github.io/argo-helm
helm repo update

✅ 2. Argo CD 네임스페이스 생성

Argo CD를 배포할 네임스페이스를 생성합니다.

kubectl create namespace argocd

✅ 3. Helm Chart를 이용한 Argo CD 설치

이제 Helm을 사용하여 Argo CD를 설치합니다.

helm install argocd argo/argo-cd --namespace argocd

이 명령을 실행하면 Argo CD의 주요 구성 요소(API 서버, 애플리케이션 컨트롤러, 리포지터리 서버 등)가 자동으로 배포됩니다.

설치 후, 모든 리소스가 정상적으로 실행되고 있는지 확인합니다.

kubectl get pods -n argocd

 

출력 예시:

NAME                                     READY   STATUS    RESTARTS   AGE
argocd-application-controller-0          1/1     Running   0          2m
argocd-dex-server-769c9db6bd-wzcq6       1/1     Running   0          2m
argocd-redis-6cf9dbd7bc-5nxx8            1/1     Running   0          2m
argocd-repo-server-848fc7fd64-pvbj8      1/1     Running   0          2m
argocd-server-6cf9dbd7bc-lwqz8           1/1     Running   0          2m

---

🔹 Argo CD 초기 설정 및 접근 방법

✅ 1. Argo CD 서버 포트 포워딩 (로컬에서 접근하기 위한 방법)

기본적으로 Argo CD는 argocd-server라는 서비스로 배포되며, 외부에서 접근하려면 포트 포워딩을 사용해야 합니다.

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

이제 웹 브라우저에서 https://localhost:8080으로 접속하면 Argo CD UI에 접근할 수 있습니다.

---

✅ 2. 초기 관리자 비밀번호 확인

Argo CD의 기본 관리자 계정은 admin이며, 초기 비밀번호는 argocd-initial-admin-secret에서 확인할 수 있습니다.

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

 

출력 예시:

s3cr3tPa$$w0rd

 

이제 Argo CD UI에 로그인할 수 있습니다.

• URL: https://localhost:8080
• Username: admin
• Password: 위에서 확인한 초기 비밀번호

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

argocd login localhost:8080
argocd account update-password

---

🔹 Argo CD Ingress 설정 (도메인으로 접근하기)

기본적으로 Argo CD는 LoadBalancer 또는 Ingress를 사용하여 외부에서 접근할 수도 있습니다.
Helm Chart에서 values.yaml을 수정하면 Ingress 설정을 추가할 수 있습니다.

server:
  ingress:
    enabled: true
    hosts:
      - argocd.example.com
    paths:
      - /
    tls:
      - secretName: argocd-tls
        hosts:
          - argocd.example.com

 

이제 Helm을 사용해 Ingress를 적용합니다.

helm upgrade argocd argo/argo-cd --namespace argocd -f values.yaml

이후 argocd.example.com으로 접속하면 Argo CD UI에 접근할 수 있습니다.

---

🔹 Helm 설치 후 주요 명령어 정리

명령어 설명

helm install argocd argo/argo-cd --namespace argocd	Argo CD 설치
helm list -n argocd	Argo CD 설치 확인
helm upgrade argocd argo/argo-cd --namespace argocd	Argo CD 설정 변경 후 업그레이드
helm uninstall argocd -n argocd	Argo CD 삭제

---

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

🟢 Helm Chart를 사용하여 Kubernetes 클러스터에 Argo CD를 손쉽게 배포 가능
🟢 포트 포워딩, LoadBalancer, Ingress를 활용하여 Argo CD UI에 접근하는 방법 학습
🟢 초기 관리자 비밀번호 확인 및 보안 강화를 위해 비밀번호 변경 필요
🟢 Helm을 사용한 Argo CD 설치 및 업그레이드 명령어 정리