Чарт собран и проверен локально. Теперь он заменит каталог описаний: стенд, поставленный командой kubectl apply, ты снимешь целиком и поставишь заново как релиз Helm — с историей, хуком миграции и откатом.
Работать будешь из каталога ~/infra/helm, где лежит чарт.
Шаг 1. Снять стенд, поставленный файлами
Helm не знает об объектах, которые создавались без него, и откажется ставить поверх них. Удали стенд тем же каталогом, которым его ставил.
kubectl delete -f ~/infra/k8s/base/namespace "provision" deleted configmap "provision-config" deleted secret "provision-secrets" deleted service "provision-db" deleted statefulset.apps "provision-db" deleted ...
Пространство имён удалилось вместе со всем, что в нём было, включая диск базы. На стенде это нормально, на проде так не делают никогда.
Шаг 2. Пространство и секрет
Пространство и секрет чарт не создаёт — верни их файлами.
kubectl apply -f ~/infra/k8s/base/00-namespace.yamlnamespace/provision createdkubectl apply -f ~/infra/k8s/base/11-secret.yamlsecret/provision-secrets createdШаг 3. Миграция хуком
Открой nano ~/infra/helm/provision/templates/25-migrate.yaml и добавь в metadata аннотации хука — на уровне name.
annotations: "helm.sh/hook": post-install,pre-upgrade "helm.sh/hook-delete-policy": before-hook-creation
Теперь Helm запустит миграцию после первой установки и перед каждым обновлением и дождётся её конца.
Шаг 4. Значения стенда
В каталоге чартов создай файл отличий для учебной среды.
cd ~/infra/helmconfig: logLevel: debug
Всего одно отличие от умолчаний — больше подробностей в логах. Остальное чарт берёт из своего values.yaml.
Шаг 5. Установить
Поставь чарт релизом provision с файлом отличий.
helm install provision ./provision -f values-lab.yamlNAME: provision NAMESPACE: provision STATUS: deployed REVISION: 1
Флаг -f подкладывает файл значений. Команда думает дольше, чем у podinfo: Helm ждёт, пока хук миграции завершится, а миграция ждёт, пока поднимется база. Минута-две — нормально.
Шаг 6. Релиз в списке
Посмотри, что стоит в пространстве.
helm listNAME NAMESPACE REVISION STATUS CHART APP VERSION provision provision 1 deployed provision-0.1.0 1.0.0
Колонки CHART и APP VERSION взяты из твоего Chart.yaml.
Шаг 7. Поды релиза
Проверь кластер обычным kubectl.
kubectl get podsNAME 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. Стенд снаружи
Спроси стенд по имени, как в прошлом разделе.
curl -s stand.provision.internal:8090/api/items{"visits":0}Ноль визитов: база новая, таблицу создал хук.
Шаг 9. Значение из файла отличий
Проверь, что values-lab.yaml перекрыл умолчание.
kubectl exec deploy/provision-provision -- env | grep LOGLOG_LEVEL=debugВ values.yaml чарта стоит info, а файл -f его перекрыл — старшинство значений из урока в действии.
Шаг 10. Поменять настройку
Поменяй в values-lab.yaml уровень на warn и обнови релиз.
helm upgrade provision ./provision -f values-lab.yamlRelease "provision" has been upgraded. Happy Helming! STATUS: deployed REVISION: 2
Шаг 11. Поды пересоздались сами
Посмотри на возраст подов приложения.
kubectl get pods -l app.kubernetes.io/name=provisionNAME 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. Возраст — секунды: поды пересоздались, хотя образ не менялся.
kubectl exec deploy/provision-provision -- env | grep LOGLOG_LEVEL=warnНовое значение доехало без rollout restart. Поменялся ConfigMap — поменялась подпись checksum/config в шаблоне пода — Deployment обновил поды. Ловушка прошлого раздела закрыта навсегда.
Шаг 12. Сломать обновление
Теперь ошибка, которую делают в версии при выкате. Допиши в values-lab.yaml несуществующий тег.
image: tag: "9.9.9"
Шаг 13. Неудачное обновление
Обнови релиз. Команда будет думать до пяти минут — столько Helm по умолчанию ждёт хук.
helm upgrade provision ./provision -f values-lab.yamlError: UPGRADE FAILED: pre-upgrade hooks failed: timed out waiting for the conditionПока ждёшь, открой второе окно и выполни kubectl get pods: под миграции висит в ImagePullBackOff — у него тот же образ, — а поды приложения работают как ни в чём не бывало. Хук pre-upgrade не прошёл, и до обновления приложения дело не дошло. Сломанный образ поймала миграция, а не пользователи.
Шаг 14. Что в истории
Посмотри, как Helm записал неудачу.
helm history provisionREVISION 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. Откат
Верни релиз ко второй ревизии явно, чтобы состояние стало однозначным.
helm rollback provision 2Rollback was a success! Happy Helming!helm listNAME 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.
kubectl delete job provision-provision-migratejob.batch "provision-provision-migrate" deletedИ главное: удали из values-lab.yaml блок image с тегом 9.9.9. Иначе следующий helm upgrade повторит ту же ошибку — откат поменял кластер, но не файл.
Шаг 17. Своя ветка
Сохрани чарт и файл значений в репозитории — так же, как описания кластера в миссии прошлого раздела: прямой push в main закрыт, работа идёт через ветку и merge request. Перейди в ~/infra и начни ветку от свежего main.
git switch main git pull git switch -c helm-stand
Незакоммиченный каталог helm поедет за тобой в новую ветку.
Шаг 18. Коммит и merge request
Теперь сам коммит: добавь каталог в индекс и зафиксируй.
git add helm git commit -m "helm: стенд чартом, миграция хуком"
Секрета в чарте нет, поэтому коммит безопасен целиком. Для отправки нужен GitLab: как в прошлой миссии, останови кластер (k3d cluster stop stand), запусти GitLab (docker compose -f ~/gitlab/compose.yaml start) и дождись healthy.
git push -u gitlab helm-standОткрой merge request по ссылке из ответа и слей его. Затем git switch main и git pull, останови GitLab и запусти кластер обратно: k3d cluster start stand. Через минуту стенд снова отвечает — можно сдавать.
Что дальше
Стенд живёт релизом Helm. Остался последний урок раздела — шпаргалка команд и инструменты, которые ставят рядом с Helm почти всегда.