Синтаксис действий с двойными фигурными скобками

Чарты Helm — это не обычный YAML. Это шаблоны: обычный YAML, дополненный небольшими фрагментами логики, которые Helm заполняет за Вас. ✨

Каждая директива шаблона находится между двумя фигурными скобками. Пара {{ }} открывает путь от статического YAML к движку шаблонов Helm.

Всё, что находится между скобками, называется действием. Helm вычисляет его во время рендеринга и подставляет результат обратно в YAML.

Самое простое действие просто выводит значение. Здесь Helm заменяет действие именем релиза перед применением manifest.

Начальная точка — это контекст: объект верхнего уровня, содержащий всё, что известно Helm. Переходите внутрь с помощью дополнительных точек, например .Release.Name.

Пробелы внутри скобок — лишь вопрос стиля. {{ .Chart.Name }} и {{.Chart.Name}} дают одинаковый результат. По соглашению Helm для удобства чтения предпочитают форму с пробелами.

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

Другие действия ничего не выводят. Ключевые слова вроде if и range управляют рендерингом, определяя, появится блок или будет повторён.

Весь этот синтаксис происходит из движка Go text/template. Helm добавляет поверх него дополнительные функции, но основа {{ }} полностью принадлежит Go.

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

Выполните helm template и наблюдайте, как каждое действие исчезает, заменяясь вычисленным значением. Именно этот результат поступает в Kubernetes.

Вы заметили {{ .Release.Name }} в шаблоне чарта.

Теперь Вы знаете основной синтаксис: {{ }} обозначает действие, точка — корневой контекст, а всё за пределами скобок выводится без изменений. 🎯