nindent и indent на практике

YAML использует пробелы для обозначения структуры, поэтому блок, вставленный на неправильной глубине, ломает файл. Helm предоставляет вспомогательные функции, чтобы правильно добавлять отступы к indent выводу.

Функция indent добавляет фиксированное число пробелов в начало каждой строки строкового значения, сдвигая весь блок вправо.

Вот важный нюанс: indent сдвигает каждую строку, но не добавляет начальную новую строку. Первая строка оказывается прямо там, где расположен вызов.

Функция nindent делает то же самое с отступами, но сначала выводит новую строку, поэтому блок аккуратно начинается с отдельной строки.

Начальная новая строка, которую добавляет nindent, избавляет вас от необходимости оставлять пробел в конце и наугад подбирать выравнивание после ключа в той же строке.

Чаще всего nindent используется при размещении блока toYaml под ключом: так отрендеренная карта аккуратно располагается под ключом.

Выбирайте число, считая пробелы от родительского ключа, а не от нулевого столбца. Вложенному на два уровня дочернему элементу обычно нужен nindent 4.

Обычный indent подходит, когда блок уже начинается с отдельной строки и перед ним не нужно добавлять дополнительную новую строку.

Большинство уровней вложенности YAML увеличивается на два пробела. Ошибка в подсчёте nindent на два пробела — главная причина, по которой чарт не удаётся разобрать.

Не угадывайте глубину. Запустите helm template и изучите необработанный вывод, чтобы убедиться, что вставленный блок выровнен относительно родительского ключа.

Обе функции получают строку из конвейера слева, поэтому они естественно сочетаются с toYaml для форматирования целой карты в манифесте.

Вы пишете {{ toYaml .Values.env | indent 4 }} сразу после ключа в той же строке, и YAML становится некорректным.

Теперь вы знаете, что indent добавляет отступы к блоку, nindent сначала добавляет новую строку, а рендеринг — самый надёжный способ проверить глубину. 🧹