Provision
—— XP

Практика: стенд релизом Helm

практика~45 минут+650 XP

Чарт собран и проверен локально. Теперь он заменит каталог описаний: стенд, поставленный командой kubectl apply, ты снимешь целиком и поставишь заново как релиз Helm — с историей, хуком миграции и откатом.

Работать будешь из каталога ~/infra/helm, где лежит чарт.

Шаг 1. Снять стенд, поставленный файлами

Helm не знает об объектах, которые создавались без него, и откажется ставить поверх них. Удали стенд тем же каталогом, которым его ставил.

ubuntu@stand:~$
kubectl delete -f ~/infra/k8s/base/
ubuntu@stand:~$
namespace "provision" deleted
configmap "provision-config" deleted
secret "provision-secrets" deleted
service "provision-db" deleted
statefulset.apps "provision-db" deleted
...

Пространство имён удалилось вместе со всем, что в нём было, включая диск базы. На стенде это нормально, на проде так не делают никогда.

Шаг 2. Пространство и секрет

Пространство и секрет чарт не создаёт — верни их файлами.

ubuntu@stand:~$
kubectl apply -f ~/infra/k8s/base/00-namespace.yaml
ubuntu@stand:~$
namespace/provision created
ubuntu@stand:~$
kubectl apply -f ~/infra/k8s/base/11-secret.yaml
ubuntu@stand:~$
secret/provision-secrets created

Шаг 3. Миграция хуком

Открой nano ~/infra/helm/provision/templates/25-migrate.yaml и добавь в metadata аннотации хука — на уровне name.

templates/25-migrate.yaml, в metadata
  annotations:
    "helm.sh/hook": post-install,pre-upgrade
    "helm.sh/hook-delete-policy": before-hook-creation

Теперь Helm запустит миграцию после первой установки и перед каждым обновлением и дождётся её конца.

Шаг 4. Значения стенда

В каталоге чартов создай файл отличий для учебной среды.

ubuntu@stand:~$
cd ~/infra/helm
nano values-lab.yaml
config:
  logLevel: debug

Всего одно отличие от умолчаний — больше подробностей в логах. Остальное чарт берёт из своего values.yaml.

Шаг 5. Установить

Поставь чарт релизом provision с файлом отличий.

ubuntu@stand:~$
helm install provision ./provision -f values-lab.yaml
ubuntu@stand:~$
NAME: provision
NAMESPACE: provision
STATUS: deployed
REVISION: 1

Флаг -f подкладывает файл значений. Команда думает дольше, чем у podinfo: Helm ждёт, пока хук миграции завершится, а миграция ждёт, пока поднимется база. Минута-две — нормально.

Шаг 6. Релиз в списке

Посмотри, что стоит в пространстве.

ubuntu@stand:~$
helm list
ubuntu@stand:~$
NAME        NAMESPACE   REVISION   STATUS     CHART             APP VERSION
provision   provision   1          deployed   provision-0.1.0   1.0.0

Колонки CHART и APP VERSION взяты из твоего Chart.yaml.

Шаг 7. Поды релиза

Проверь кластер обычным kubectl.

ubuntu@stand:~$
kubectl get pods
ubuntu@stand:~$
NAME                                   READY   STATUS      RESTARTS   AGE
provision-provision-6d8f9b7c5-4hx2k    1/1     Running     0          90s
provision-provision-6d8f9b7c5-m8wqp    1/1     Running     0          90s
provision-provision-6d8f9b7c5-tz6rn    1/1     Running     0          90s
provision-provision-db-0               1/1     Running     0          90s
provision-provision-migrate-2xk7d      0/1     Completed   0          40s

Имена собраны шаблоном provision.fullname: релиз плюс чарт. Completed у миграции — разовая задача отработала. Если рядом есть её поды в Error — это первые попытки, пока база поднималась.

Шаг 8. Стенд снаружи

Спроси стенд по имени, как в прошлом разделе.

ubuntu@stand:~$
curl -s stand.provision.internal:8090/api/items
ubuntu@stand:~$
{"visits":0}

Ноль визитов: база новая, таблицу создал хук.

Шаг 9. Значение из файла отличий

Проверь, что values-lab.yaml перекрыл умолчание.

ubuntu@stand:~$
kubectl exec deploy/provision-provision -- env | grep LOG
ubuntu@stand:~$
LOG_LEVEL=debug

В values.yaml чарта стоит info, а файл -f его перекрыл — старшинство значений из урока в действии.

Шаг 10. Поменять настройку

Поменяй в values-lab.yaml уровень на warn и обнови релиз.

ubuntu@stand:~$
helm upgrade provision ./provision -f values-lab.yaml
ubuntu@stand:~$
Release "provision" has been upgraded. Happy Helming!
STATUS: deployed
REVISION: 2

Шаг 11. Поды пересоздались сами

Посмотри на возраст подов приложения.

ubuntu@stand:~$
kubectl get pods -l app.kubernetes.io/name=provision
ubuntu@stand:~$
NAME                                  READY   STATUS    RESTARTS   AGE
provision-provision-5c7b8d6f9-8kqzv   1/1     Running   0          15s
provision-provision-5c7b8d6f9-b2nxl   1/1     Running   0          12s
provision-provision-5c7b8d6f9-wr4tm   1/1     Running   0          9s

Флаг -l отбирает поды по метке из _helpers.tpl. Возраст — секунды: поды пересоздались, хотя образ не менялся.

ubuntu@stand:~$
kubectl exec deploy/provision-provision -- env | grep LOG
ubuntu@stand:~$
LOG_LEVEL=warn

Новое значение доехало без rollout restart. Поменялся ConfigMap — поменялась подпись checksum/config в шаблоне пода — Deployment обновил поды. Ловушка прошлого раздела закрыта навсегда.

Шаг 12. Сломать обновление

Теперь ошибка, которую делают в версии при выкате. Допиши в values-lab.yaml несуществующий тег.

values-lab.yaml, в конец
image:
  tag: "9.9.9"

Шаг 13. Неудачное обновление

Обнови релиз. Команда будет думать до пяти минут — столько Helm по умолчанию ждёт хук.

ubuntu@stand:~$
helm upgrade provision ./provision -f values-lab.yaml
ubuntu@stand:~$
Error: UPGRADE FAILED: pre-upgrade hooks failed: timed out waiting for the condition

Пока ждёшь, открой второе окно и выполни kubectl get pods: под миграции висит в ImagePullBackOff — у него тот же образ, — а поды приложения работают как ни в чём не бывало. Хук pre-upgrade не прошёл, и до обновления приложения дело не дошло. Сломанный образ поймала миграция, а не пользователи.

Шаг 14. Что в истории

Посмотри, как Helm записал неудачу.

ubuntu@stand:~$
helm history provision
ubuntu@stand:~$
REVISION   STATUS       CHART             DESCRIPTION
1          superseded   provision-0.1.0   Install complete
2          deployed     provision-0.1.0   Upgrade complete
3          failed       provision-0.1.0   Upgrade "provision" failed: pre-upgrade hooks failed

Ревизия 3 — failed, и причина записана словами. Работающей осталась вторая.

Шаг 15. Откат

Верни релиз ко второй ревизии явно, чтобы состояние стало однозначным.

ubuntu@stand:~$
helm rollback provision 2
ubuntu@stand:~$
Rollback was a success! Happy Helming!
ubuntu@stand:~$
helm list
ubuntu@stand:~$
NAME     	NAMESPACE	REVISION	UPDATED                             	STATUS  	CHART          	APP VERSION
provision	provision	4       	2026-10-02 13:05:41.512309 +0300 MSK	deployed	provision-0.1.0	1.0.0

Ревизия 4 — копия второй с пометкой Rollback to 2 в истории.

Шаг 16. Убрать хвост и починить файл

Под неудачной миграции откат не убирает — хуки живут вне ревизий. Удали его Job.

ubuntu@stand:~$
kubectl delete job provision-provision-migrate
ubuntu@stand:~$
job.batch "provision-provision-migrate" deleted

И главное: удали из values-lab.yaml блок image с тегом 9.9.9. Иначе следующий helm upgrade повторит ту же ошибку — откат поменял кластер, но не файл.

Шаг 17. Своя ветка

Сохрани чарт и файл значений в репозитории — так же, как описания кластера в миссии прошлого раздела: прямой push в main закрыт, работа идёт через ветку и merge request. Перейди в ~/infra и начни ветку от свежего main.

ubuntu@stand:~$
git switch main
git pull
git switch -c helm-stand

Незакоммиченный каталог helm поедет за тобой в новую ветку.

Шаг 18. Коммит и merge request

Теперь сам коммит: добавь каталог в индекс и зафиксируй.

ubuntu@stand:~$
git add helm
git commit -m "helm: стенд чартом, миграция хуком"

Секрета в чарте нет, поэтому коммит безопасен целиком. Для отправки нужен GitLab: как в прошлой миссии, останови кластер (k3d cluster stop stand), запусти GitLab (docker compose -f ~/gitlab/compose.yaml start) и дождись healthy.

ubuntu@stand:~$
git push -u gitlab helm-stand

Открой merge request по ссылке из ответа и слей его. Затем git switch main и git pull, останови GitLab и запусти кластер обратно: k3d cluster start stand. Через минуту стенд снова отвечает — можно сдавать.

Что дальше

Стенд живёт релизом Helm. Остался последний урок раздела — шпаргалка команд и инструменты, которые ставят рядом с Helm почти всегда.

Практика 03+650 XP

Ставить и обновлять приложение релизом Helm, читать его историю и возвращать рабочую ревизию после неудачного обновления.

  • Релиз стенда работает
  • Неудачное обновление было
  • Откат выполнен
  • База поднята чартом
  • Стенд отвечает снаружи
Команда сдачи — выполни на своей машине
команда
helm -n provision list; helm -n provision history provision; kubectl -n provision get pods; curl -s stand.provision.internal:8090/api/items

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.