Helm 入门：把一堆 YAML 变成可复用的 chart

Chart（模板目录）                          Values（参数）
  templates/*.yaml                         values.yaml        ← 默认值
  Chart.yaml / _helpers.tpl                -f values-prod.yaml ← 文件覆盖
        │                                  --set web.replicaCount=3 ← 命令行
        │                                  │
        └────────────────┬─────────────────┘
                           │  helm template（本地渲染，不接触集群）
                           ▼
                  渲染后的标准 YAML 清单
                           │  helm install / helm upgrade
                           ▼
        Release demo（记录存在集群的 Secret 里，带 revision 号）
                           │  提交清单
                           ▼
   集群资源：Deployment / Service / ConfigMap / PVC …
                           │  helm rollback demo 1 → 回到 revision 1 再提交

brew install helm                       # macOS；Linux / WSL 用官方脚本：
curl -fsSL https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash
helm version                            # 期望 v3.x
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update

kube101-app/
├── Chart.yaml          chart 的身份证：名字、版本、类型
├── values.yaml         默认参数，用户覆盖的就是它
├── charts/             依赖的子 chart（现在为空）
├── .helmignore         打包时忽略哪些文件（类似 .gitignore）
└── templates/
    ├── deployment.yaml / service.yaml / hpa.yaml / ingress.yaml
    ├── NOTES.txt        安装成功后打印给用户的提示
    ├── _helpers.tpl     可复用的模板片段，不会生成资源
    └── tests/test-connection.yaml

# 1. 取值：从 values.yaml 或命令行拿参数
replicas: {{ .Values.web.replicaCount }}
image: {{ .Values.image.web }}
name: {{ .Release.Name }}-web     # .Release 是本次发布的元信息：Name / Namespace / Revision

# 2. include 复用 _helpers.tpl 里的片段；nindent 负责「换行 + 缩进 4 格」
metadata:
  labels:
    {{- include "kube101-app.labels" . | nindent 4 }}

# 3. if 条件渲染：条件为假时整段消失
{{- if .Values.ingress.enabled }}
apiVersion: networking.k8s.io/v1
kind: Ingress
{{- end }}

# 4. range 遍历 map，把参数展开成 env 列表
env:
  {{- range $key, $value := .Values.web.env }}
  - name: {{ $key }}
    value: {{ $value | quote }}
  {{- end }}

namespace: demo
image:
  web: nginx:1.27
  api: hashicorp/http-echo:1.0
  redis: redis:7.2
web:
  replicaCount: 2
  env:
    APP_ENV: production
api:
  replicaCount: 2
  greeting: hello from api
redis:
  persistence:
    enabled: true
    size: 1Gi
ingress:
  enabled: true
  host: kube101.local

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
  namespace: {{ .Values.namespace }}
data:
  APP_ENV: {{ .Values.web.env.APP_ENV | quote }}
  API_GREETING: {{ .Values.api.greeting | quote }}
  REDIS_HOST: {{ printf "%s-redis" .Release.Name | quote }}

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "kube101-app.fullname" . }}-api
  labels:
    {{- include "kube101-app.labels" . | nindent 4 }}
spec:
  replicas: {{ .Values.api.replicaCount }}
  selector:
    matchLabels:
      app: {{ include "kube101-app.fullname" . }}-api
  template:
    metadata:
      labels:
        app: {{ include "kube101-app.fullname" . }}-api
    spec:
      containers:
        - name: api
          image: {{ .Values.image.api }}
          args:
            - -listen=:5678
            - -text=$(API_GREETING)
          env:
            - name: API_GREETING
              valueFrom:
                configMapKeyRef:
                  name: app-config
                  key: API_GREETING

{{- if .Values.redis.persistence.enabled }}
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: {{ .Release.Name }}-redis-data
  namespace: {{ .Values.namespace }}
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: {{ .Values.redis.persistence.size }}
{{- end }}

helm lint ./kube101-app                  # 语法与规范检查
helm template demo ./kube101-app -n demo # 渲染成最终 YAML 打印到屏幕
helm template demo ./kube101-app -n demo > rendered.yaml   # 存下来对比

# values-prod.yaml
web:
  replicaCount: 5
image:
  web: nginx:1.27-alpine

helm upgrade demo ./kube101-app -n demo                          # 副本 2，镜像 nginx:1.27
helm upgrade demo ./kube101-app -n demo -f values-prod.yaml      # 副本 5，镜像 nginx:1.27-alpine
helm upgrade demo ./kube101-app -n demo -f values-prod.yaml --set web.replicaCount=10

helm get values demo -n demo --all    # 合并后的完整参数（不带 --all 只看被覆盖的部分）
helm get manifest demo -n demo        # 这次发布真正提交到集群的清单