Provision
—— XP

Релиз: обновление, откат и хуки

теория~7 минут+260 XP

Новая версия выкачена, поды падают, и нужно срочно вернуть то, что работало час назад. С голым kubectl apply из прошлого раздела это вопрос памяти: какой был образ, какие значения, какой коммит. Кластер помнит только то, что стоит сейчас. Helm помнит больше, и в этом уроке ты увидишь, что именно и как этим пользоваться.

Релиз — чарт, который уже поставили в кластер, вместе со всей его историей. Каждая установка, обновление и откат добавляют в неё ревизию с номером, значениями и собранными описаниями. Как в истории правок документа, старое не стирается: откат тоже записывается новой ревизией, «восстановлено из версии 2».

Из этой истории получается список того, что стоит в кластере, журнал выкатов и откат одной командой. А ещё — порядок «сначала миграция, потом приложение», которого не хватало в миссии прошлого раздела.

Жизнь релиза

Всё, что происходит с релизом, — шесть команд. Посмотри на них списком, а в практике ты выполнишь каждую.

ubuntu@stand:~$
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.

.gitlab-ci.yml, кусок задачи выката
  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.

ubuntu@stand:~$
helm history provision
ubuntu@stand:~$
REVISION   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 — и он падает.

ubuntu@stand:~$
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 создаёт в заданный момент и ждёт, пока тот завершится.

templates/25-migrate.yaml, в metadata
  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 upgrade --install
Установить, если релиза нет, иначе обновить. Обычная команда конвейера.
Server-side apply
Применение описаний на стороне API-сервера, который помнит владельца каждого поля. В Helm 4 включено по умолчанию: чужую ручную правку Helm не перетрёт без --force-conflicts. ↩ к тексту
--rollback-on-failure
Ждать готовности и откатить при неудаче. Раньше назывался --atomic.
Хук
Объект, который Helm создаёт в заданный момент установки или обновления и ждёт его завершения. ↩ к тексту
hook-delete-policy
Когда удалять объект хука. before-hook-creation нужен, чтобы Job можно было создать снова.

Что спросят на собеседовании

  • Где Helm хранит историю релиза?
    В кластере, в Secret на каждую ревизию в пространстве релиза. Отдельного сервера нет, поэтому история видна с любой машины с доступом.
  • Обновление через Helm прошло, а приложение лежит. Как так?
    Без --wait или --rollback-on-failure Helm не ждёт готовности подов и отвечает deployed сразу. Смотреть kubectl get pods и откатывать helm rollback.
  • Как выполнить миграцию до обновления приложения?
    Job с аннотацией helm.sh/hook: pre-upgrade и политикой удаления before-hook-creation. Миграция должна быть совместима со старой версией кода.

Что дальше

Теории хватит. В практике ты снимешь стенд, поставленный файлами, поставишь его чартом, увидишь, как правка настроек сама пересоздаёт поды, сломаешь обновление и откатишь его.

Проверь себя+260 XPдве попытки
1
Статус релиза
helm upgrade без флагов ожидания ответил STATUS: deployed. Что это гарантирует?
2
Откат
Что сделает helm rollback provision 2?
3
Неудачное обновление
Зачем в конвейере флаг --rollback-on-failure (раньше --atomic)?
4
Хуки
Как сделать, чтобы миграция базы выполнялась перед каждым обновлением?
ответь на все вопросы, чтобы проверить

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