Customizing chart parameters

✅ Helm 설치 시 값 커스터마이징 3가지 방법

---

1️⃣ CLI에서 --set 옵션 사용 (가장 간단함)

helm install my-site bitnami/wordpress \
  --set wordpressBlogName="Helm Tutorials" \
  --set wordpressEmail="john@example.com"

• values.yaml 내의 키를 dot notation 없이 직접 지정하여 덮어쓰기 가능
• 복잡한 nested 구조에서는 . 구문을 이용하거나 --set-string 등을 사용
• 장점: 빠르게 소수 값만 수정할 때 유용
• 단점: 여러 값이나 복잡한 구조에서는 관리 어려움

---

2️⃣ 별도 values.yaml 파일 만들어서 --values 옵션으로 지정

# customvalues.yaml
wordpressBlogName: Helm Tutorials
wordpressEmail: john@example.com
service:
  type: NodePort

helm install my-site bitnami/wordpress -f customvalues.yaml

• 복잡하거나 수십 개의 설정값을 수정할 경우 매우 유용
• 장점: 설정 파일 형태로 버전관리 가능
• 단점: 간단한 테스트에는 번거로움

---

3️⃣ 차트를 직접 로컬로 다운로드하여 수정 후 설치 (helm pull --untar)

helm pull bitnami/wordpress --untar
cd wordpress/
nano values.yaml       # 직접 수정

helm install my-site ./wordpress

• 원본 chart의 구조와 템플릿까지 모두 파악 가능
• 공식 chart에서 너무 많은 값을 바꾸거나, 템플릿까지 커스터마이징할 경우 사용
• 장점: 완전한 제어권 (템플릿까지 수정 가능)
• 단점: chart 업데이트가 필요하면 직접 관리해야 함

---

🚀 실무에서의 추천 전략

목적	추천 방법
소규모 설정 변경	--set 사용
배포 파라미터 관리	-f values.yaml 사용
복잡한 템플릿 구조 수정	helm pull --untar 후 수정 및 로컬 설치

---

💡 실무 팁

• --set은 쉘 특수문자에 주의해야 함 (예: --set password="pa$$word" 같이 쌍따옴표 처리)

• Helm chart마다 values.yaml 구조가 다르기 때문에 항상 미리 확인 필요:

  helm show values bitnami/wordpress > sample.yaml

• 여러 개의 -f 옵션을 지정할 수 있고, 후순위 파일이 우선 적용됨:

  helm install my-app -f base.yaml -f dev.yaml

---

📌 명령어 정리

목적	명령어
CLI에서 값 지정	--set key=value
값 파일로 지정	-f custom.yaml 또는 --values custom.yaml
차트 수정하려면	helm pull <chart> --untar
수정한 차트 설치	helm install myapp ./chart-dir

---

✅ 정리

Helm을 단순히 설치 도구로만 보면 안 되고, 동일한 chart로 다양한 환경에 맞춘 배포를 가능하게 하는 템플릿 도구로 이해. 이때 가장 중요한 것은 값(value)을 어떻게 전달하고 override하는지 제대로 아는 것. 이 3가지 방법은 실무에서 모두 사용.