Helm не редактирует готовый Deployment построчно. При upgrade он снова рендерит chart из набора values, а затем применяет получившиеся manifests. Настройка пропадает, когда ключ больше не попадает в итоговый набор, переименован в новой версии chart или перекрыт файлом и флагом с более высоким приоритетом.
Не запускайте ещё один upgrade «с теми же флагами» по памяти. Сначала сохраните release history, пользовательские values, computed values и текущие объекты Kubernetes. Секреты выводите только в защищённый файл или исключайте из диагностического пакета.
Четыре представления отвечают на разные вопросы
| Представление | Команда или файл | Что показывает |
|---|---|---|
| Defaults chart | values.yaml новой версии | Значения автора chart |
| Release overrides | helm get values RELEASE | Переданные пользователем values |
| Computed values | helm get values RELEASE --all | Итог с defaults текущего release |
| Rendered manifests | helm template или upgrade --dry-run | Что уйдёт в Kubernetes |
| Live object | kubectl 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.txtHelm предупреждает, что 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 и совместимости
- Найти последнюю успешную revision в helm history.
- Сравнить chart version и values проблемного и рабочего релиза.
- Проверить, не изменилась ли схема базы или постоянный том.
- Выполнить rollback в тестовом окружении или dry-run доступным способом.
- Наблюдать Ready, события и версию приложения после отката.
- Зафиксировать исправленный values source до следующего upgrade.
Пакет для разбора остаётся без Secret
Достаточно chart version, revision history, обезличенного values diff, команды upgrade и фрагментов rendered resources для пропавших ключей. Secret data, registry credentials и полный env удалите. По этим материалам можно восстановить приоритет и точку потери настройки.