[HELM] artifact hub 에서 패키지 설치하기

누군가 만들어놓은 helm 차트 패키지를 내 쿠버네티스 환경에서 사용하기 위해서는 artifact hub 를 사용하면 된다. argo 의 argo-cd 패키지를 내 클러스터에 적용하는 예시로 알아보자.

 

1. helm repo 지정

헬름 패키지를 가져올 레포지토리를 아래와 같은 커맨드로 지정한다.

$ helm repo add argo https://argoproj.github.io/argo-helm
"argo" has been added to your repositories

아래와 커맨드로 조회하면 내 서버에 "argo" 라는 이름으로 "https://argoproj.github.io/argo-helm" 주소가 지정된 것을 알 수 있다.

이제 argo-helm 에서 제공하는 패키지를 설치할 수 있는 것이다.

$ helm repo list
NAME    URL
argo    https://argoproj.github.io/argo-helm

추가로, 아래 커맨드처럼 search 를 이용하면 특정 저장소에 속한 패키지들을 조회해볼 수 있다. --versions 옵션을 주면 모든 버전을 조회할 수 있다.

$ helm search repo argo
NAME                            CHART VERSION   APP VERSION     DESCRIPTION
argo/argo                       1.0.0           v2.12.5         A Helm chart for Argo Workflows
argo/argo-cd                    10.3.3          v3.5.1          A Helm chart for Argo CD, a declarative, GitOps...
argo/argo-ci                    1.0.0           v1.0.0-alpha2   A Helm chart for Argo-CI
argo/argo-events                2.4.24          v1.9.11         A Helm chart for Argo Events, the event-driven ...
argo/argo-lite                  0.1.0                           Lighweight workflow engine for Kubernetes
argo/argo-rollouts              2.41.1          v1.9.1          A Helm chart for Argo Rollouts
argo/argo-workflows             2.0.0           v4.1.0          A Helm chart for Argo Workflows
argo/argocd-applicationset      1.12.1          v0.4.1          A Helm chart for installing ArgoCD ApplicationSet
argo/argocd-apps                2.0.5                           A Helm chart for managing additional Argo CD Ap...
argo/argocd-image-updater       1.2.4           v1.2.2          A Helm chart for Argo CD Image Updater, a tool ...
argo/argocd-notifications       1.8.1           v1.2.1          A Helm chart for ArgoCD notifications, an add-o...

 

2. helm template 확인하기

helm template 명령어를 사용하면 최종적으로 클러스터에 적용할 manifest(yaml) 파일을 조회할 수 있다. 이는 설치하려는 helm 차트의 템플릿 파일들에 values.yaml 의 설정값을 결합하여 로컬머신에서 최종 yaml 을 렌더링해보는 것이다. 실제 패키지를 설치하기 전에 확인하는 용도이다.

아래 커맨드는 argo-cd 8.6.4 버전을 argocd 네임스페이스에 crd 를 제외하고 적용할 때 사용되는 템플릿을 출력한다.

helm template <릴리스명> <패키지명> -n <네임스페이스명> --version <설치버전> --set <파라미터>

$ helm template argocd argo/argo-cd -n argocd --version 8.6.4 --set crds.install=false

참고: https://helm.sh/docs/helm/helm_template

helm template | Helm

 

3. helm 패키지 설치하기

아래와 같이 install 명령어로 클러스터에 패키지를 설치한다. 위에서 사용한 template 명령어와 옵션은 동일하며, 이미 namespace 가 생성되어있지 않은 경우 --create-namespace 옵션을 추가해야 한다.

$ helm install argocd argo/argo-cd -n argocd --version 8.6.4 --set crds.install=false --create-namespace
NAME: argocd
LAST DEPLOYED: Sat Aug 15 16:31:39 2026
NAMESPACE: argocd
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
In order to access the server UI you have the following options:
...

 

4. 배포된 오브젝트(Pod) 확인

아래 명령어로 클러스터에 배포된 Pod 들이 정상인지 확인한다.

$ kubectl get -n argocd pods
NAME                                                READY   STATUS    RESTARTS   AGE
argocd-application-controller-0                     1/1     Running   0          83s
argocd-applicationset-controller-7dbb95fc56-p2pss   1/1     Running   0          83s
argocd-dex-server-69d8df8478-888vm                  1/1     Running   0          83s
argocd-notifications-controller-6fffcd649-cqtqx     1/1     Running   0          83s
argocd-redis-658b7bf8c9-9cqz4                       1/1     Running   0          83s
argocd-repo-server-76cf7c8749-hccjs                 1/1     Running   0          83s
argocd-server-5f57dc6487-799lz                      1/1     Running   0          83s