Новая версия выкачена, поды падают, и нужно срочно вернуть то, что работало час назад. С голым kubectl apply из прошлого раздела это вопрос памяти: какой был образ, какие значения, какой коммит. Кластер помнит только то, что стоит сейчас. Helm помнит больше, и в этом уроке ты увидишь, что именно и как этим пользоваться.
Релиз — чарт, который уже поставили в кластер, вместе со всей его историей. Каждая установка, обновление и откат добавляют в неё ревизию с номером, значениями и собранными описаниями. Как в истории правок документа, старое не стирается: откат тоже записывается новой ревизией, «восстановлено из версии 2».
Из этой истории получается список того, что стоит в кластере, журнал выкатов и откат одной командой. А ещё — порядок «сначала миграция, потом приложение», которого не хватало в миссии прошлого раздела.
Жизнь релиза
Всё, что происходит с релизом, — шесть команд. Посмотри на них списком, а в практике ты выполнишь каждую.
helm install provision ./provision # первая установка helm upgrade provision ./provision # новая ревизия helm list # что стоит в пространстве helm history provision # ревизии релиза helm rollback provision 2 # вернуть ревизию 2 helm uninstall provision # удалить релиз и его объекты
Сначала имя релиза, потом путь к чарту — каталогу или имени из репозитория. В конвейерах вместо пары install и upgrade пишут одну команду helm upgrade --install: флаг --install ставит релиз, если его ещё нет, и обновляет, если есть.
Историю Helm хранит не у себя, а в кластере: на каждую ревизию — обычный Secret с именем вида sh.helm.release.v1.provision.v3 в пространстве релиза. Поэтому helm list с любой машины с тем же kubeconfig показывает одно и то же, а удалить пространство имён — значит потерять и историю.
deployed ещё не значит «работает»
Здесь главная ловушка новичка. По умолчанию helm upgrade отдаёт описания кластеру и сразу отвечает STATUS: deployed — не дожидаясь, поднялись ли поды.
Поставишь несуществующий тег образа — Helm честно ответит deployed, а в кластере новые поды повиснут в ImagePullBackOff. Старые при этом продолжат работать, как ты видел в практике с Deployment, и упавший выкат можно не заметить. Поэтому после ручного обновления проверяют kubectl get pods или kubectl rollout status.
В конвейере ждать готовности просят флагом. Длинная команда здесь живёт не в терминале, а в файле .gitlab-ci.yml из раздела 12.
script: - helm upgrade --install provision ./helm/provision -f helm/values-prod.yaml --set image.tag=$CI_COMMIT_SHORT_SHA --rollback-on-failure --timeout 5m
--rollback-on-failure заставляет Helm ждать готовности всех объектов, а не дождавшись за --timeout, — вернуть прошлую ревизию. В Helm 3 и в статьях до 2026 года этот флаг называется --atomic, в Helm 4 старое имя ещё работает, но выдаёт предупреждение. Тег образа здесь передаётся через --set — это то единственное значение, которое меняется каждый выкат.
Откат
Если обновление неудачное, прошлую ревизию возвращают одной командой с номером из helm history.
helm history provisionREVISION STATUS DESCRIPTION 1 superseded Install complete 2 superseded Upgrade complete 3 deployed Upgrade complete
helm rollback provision 2 применит описания второй ревизии и запишет это четвёртой с пометкой Rollback to 2. Без номера Helm вернёт предыдущую. Помни про файлы: откат меняет кластер, а в values-lab.yaml останется то, что сломало выкат, — следующий upgrade повторит ошибку, если не поправить файл. Это то же правило «сначала аварийная команда, потом файл», что с kubectl rollout undo.
Правка мимо Helm
Типичная история: ночью нагрузка выросла, и дежурный быстро добавил копий командой kubectl scale deploy … --replicas=3. Утром ты делаешь обычный helm upgrade — и он падает.
Error: UPGRADE FAILED: conflict occurred while applying object provision/demo-podinfo apps/v1, Kind=Deployment: Apply failed with 1 conflict: conflict with "kubectl" with subresource "scale" using apps/v1: .spec.replicasЭто поведение Helm 4. Он применяет описания на стороне сервера (server-side apply): API-сервер помнит, какая программа каким полем объекта владеет, — это видно в kubectl get … --show-managed-fields. Поле replicas теперь числится за kubectl, и Helm отказывается молча перетирать чужую правку. Helm 3 перетёр бы её без вопросов.
Выходов два. Если ручная правка была временной — повторить upgrade с флагом --force-conflicts, и Helm заберёт поле себе. Если правильная — перенести её в файл значений, а потом всё равно --force-conflicts. Главный вывод старый: объект, которым управляет Helm, руками не правят. Ручная правка — авария, после неё файл и кластер надо помирить.
Хуки: миграция перед обновлением
В Kubernetes нет порядка «сначала это, потом то». В миссии прошлого раздела миграция просто повторяла попытки, пока база не поднимется, и запускалась только один раз — Job нельзя применить повторно с новым образом.
Helm добавляет порядок хуками: объект с особой аннотацией Helm создаёт в заданный момент и ждёт, пока тот завершится.
annotations: "helm.sh/hook": post-install,pre-upgrade "helm.sh/hook-delete-policy": before-hook-creation
post-install — выполнить после первой установки, когда база уже создана: перед ней базы ещё нет, и миграции некуда идти. pre-upgrade — перед каждым обновлением, пока работает старая версия. Упала миграция — обновление не начнётся. before-hook-creation удаляет прошлый Job перед созданием нового: без этого второе обновление упадёт с ошибкой already exists.
Одно следствие стоит запомнить. Хук pre-upgrade выполняется, пока работает старая версия приложения, значит миграция обязана быть с ней совместима: добавлять колонки можно, переименовывать и удалять — только в следующем выкате. Это требование ты встречал в разделе 12 про CI/CD, здесь оно становится обязательным.
Есть и другие моменты для хуков: pre-install, post-upgrade, pre-delete — например, снять резервную копию перед удалением релиза. Пока достаточно знать, что они есть.
Словарь урока
Что спросят на собеседовании
- Где Helm хранит историю релиза?В кластере, в Secret на каждую ревизию в пространстве релиза. Отдельного сервера нет, поэтому история видна с любой машины с доступом.
- Обновление через Helm прошло, а приложение лежит. Как так?Без --wait или --rollback-on-failure Helm не ждёт готовности подов и отвечает deployed сразу. Смотреть kubectl get pods и откатывать helm rollback.
- Как выполнить миграцию до обновления приложения?Job с аннотацией helm.sh/hook: pre-upgrade и политикой удаления before-hook-creation. Миграция должна быть совместима со старой версией кода.
Что дальше
Теории хватит. В практике ты снимешь стенд, поставленный файлами, поставишь его чартом, увидишь, как правка настроек сама пересоздаёт поды, сломаешь обновление и откатишь его.