gitops-demo

macOS 환경에서 kind k8s 클러스터에 ArgoCD 를 helm 사용하여 설치하기

Prerequisite

• kubectl
• kind 클러스터 설정
• CICD Storage Class 설정 (optional: PV 생성 시 default storageclass 로 설정 해도 됨) cicd-storageclass.yaml

ArgoCD 설정

Namespace 생성

kubectl create ns argocd

PersistentVolume 생성 (optional)

• jenkins-persistence.yaml

kind 로 구성할 때 2개의 워커 노드를 설정을 하였고, 각각 jenkins, argocd 를 위한 hostPath 지정함.

PV 사용을 원지 않으면, 이 과정은 생략 가능함.

kubectl apply -f jenkins-persistence.yaml

Helm 차트 다운로드

• 필요한 버전을 확인 후 다운로드

2025.11.06 기준 최신 버전 9.1.0

• https://artifacthub.io/packages/helm/argo/argo-cd

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

helm pull argo/argo-cd  --version 9.1.0 --untar

http 로 동작하는 values.yaml 파일 생성 (9.1.0 기준)

argocd-http-values.yaml

ArgoCD Helm 차트 설치

helm install argocd argo/argo-cd -n argocd -f argocd-http-values.yaml

helm upgrade argocd argo/argo-cd -n argocd -f argocd-http-values.yaml

동작 검증

# 모든 리소스 확인
kubectl get pod,svc,ep,secret,cm -n argocd
kubectl get crd | grep argo
applications.argoproj.io                     2024-04-14T08:12:16Z
applicationsets.argoproj.io                  2024-04-14T08:12:17Z
appprojects.argoproj.io                      2024-04-14T08:12:16Z

kubectl get appproject -n argocd -o yaml

# configmap
kubectl get cm -n argocd argocd-cm -o yaml
kubectl get cm -n argocd argocd-rbac-cm -o yaml
...
data:
policy.csv: ""
policy.default: ""
policy.matchMode: glob
scopes: '[groups]'

초기 admin 비밀번호 얻기

kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d ;echo
jm7nLuQqTg1U3T3L

비밀번호 변경

위에서 얻은 초기 admin 비밀번호를 사용하여 비밀번호 변경. e.g) admin:argocd2025

localhost:30002 접속 후 User Info -> UPDATE PASSWORD 클릭 후 암호 변경.

ArgoCD 사용하기

Repository 추가

github 에서 원하는 repository 를 생성 후, ArgoCD 에서 해당 repository 를 추가.

Settings -> Repositories -> CONNECT REPO

연결 방법: ssh, https/http, github app, google cloud 지원.

e.g) ssh 연결을 통해 연결한 경우

• type: git
• url: https://github.com/youngseokyoon/jenkinsci-helm-charts

Application 생성

jenkinsci-helm-charts 저장소에 있는 jenkins helm 차트를 배포하기 위한 Application 생성.

• git@github.com:youngseokyoon/jenkinsci-helm-charts.git

Applications -> NEW APP 클릭

• Application Name: cicd-jenkins
• Project: default
• Sync Policy: Automatic
• Repository URL: git@github.com:youngseokyoon/jenkinsci-helm-charts.git
• branch: TBD (default HEAD)

Sync 후 결과

이 후 git@github.com:youngseokyoon/jenkinsci-helm-charts.git update 시 자동으로 동기화됨.

Application Auto Sync 확인

http://127.0.0.1:30003/ 접속 후 jenkins-5.8.104-values.yaml 파일에 설정된 정보로 로그인을 하면 아래와 같은 메시지를 볼 수 있음.

# 아래 처럼 적당히 수정 후 push
git diff
-          systemMessage: "Welcome to CICD Jenkins on Kubernetes"
+          systemMessage: "Welcome to CI/CD Jenkins on Kubernetes"

git log HEAD -n 1 --format=oneline 

d71a852044a40038e4d93beee385b05109602b89 (HEAD -> dev, origin/dev) Controller: Update systemMessage

이 후 http://127.0.0.1:30003/ 접속을 하면 수정한 메시지가 표시됨을 확인.

ArgoCD CLI

https://github.com/argoproj/argo-cd/releases/ 에서 운영체제에 맞는 CLI 다운로드

curl -sL -o argocd https://github.com/argoproj/argo-cd/releases/download/v3.1.9/argocd-darwin-arm64
chmod +x argocd
sudo mv argocd /usr/local/bin/argocd