Шпаргалка · Helm

Helm: чарт, релиз и где он живёт

Как Helm добавляет сущность приложения в Kubernetes

12 мин чтенияОбновлено 12 сентября 2026 г.

О материале

Обновлено 12 сентября 2026 г.

К ролику «Helm: зачем он нужен и что происходит внутри кластера»

Скачать PDF970 КБ Читать шпаргалку

Helm · практика в браузере

От чтения — к своему релизу

Кластер, терминал и проверка — в браузере. Ничего устанавливать не нужно.

1Установить приложение из чарта
2Изменить настройки и обновить релиз
3Откатиться на рабочую версию

9 шагов≈ 15 минутБесплатно

НачатьНачать практику Helm

Сначала — описание практики. Аккаунт понадобится для запуска среды.

Содержание10 разделов

Откуда боль

В Kubernetes нет сущности приложения

Самый скучный сервис в кластере — это Deployment, Service, Ingress, ConfigMap, Secret, HPA и ServiceAccount. Семь объектов, семь файлов. Связь между ними существует только в вашей голове и в имени папки.

Кластер видит семь независимых записей. Что это одно приложение, знаете только вы.

Отсюда копипаста между окружениями. Дев, стейдж и прод — это те же семь файлов в трёх экземплярах, а отличаются в них строк пятнадцать: тег образа, реплики, домен, лимиты.

Отсюда же мусор в неймспейсах. Команды «обновить приложение» нет, есть только apply вот этих файлов. Снесли Deployment, про ConfigMap забыли — он висит год, пока на него случайно не наткнутся.

И чужой софт: ингресс-контроллер или оператор базы ставится копированием двух десятков манифестов, которые вы видите впервые.

чарт

Форма

Шаблоны манифестов плюс значения по умолчанию. Один комплект на все окружения.

Как устроен чарт и как значения доезжают до манифеста

Таблицу можно листать влево и вправо

Слово	Что это	Где лежит
Чарт	пакет: шаблоны, значения по умолчанию и паспорт с именем и версией	в гите или в OCI-реестре
values	файл ответов: сколько реплик, какой тег, какой домен	рядом с чартом или у вас в репозитории стенда
Релиз	чарт, установленный в кластер под своим именем	в кластере: объекты плюс секрет со слепком
Ревизия	номер версии релиза, растёт при каждом upgrade и rollback	в имени секрета: sh.helm.release.v1.web.v3

myapp/

Chart.yaml— паспорт: имя, version чарта, appVersion приложения

values.yaml— значения по умолчанию

charts/— зависимости — чужие чарты подчартами

templates/— шаблоны манифестов

deployment.yaml

service.yaml

_helpers.tpl— именованные куски, чтобы не копировать метки

# templates/deployment.yaml

replicas: {{ .Values.replicaCount }}

image: "{{ .Values.image.repository }}:{{ .Values.image.tag | default .Chart.AppVersion }}"

1values.yaml внутри чарта
умолчания автора
2ваш файл через -f
values-prod.yaml, values-dev.yaml
3--set в командной строке
перебивает всех

Практика: один чарт, рядом values-dev.yaml и values-prod.yaml. Ради этого копипаста и умирает. Обратная сторона зависимостей: чужие values протекают в ваши — подчарт настраивается через ключ с его именем.

Что происходит при helm install и где живёт состояние

1Собрал чарт
подтянул зависимости
2Подставил значения
чарт → -f → --set
3Один большой YAML
всё приложение целиком
4Отправил в кластер
от вашего имени, через API
5Записал слепок
секретом рядом с подами

Helm не хранит ничего у себя. Состояние лежит в самом кластере обычным секретом в том же неймспейсе: тип helm.sh/release.v1, имя sh.helm.release.v1.<релиз>.v<ревизия>. Внутри — чарт, values и отрендеренный манифест, сжатые gzip и закодированные base64.

следствие 1

Helm без кластера не знает ничего

Переставили систему — ничего не потеряли. Дали доступ коллеге — он видит то же самое.

следствие 2

Откат — не пересборка

Предыдущий слепок физически лежит рядом. Rollback достаёт старый экземпляр из архива.

следствие 3

Лимит около мегабайта

Секрет ограничен, и жирный чарт с кучей CRD туда не влезает. Знаменитая боль.

Error: INSTALLATION FAILED: cannot re-use a name that is still in use

Релиз с таким именем уже стоит в этом неймспейсе — install ставит только новое.

Что делать. helm upgrade --install вместо install: команда одинаково работает и в первый раз, и в сотый.

Error: rendered manifests contain a resource that already exists

Объект с таким именем уже есть в кластере, но Helm его не ставил — например, его завели руками.

Что делать. Удалить чужой объект или передать релизу владение метками app.kubernetes.io/managed-by и аннотациями meta.helm.sh.

Подыч

В Helm 2 состояние держал Tiller — серверный компонент с правами почти на всё. Кто дотянулся до Tiller, тот управлял кластером. В Helm 3 его выкинули целиком, клиент ходит в API от вашего имени. Слой убрали, потому что он был дырой.

Команды, которые реально нужны

helm repo add ИМЯ URL && helm repo update

подключить каталог чартов

Когда: один раз перед чужим софтом

helm search repo ИМЯ

найти чарт в подключённых репозиториях

Когда: выбор версии

helm show values ЧАРТ

посмотреть все настройки чарта

Когда: перед первой установкой

helm template РЕЛИЗ ./чарт -f values.yaml

отрендерить YAML локально, не касаясь кластера

Когда: отладка шаблонов

helm install РЕЛИЗ ./чарт -n NS --create-namespace

поставить первый релиз

Когда: неймспейс сам не появится

helm upgrade --install РЕЛИЗ ./чарт -f values.yaml

обновить или поставить, если ещё нет

Когда: CI: команда идемпотентна

helm diff upgrade РЕЛИЗ ./чарт

показать, что изменится в кластере (плагин)

Когда: перед любым upgrade на проде

helm list -A

перечислить релизы во всех неймспейсах

Когда: посмотреть, что вообще стоит

helm status РЕЛИЗ

показать состояние релиза и заметки

Когда: после установки

helm history РЕЛИЗ

лента ревизий

Когда: перед откатом

helm rollback РЕЛИЗ N

вернуть манифест ревизии N новой ревизией

Когда: сломали upgrade

helm get values РЕЛИЗ

с какими значениями стоит

Когда: посмотреть, какие значения заданы

helm uninstall РЕЛИЗ

удалить приложение целиком

Когда: снести приложение целиком

Команда	Что делает	Когда
`helm repo add ИМЯ URL && helm repo update`	подключить каталог чартов	один раз перед чужим софтом
`helm search repo ИМЯ`	найти чарт в подключённых репозиториях	выбор версии
`helm show values ЧАРТ`	посмотреть все настройки чарта	перед первой установкой
`helm template РЕЛИЗ ./чарт -f values.yaml`	отрендерить YAML локально, не касаясь кластера	отладка шаблонов
`helm install РЕЛИЗ ./чарт -n NS --create-namespace`	поставить первый релиз	неймспейс сам не появится
`helm upgrade --install РЕЛИЗ ./чарт -f values.yaml`	обновить или поставить, если ещё нет	CI: команда идемпотентна

Где лежит слепок: kubectl get secret -l owner=helm -A. Посмотреть внутрь — kubectl get secret sh.helm.release.v1.web.v1 -o jsonpath='{.data.release}' | base64 -d | base64 -d | gunzip.

Грабли

1Нажал upgrade на проде, не посмотрев diff
Почему. Upgrade сравнивает три источника, и результат не всегда совпадает с ожиданием — особенно после правок руками.
Что делать. Правило: helm template и helm diff перед апгрейдом. Без diff на прод не жмём.
2Релиз залип в pending-upgrade
Почему. Команду прервали (Ctrl+C, упал CI), и в слепке остался промежуточный статус. Следующий upgrade отказывается работать.
Что делать. Посмотреть helm history, откатиться на последнюю успешную ревизию или снять залипший секрет ревизии.
3--set портит числа и ключи с точками
Почему. Число 3 превращается в строку, а точка в имени ключа разбирается как вложенность.
Что делать. В CI — значения файлами через -f. --set оставить для разовых экспериментов.
4Неймспейс сам не создался
Почему. Helm не заводит неймспейс без флага. И одинаковое имя релиза в разных неймспейсах — это два разных релиза.
Что делать. --create-namespace при install и всегда явный -n.
5CRD не обновились при upgrade
Почему. Helm ставит CRD один раз и не трогает при апгрейде. Это осознанное решение.
Что делать. Обновлять CRD отдельным шагом до upgrade, как рекомендует автор чарта.
6Секреты в values
Почему. values целиком лежат в том самом секрете со слепком, доступном всем, кто читает секреты неймспейса.
Что делать. Секреты — отдельным объектом или внешним менеджером, в values — только ссылка на него.

Проверь себя

1/4

Где Helm хранит информацию о том, что он установил?

2/4

После helm rollback web 1 что покажет helm history web, если до отката было две ревизии?

3/4

Кто побеждает, если один ключ задан и в values.yaml чарта, и в файле через -f, и через --set?

4/4

Что Helm делает с CRD при helm upgrade?

Helm: чарт, релиз и где он живёт

От чтения — к своему релизу

В Kubernetes нет сущности приложения

Три работы Helm

Как устроен чарт и как значения доезжают до манифеста

Что происходит при helm install и где живёт состояние

upgrade и rollback честно

Команды, которые реально нужны

Грабли

Helm 4, судьба Helm 3 и когда Helm не нужен

Как это спрашивают на собеседовании

Проверь себя