Экспорт повторно используемых именованных шаблонов

Библиотечный чарт поставляет свою ценность в виде именованных шаблонов. Вы создаёте их с помощью define, как и в любом файле _helpers.tpl.

Имена шаблонов являются глобальными для чарта и его зависимостей. Добавляйте к ним префикс с именем библиотеки, например common.labels, чтобы избежать конфликтов.

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

Пустой блок define ничего не создаёт при визуализации чарта. Шаблон выводит текст только тогда, когда позже его подключает другой чарт.

Вы можете определить целый объект Kubernetes как один именованный шаблон. Затем потребители визуализируют полный Service одним вызовом include.

Внутри частичного шаблона точка содержит всё, что передал вызывающий код. Обращение к .Values и .Release позволяет шаблону адаптироваться к каждому использующему его чарту.

Поскольку частичные шаблоны доверяют своим входным данным, оставьте комментарий с указанием необходимого им контекста. Если потребитель передаст неправильную точку, возникнут непонятные ошибки.

Разделяйте логику на небольшие целевые частичные шаблоны: один для имён, другой для меток, третий для селекторов. Небольшие части легко объединять в разных чартах.

Обрамляйте define и end маркерами дефисов, например {{- и -}}, чтобы вывод библиотеки не добавлял лишние пустые строки в YAML потребителя.

Определение шаблона делает его доступным, но не активирует его. Он добавляет вывод только тогда, когда чарт приложения вызывает для него include или template.

Набор частичных шаблонов, таких как common.fullname и common.labels, становится общим словарём, на котором может строиться каждый командный чарт.

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