Helm Academy · Урок

Files, Template и корневой контекст

Обращайтесь к включённым файлам и области видимости точки

Урок 4 из 413 шагов

«Files, Template и корневой контекст» — бесплатный урок Helm Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Helm Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Helm Academy содержит 4 уроков всего.

Корневой контекст: точка

В начале шаблона точка . — это корневой контекст, содержащий все встроенные объекты: .Values, .Release, .Chart и другие.

Точка может менять область видимости

Такие блоки, как with и range, переназначают точку, связывая её с более узким значением. Поэтому внутри каждого блока . не всегда означает корневой контекст.

Переход к корню с помощью доллара

Переменная $ всегда указывает на исходный корневой контекст. Внутри range или with используйте $, чтобы снова получить доступ к .Values или .Release.

{{ range .Values.ports }}
release: {{ $.Release.Name }}
{{ end }}

Объект Files

.Files позволяет шаблонам читать не являющиеся шаблонами файлы, включённые в чарт, например файл конфигурации, который нужно поместить внутрь ConfigMap. 📄

Чтение файла как текста

.Files.Get возвращает содержимое файла в виде строки. Передайте путь относительно корня чарта, чтобы добавить файл в манифест.

data:
  app.conf: |
{{ .Files.Get "config/app.conf" | indent 4 }}

У Files есть ограничения

.Files не может читать всё: templates/ и Chart.yaml исключены, а шаблоны .helmignore пропускаются при упаковке.

Поиск нескольких файлов по шаблону

.Files.Glob находит несколько файлов по шаблону и возвращает карту, по которой можно пройти с помощью range, чтобы сразу создать множество записей ConfigMap.

{{ range $path, $bytes := .Files.Glob "config/*" }}...{{ end }}

Кодирование содержимого файлов

Двоичные данные и секреты следует кодировать в base64. Объедините .Files.Get с b64enc, чтобы безопасно встроить данные в ресурс Secret.

ca.crt: {{ .Files.Get "certs/ca.crt" | b64enc }}

Объект Template

Объект .Template описывает обрабатываемый файл. Путь к нему содержится в .Template.Name; это полезно в комментариях и сообщениях об ошибках.

# rendered from {{ .Template.Name }}

BasePath указывает на templates

.Template.BasePath возвращает путь к каталогу шаблонов обрабатываемого чарта. Вместе с .Template.Name он помогает определить расположение текущего файла.

Передача корневого контекста вспомогательным шаблонам

Именованные шаблоны видят только тот контекст, который вы им передали. Передача $ или корневой точки гарантирует, что вспомогательный шаблон по-прежнему сможет обратиться к .Values и .Release.

{{ include "mychart.labels" $ }}

Быстрая проверка

Вы находитесь внутри цикла range, где точка была переназначена на элемент списка.

Ответь в интерактивном уроке

Повторение: файлы и корневой контекст

Вы узнали, что точка — это корневой контекст, $ всегда позволяет обратиться к нему, а .Files и .Template позволяют встраивать файлы из пакета и находить текущий шаблон.

Можно начать бесплатно

Изучай YAML с ИИ-репетитором — бесплатно

Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.

Курсы: 30
Уроки: 120

Начать учиться бесплатно Посмотреть полный курс

Часто задаваемые вопросы

Урок «Files, Template и корневой контекст» бесплатный?

Да — полный текст урока «Files, Template и корневой контекст» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Helm Academy, подпишись на CoddyKit PRO. Курс Helm Academy содержит 4 уроков всего.

Чему я научусь в уроке «Files, Template и корневой контекст»?

Обращайтесь к включённым файлам и области видимости точки Ты практикуешь Helm Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Helm Academy?

Предыдущий опыт не требуется. Helm Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «Files, Template и корневой контекст»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Helm Academy?

Да. Каждый урок Helm Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Helm Academy