Передача области видимости в именованный шаблон

Именованный шаблон может прочитать только то, что Вы ему передали. Второй аргумент include — это область видимости, которую частичный шаблон увидит внутри.

Последняя точка — это текущий контекст. Передача корневой точки даёт частичному шаблону доступ к .Values, .Release и .Chart.

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

Большинство помощников ожидают полный контекст диаграммы, поэтому им передают обычную точку. Это безопасный вариант по умолчанию, благодаря которому стандартные помощники работают правильно.

Иногда частичному шаблону нужна только одна часть значений. Вы можете передать ему поддерево, чтобы его точка указывала именно на этот фрагмент.

Когда Вы передаёте .Values.service, точка частичного шаблона теперь указывает на этот объект. Он обращается непосредственно к .port, а не к .Values.service.port.

Сужение области видимости удобно, но лишает Вас доступа к .Release и глобальным значениям. Частичный шаблон видит только переданный ему объект.

Нужно передать и поддерево, и корень? Создайте небольшой dict и передайте его, а затем обращайтесь внутри частичного шаблона к каждой части по её ключу.

Внутри частичного шаблона распакуйте dict по ключам. Теперь у Вас одновременно есть корень через .top и поддерево через .svc.

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

Выполните helm template . и убедитесь, что частичный шаблон выдаёт заполненный результат. Пустые поля обычно означают, что частичному шаблону передали неправильную область видимости.

Аргумент после имени частичного шаблона задаёт его точку. Передайте корневую точку, поддерево или dict, чтобы объединить оба значения. Неправильная область видимости приводит к пустому результату. 🎯