Helm не редактирует готовый Deployment построчно. При upgrade он снова рендерит chart из набора values, а затем применяет получившиеся manifests. Настройка пропадает, когда ключ больше не попадает в итоговый набор, переименован в новой версии chart или перекрыт файлом и флагом с более высоким приоритетом.

Не запускайте ещё один upgrade «с теми же флагами» по памяти. Сначала сохраните release history, пользовательские values, computed values и текущие объекты Kubernetes. Секреты выводите только в защищённый файл или исключайте из диагностического пакета.

Четыре представления отвечают на разные вопросы

ПредставлениеКоманда или файлЧто показывает
Defaults chartvalues.yaml новой версииЗначения автора chart
Release overrideshelm get values RELEASEПереданные пользователем values
Computed valueshelm get values RELEASE --allИтог с defaults текущего release
Rendered manifestshelm template или upgrade --dry-runЧто уйдёт в Kubernetes
Live objectkubectl get ... -o yamlФактическое состояние после контроллеров

Если ключ есть в release overrides, но отсутствует в rendered manifest, изменился template или схема chart. Если он уже отсутствует в overrides, pipeline перестал передавать values-файл или использовал другой release/namespace. Если manifest верен, а live object другой, ищите mutating controller или второй reconciler.

Снимок делается до нового рендера

helm -n production history myapp
helm -n production get values myapp -o yaml > supplied-values.yaml
helm -n production get values myapp --all -o yaml > computed-values.yaml

helm upgrade myapp ./chart -n production \
  -f production-values.yaml \
  --dry-run --hide-secret > rendered-preview.txt

Helm предупреждает, что dry-run может вывести Kubernetes Secrets; флаг --hide-secret уменьшает риск, но лог всё равно рассматривайте как чувствительный артефакт. Не прикладывайте generated manifests целиком к публичной задаче.

Приоритет values идёт справа и сверху

При нескольких -f последний файл имеет приоритет. Для повторяющихся --set побеждает правое значение. Ошибка часто появляется, когда общий production файл передан после локального override или CI добавил --set key= с пустым значением. Сохраните финальную команду без секретов как часть release metadata.

  • Имя release и namespace всегда указываются явно.
  • Файлы values версионируются вместе с окружением.
  • Пустое значение отличается от отсутствующего ключа.
  • Переименование key в chart сопровождается миграцией values.
  • Список --set не используется для больших вложенных структур.

reuse-values — режим, а не страховка

--reuse-values берёт values предыдущего release и объединяет их с новыми overrides. Это помогает сохранить старые настройки, но способно протащить удалённые или несовместимые ключи в новую major-версию chart. --reset-values, наоборот, начинает с defaults новой версии. Выбор фиксируют в upgrade-плане после чтения chart changelog.

Не смешивайте эти режимы случайно между ручным запуском и CI. Надёжнее иметь полный production-values.yaml и проверять его против схемы chart, если chart публикует values.schema.json.

Diff проверяет не только Deployment

Настройка может находиться в ConfigMap, Secret, StatefulSet, Ingress или hook Job. Сравнивайте весь набор rendered resources и отдельно поля, которые нельзя безопасно менять после создания. Для PVC, immutable selectors и миграционных hooks простой rollback может не вернуть прежнее состояние данных.

Откат начинается с revision и совместимости

  1. Найти последнюю успешную revision в helm history.
  2. Сравнить chart version и values проблемного и рабочего релиза.
  3. Проверить, не изменилась ли схема базы или постоянный том.
  4. Выполнить rollback в тестовом окружении или dry-run доступным способом.
  5. Наблюдать Ready, события и версию приложения после отката.
  6. Зафиксировать исправленный values source до следующего upgrade.

Пакет для разбора остаётся без Secret

Достаточно chart version, revision history, обезличенного values diff, команды upgrade и фрагментов rendered resources для пропавших ключей. Secret data, registry credentials и полный env удалите. По этим материалам можно восстановить приоритет и точку потери настройки.

Проверенные источники