Helm

Kubernetes ํŒจํ‚ค์ง€ ๊ด€๋ฆฌ๋ฅผ ๋„์™€์ฃผ๋Š” ๋„๊ตฌ. node.js์˜ npm๊ณผ ๊ฐ™์€ ์—ญํ• ์„ ์ˆ˜ํ–‰ํ•œ๋‹ค.

Helm์„ ์‚ฌ์šฉํ•˜๋ฉด ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ํด๋Ÿฌ์Šคํ„ฐ์—์„œ ๋™์ž‘ํ•˜๋„๋ก ์ž‘์„ฑ๋œ ํŒจํ‚ค์ง€๋“ค์„ ๊ด€๋ฆฌํ•  ์ˆ˜ ์žˆ๋‹ค. ์ฆ‰, Helm์„ ์‚ฌ์šฉํ•˜๋ฉด ํด๋Ÿฌ์Šคํ„ฐ์— ๋ฐฐํฌํ•œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์‰ฝ๊ฒŒ ์„ค์น˜, ์—…๋ฐ์ดํŠธ, ์‚ญ์ œํ•  ์ˆ˜ ์žˆ๋‹ค.

์ผ๋ฐ˜์ ์œผ๋กœ ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค๋Š” ์—ฌ๋Ÿฌ ์˜ค๋ธŒ์ ํŠธ๋กœ ๊ตฌ์„ฑ๋˜์–ด์žˆ๋Š”๋ฐ, ๋งŒ์•ฝ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ƒˆ๋กœ ์—…๋ฐ์ดํŠธํ•˜๊ณ  ์‹ถ์œผ๋ฉด, ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ํฌํ•จํ•˜๋Š” ๋ชจ๋“  ์˜ค๋ธŒ์ ํŠธ๋งˆ๋‹ค kubectl ๋ช…๋ น์„ ๋‚ ๋ ค์•ผํ•˜๋Š”๋ฐ, Helm์„ ์‚ฌ์šฉํ•˜๋ฉด ํ•˜๋‚˜์˜ ๋ช…๋ น์œผ๋กœ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ๋ฐฐํฌํ•  ์ˆ˜ ์žˆ๋‹ค.

์ฃผ์š” ๊ฐœ๋…

helm์€ Chart, Repository, Release ๋กœ ๊ตฌ์„ฑ๋˜์–ด์žˆ์œผ๋ฉฐ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์—ฐ๊ณ„๋œ๋‹ค.

K8s cluster ๋‚ด๋ถ€์— Helm chart๋ฅผ ์›ํ•˜๋Š” repository์—์„œ ๊ฒ€์ƒ‰ํ›„ ์„ค์น˜ โ†’ ๊ฐ ์„ค์น˜์— ๋”ฐ๋ฅธ ์ƒˆ๋กœ์šด Release ์ƒ์„ฑ

๊ฐ ๊ตฌ์„ฑ์š”์†Œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

Chart(์ฐจํŠธ)

Helm ํŒจํ‚ค์ง€๋กœ, k8s cluster์—์„œ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ด ๊ธฐ๋™๋˜๊ธฐ ์œ„ํ•ด ํ•„์š”ํ•œ ๋ชจ๋“  ๋ฆฌ์†Œ์Šค๋“ค์„ ํฌํ•จ. ์—ฌ๋Ÿฌ ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ์˜ค๋ธŒ์ ํŠธ๋ฅผ ํ•˜๋‚˜๋กœ ๋ฌถ์€ ๊ฒƒ์ด๋ผ ๋ณผ ์ˆ˜ ์žˆ๋‹ค.

ํŠน์ • ๋””๋ ‰ํ„ฐ๋ฆฌ ํ•˜์œ„์— ๋ชจ์—ฌ์žˆ๋Š” ํŒŒ์ผ๋“ค์„ ํ†ตํ‹€์–ด์„œ chart๋ผ๊ณ  ๋ถ€๋ฅธ๋‹ค. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ Helm์œผ๋กœ ๋ฐฐํฌํ•˜๋ ค๋ฉด ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์ •์˜ํ•˜๋Š” Helm ์ฐจํŠธ๋ฅผ ์ž‘์„ฑํ•ด์•ผํ•œ๋‹ค. Chart ๊ตฌ์„ฑ์— ๊ด€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ ๊ณต์‹๋ฌธ์„œ์—์„œ ํ™•์ธ ๊ฐ€๋Šฅํ•˜๋ฉฐ ๊ธฐ๋ณธ์ ์œผ๋กœ ์•„๋ž˜์™€ ๊ฐ™๋‹ค.

chart/
	Chart.yaml               # ์ฐจํŠธ์˜ ์ •๋ณด๋ฅผ ๋‹ด๊ณ  ์žˆ์Œ.
	LICENSE                  # OPTIONA
	README.md                # OPTIONAL
	requirements.yaml        # OPTIONAL: ์ฐจํŠธ์˜ ์˜์กด์„ฑ์„ ํฌํ•จํ•œ ํŒŒ์ผ
	values.yaml              # ๋ฐฐํฌ๋•Œ๋งˆ๋‹ค ๋ฐ”๋€” ์ˆ˜ ์žˆ๋Š” ๊ฐ’์„ ํฌํ•จ
	charts/                  # ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ์˜์กด์„ฑ๋“ค์˜ helm chart๋ฅผ ์ €์žฅ
					# ex) ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ helm chart ์„ค์น˜์‹œ ํ•„์š”ํ•˜๋ฉด mysql helm chart๋ฅผ ์ €์žฅ
	templates/               # ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ์˜ค๋ธŒ์ ํŠธ ํ…œํ”Œ๋ฆฟ์˜ ๋””๋ ‰ํ„ฐ๋ฆฌ. ์‹ค์ œ ๋ฐฐํฌ์‹œ ํ•„์š”ํ•จ.
					# ์„ค์ •๊ฐ’๊ณผ ๊ฒฐํ•ฉํ•˜์—ฌ ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋ฉ”๋‹ˆํŽ˜์ŠคํŠธ๋ฅผ ์ƒ์„ฑํ•˜๋Š”๋ฐ ์‚ฌ์šฉํ•œ๋‹ค.
	templates/NOTES.txt      # OPTIONAL: A plain text file containing short usage notes

์œ„์™€ ๊ฐ™์€ ๊ตฌ์กฐ์— version ์ •๋ณด๊ฐ€ ๋ถ™์–ด์„œ tgz ํ˜•ํƒœ๋กœ ์••์ถ• ํŒจํ‚ค์ง• ๋œ๋‹ค. ex) nginx-1.2.3.tgz

Repository(์ €์žฅ์†Œ)

์ฐจํŠธ ์ €์žฅ์†Œ๋กœ, ์ฐจํŠธ๋ฅผ ๋ชจ์•„๋‘๊ณ  ๊ณต์œ ํ•˜๋Š” ์žฅ์†Œ

Release(๋ฆด๋ฆฌ์ฆˆ)

K8s cluster์—์„œ ๊ตฌ๋™๋˜๋Š” ์ฐจํŠธ ์ธ์Šคํ„ด์Šค. ์ผ๋ฐ˜์ ์œผ๋กœ ๋™์ผํ•œ chart๋ฅผ ์—ฌ๋Ÿฌ ๋ฒˆ ์„ค์น˜ํ•  ์ˆ˜ ์žˆ๊ณ  ์ด๋Š” ์ƒˆ๋กœ์šด Release๋กœ ๊ด€๋ฆฌ๋˜๊ฒŒ ๋œ๋‹ค. Release ๋  ๋•Œ ํŒจํ‚ค์ง€๋œ ์ฐจํŠธ์™€ config๊ฐ€ ๊ฒฐํ•ฉ๋˜์–ด ์ •์ƒ ์‹คํ–‰๋˜๊ฒŒ ๋œ๋‹ค.


Chart.yaml

apiVersion: v1
appVersion: "1.0"
description: A Helm chart for Kubernetes
name: mychart
version: 0.1.0
  • apiVersion : helm chart api ๋ฒ„์ „
    • helm 3 ์ด์ƒ์ด ํ•„์š”ํ•˜๋ฉด v2 ์—ฌ์•ผํ•จ.
    • helm 3 ์ด์ „์„ ์‚ฌ์šฉํ•˜๋ฉด v1์„ ์‚ฌ์šฉ.
  • appVersion : ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜ ๋ฒ„์ „์„ ๋‚˜ํƒ€๋‚ด๋Š” ํ•„๋“œ. ์ •๋ณด๋งŒ ์ œ๊ณตํ•˜๊ณ  ์ฐจํŠธ ๋ฒ„์ „ ๊ณ„์‚ฐ์— ์‚ฌ์šฉ๋˜์ง€ ์•Š์Œ,
  • description : ํ”„๋กœ์ ํŠธ ์„ค๋ช…
  • name : ์ฐจํŠธ๋ช…
  • version : semver 2 ๋ฒ„์ „. ํ•ด๋‹น ์ฐจํŠธ์˜ ๋ฒ„์ „์„ ๋‚˜ํƒ€๋‚ด๋Š” ํ•„๋“œ.
  • kubeVersion : ํ˜ธํ™˜๋˜๋Š” ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋ฒ„์ „์˜ SemVer ๋ฒ”์œ„

values.yaml

# Default values for mychart.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.
 
replicaCount: 1
 
image:
  repository: nginx
  tag: stable
  pullPolicy: IfNotPresent
 
imagePullSecrets: []
nameOverride: ""
fullnameOverride: ""

templates์—์„œ ์‚ฌ์šฉํ•  ๊ฐ’๋“ค์„ ์ €์žฅํ•ด๋†“์€ ๊ณณ. go template


templates

์ฐจํŠธ๋ฅผ ์ž‘์„ฑํ•  ๋•Œ ๊ฐ€์žฅ ์ค‘์š”ํ•œ ๋ถ€๋ถ„์ค‘ ํ•˜๋‚˜๋Š” templates/ ๋””๋ ‰ํ„ฐ๋ฆฌ์ด๋‹ค. ์ด ๋””๋ ‰ํ„ฐ๋ฆฌ์˜ ํ…œํ”Œ๋ฆฟ๋“ค์ด ์‹ค์ œ๋กœ ์ƒ์„ฑํ•  ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ์˜ค๋ธŒ์ ํŠธ๋ฅผ ์ •์˜ํ•˜๊ธฐ ๋•Œ๋ฌธ์ด๋‹ค.

Helm ํ…œํ”Œ๋ฆฟ์€ Go์˜ ํ…œํ”Œ๋ฆฟ ๋ฐฉ์‹์„ ๋”ฐ๋ฅธ๋‹ค. \{\{\}\}๋กœ ๊ฐ๊นŒ์ง„ ์˜์—ญ์„ ํ…œํ”Œ๋ฆฟ ๋””๋ ‰ํ‹ฐ๋ธŒ๋ผ๊ณ  ํ•˜๋Š”๋ฐ, ์ด ํ…œํ”Œ๋ฆฟ ๋””๋ ‰ํ‹ฐ๋ธŒ๋ฅผ ํ™œ์šฉํ•˜์—ฌ ์–ด๋–ค ๊ฐ’์„ ํŠน์ • ๊ฐ’์œผ๋กœ ์น˜ํ™˜ํ•˜๊ฑฐ๋‚˜ if/else์™€ ๊ฐ™์€ ์ปจํŠธ๋กค ๊ตฌ์กฐ๋ฅผ ๋‚˜ํƒ€๋‚ผ ์ˆ˜ ์žˆ๋‹ค. ๋˜ํ•œ ํ•จ์ˆ˜๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

 
apiVersion: apps/v1
kind: Deployment
metadata:
  name: \{\{ include "test-chart.fullname" . \}\}
  labels:
\{\{ include "test-chart.labels" . | indent 4 \}\}
...
\{\{- if .Values.ingress.enabled -\}\}
 

chart ํ…œํ”Œ๋ฆฟ ์ž‘์„ฑ ๊ฐ€์ด๋“œ

templates/ ๋””๋ ‰ํ„ฐ๋ฆฌ ๊ทœ์น™

๋งํฌ

  1. templates/ ์•„๋ž˜์— ์žˆ๋Š” ๋ชจ๋“  ํŒŒ์ผ์€ NOTES.txt๋ฅผ ์ œ์™ธํ•˜๊ณค ์ „๋ถ€ ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋ฉ”๋‹ˆํŽ˜์ŠคํŠธ๋กœ ๋‹ค๋ค„์ง„๋‹ค.
  2. _๋กœ ์‹œ์ž‘ํ•˜๋Š” ํŒŒ์ผ์€ ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ๋ฉ”๋‹ˆํŽ˜์ŠคํŠธ๋กœ ๋‹ค๋ค„์ง€์ง€ ์•Š๋Š”๋‹ค. ์ฟ ๋ฒ„๋„คํ‹ฐ์Šค ์˜ค๋ธŒ์ ํŠธ๋ฅผ ๋งŒ๋“ค์ง€๋„ ์•Š๊ณ , ๋‹ค๋ฅธ ์ฐจํŠธ ๋ฉ”๋‹ˆํŽ˜์ŠคํŠธ์—์„œ ์‚ฌ์šฉํ•œ๋‹ค.

Helm ์ž‘์„ฑ๋ฒ• ๋งํฌ


์ถœ์ฒ˜