Красиво печатайте, проверяйте и инспектируйте YAML-документы с необязательной сортировкой ключей и управлением раскрытием якорей/псевдонимов.
Красиво печатайте, проверяйте и инспектируйте YAML-документы с необязательной сортировкой ключей и управлением раскрытием якорей/псевдонимов. Красиво печатайте, проверяйте и инспектируйте YAML-документы с необязательной сортировкой ключей и управлением раскрытием якорей/псевдонимов.
YAML («YAML Ain't Markup Language») — удобный для человека формат сериализации данных, широко используемый для файлов конфигурации (docker-compose.yml, манифесты Kubernetes, рабочие процессы GitHub Actions, плейбуки Ansible и др.). Он меняет строгость JSON на структуру на основе отступов и более богатую систему типов, которая включает даты, многострочные строки и ссылки.
Поскольку YAML полагается на отступы для выражения вложенности, пропущенный пробел может изменить смысл всего документа, а большинство редакторов не выделяют иерархию визуально. Просмотрщик разбирает документ и переиздаёт его с согласованным отступом, вскрывая ошибки отступов одновременно с раскрытием структуры.
Большинство просмотрщиков позволяют переключать несколько режимов: сортировать ключи по алфавиту для устойчивых diff, раскрывать или удалять якоря и псевдонимы YAML (синтаксис & / *) и выбирать ширину отступа. Опция сортировки особенно ценна при сравнении двух снимков одной и той же конфигурации — без неё перестановка ключей между выпусками может скрыть реальные изменения.
Статистика по количеству байтов и корневым ключам помогает увидеть, насколько тяжёл документ и где находится основной объём. Если вам нужно знать, помещается ли ваш YAML в лимит переменной окружения или в бюджет размера ConfigMap, эта цифра прямо перед вами.
При отладке ошибки разбора скопируйте документ в новую вкладку просмотрщика и переключайте параметры по одному: синтаксис &anchor может выглядеть как опечатка, пока вы не увидите его раскрытым. Для очень длинных конвейеров используйте отступ в 4 пробела, чтобы соответствовать распространённым руководствам по стилю; для встроенного просмотра или вставки в чат 2 пробела компактнее. Всегда сохраняйте исходную структуру документа при фиксации конфигурации: просмотрщик предназначен для инспекции, а не для нормализации.