Условные блоки с if и else

Иногда ресурс должен появляться только по запросу пользователя. Helm позволяет обернуть этот YAML в условие, чтобы выводить его по требованию.

Блок if начинается с {{ if SOMETHING }} и завершается {{ end }}. Всё между ними выводится только тогда, когда условие истинно.

Обычно условием служит значение, заданное пользователем. Установите ingress.enabled в true в values.yaml — и обёрнутый манифест сразу появится.

Каждый if должен иметь соответствующий {{ end }}. Если его забыть, при попытке отрендерить диаграмму Helm выдаст ошибку незавершённого блока.

Нужен запасной вариант? Добавьте ветвь {{ else }}. Если условие истинно, Helm выводит первый блок, а в противном случае — ветвь else.

Для нескольких случаев объединяйте условия с помощью {{ else if }}. Helm проверяет их по порядку и выводит первую ветвь с истинным условием.

Условие if считается истинным, если значение не является пустым: false, ноль, пустая строка и пустой список в условии считаются ложными.

Распространённый шаблон оборачивает одно необязательное поле, а не весь ресурс. Здесь аннотация выводится только тогда, когда пользователь указал для неё значение.

Блок if оставляет пустые строки там, где раньше находилось действие. Эти пробельные символы могут нарушить YAML, поэтому скоро Вы научитесь их удалять. 🧹

Выполните рендеринг с разными значениями и посмотрите, какая ветвь сработает. Используйте helm template с параметром --set, чтобы проверить каждое условие ещё до развёртывания.

Если пользователь никогда не задаёт флаг, он считается пустым, и условие if остаётся ложным. Поэтому диаграммы содержат разумное значение по умолчанию для него в values.yaml.

Вы пишете {{ if .Values.cache }}, но диаграмма не удаётся отрендерить.

Теперь Вы умеете управлять выводом YAML с помощью if, добавлять ветви else и else if и не забывать закрывающий {{ end }}. Условный рендеринг освоен! 🎯