Что такое Helm chart и зачем он нужен?

charts/orders-api/
├── Chart.yaml              # имя, версия chart-а, appVersion, зависимости
├── values.yaml             # значения по умолчанию
├── values-prod.yaml        # переопределения для окружения (часто хранятся рядом с деплой-конфигом)
├── templates/
│   ├── _helpers.tpl        # именованные шаблоны: имена, метки
│   ├── deployment.yaml
│   ├── service.yaml
│   ├── ingress.yaml
│   ├── configmap.yaml
│   ├── hpa.yaml
│   ├── migrations-job.yaml # hook: pre-upgrade
│   └── NOTES.txt           # подсказка после установки
└── charts/                 # скачанные зависимости

apiVersion: v2
name: orders-api
version: 1.3.0            # версия chart-а (шаблонов)
appVersion: "1.4.2"       # версия приложения по умолчанию
dependencies:
  - name: redis
    version: 20.x.x
    repository: oci://registry-1.docker.io/bitnamicharts
    condition: redis.enabled

replicaCount: 2
image:
  repository: registry.example.uz/orders-api
  tag: ""                       # по умолчанию — appVersion
resources:
  requests: { cpu: 250m, memory: 256Mi }
  limits: { memory: 512Mi }
env:
  ASPNETCORE_ENVIRONMENT: Production
ingress:
  enabled: true
  host: shop.example.uz
  path: /api/orders
autoscaling:
  enabled: false
  minReplicas: 2
  maxReplicas: 10
  targetCPU: 70
migrations:
  enabled: true
redis:
  enabled: false

apiVersion: apps/v1
kind: Deployment
metadata:
  name: {{ include "orders-api.fullname" . }}
  labels: {{- include "orders-api.labels" . | nindent 4 }}
spec:
  {{- if not .Values.autoscaling.enabled }}
  replicas: {{ .Values.replicaCount }}
  {{- end }}
  selector:
    matchLabels: {{- include "orders-api.selectorLabels" . | nindent 6 }}
  template:
    metadata:
      labels: {{- include "orders-api.selectorLabels" . | nindent 8 }}
      annotations:
        checksum/config: {{ include (print $.Template.BasePath "/configmap.yaml") . | sha256sum }}   # перезапуск подов при изменении конфигурации
    spec:
      containers:
        - name: app
          image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"
          ports: [{ containerPort: 8080 }]
          envFrom: [{ configMapRef: { name: {{ include "orders-api.fullname" . }} } }]
          resources: {{- toYaml .Values.resources | nindent 12 }}
          readinessProbe: { httpGet: { path: /health/ready, port: 8080 } }
          livenessProbe: { httpGet: { path: /health/live, port: 8080 } }

{{- if .Values.migrations.enabled }}
apiVersion: batch/v1
kind: Job
metadata:
  name: {{ include "orders-api.fullname" . }}-migrations
  annotations:
    "helm.sh/hook": pre-install,pre-upgrade           # выполнить ДО обновления Deployment
    "helm.sh/hook-delete-policy": before-hook-creation,hook-succeeded
spec:
  backoffLimit: 1
  template:
    spec:
      restartPolicy: Never
      containers:
        - name: migrate
          image: "{{ .Values.image.repository }}-migrations:{{ .Values.image.tag | default .Chart.AppVersion }}"
          args: ["--connection", "$(ConnectionStrings__Default)"]   # EF migration bundle
          envFrom: [{ secretRef: { name: orders-api-secrets } }]
{{- end }}

helm lint ./charts/orders-api
helm template orders-api ./charts/orders-api -f values-prod.yaml   # посмотреть итоговый YAML без установки
helm upgrade --install orders-api ./charts/orders-api -n shop --create-namespace \
  -f values-prod.yaml --set image.tag=sha-3f9a1c2 --atomic --wait --timeout 10m
helm list -n shop
helm history orders-api -n shop
helm rollback orders-api 11 -n shop
helm diff upgrade orders-api ./charts/orders-api -f values-prod.yaml   # плагин helm-diff: что изменится
helm push orders-api-1.3.0.tgz oci://registry.example.uz/charts     # хранение в OCI-реестре