Зачем форматировать книги воспроизведения Ansible в YAML?
С помощью сборников правил происходит большая часть реальной работы: смена ключей, исправление парка, открытие нужного порта для нужной команды и выполнение этого так, чтобы это можно было отобразить в окне изменений. Боль менеджеров и дежурных по телефону связана не только с синтаксисом YAML; это тихий пропуск. Задача визуально скрыта, условие «когда» трудно увидеть, а выполнение выглядит успешным, хотя оно не сделало того, что ожидал бизнес. Читабельный макет Ansible — это устройство безопасности, подобное маркированным переключателям в серверной комнате, поскольку оно делает намерение видимым до того, как намерение станет видимым для клиента сбоем. Для программистов, которые находятся между ИТ и бизнесом, аккуратный YAML — это способ получить более спокойные рекомендации по изменениям: рецензенты могут видеть блоки, включения и пути сбоя без горизонтальной прокрутки шрифтом, предназначенным для кода, а не для людей. Разочарование от беспорядочных файлов — это проблема культуры: люди используют ярлыки, вставляют фрагменты и надеются, потому что файл кажется враждебным. Проход формата в браузере — это способ сделать работу более удобной для следующего человека, и этим человеком может быть вы в 2 часа ночи, когда уже идет телефонный звонок. Преимущество заключается в более четкой передаче управления, меньшее количество паник при выполнении этой задачи и более короткий путь от «Я думаю, что это сработало» до того, как мы сможем показать это в журналах. Если вы создаете операционную истину в YAML, относитесь к читабельности как к части изменения, а не к второстепенной мысли, и вы потратите меньше времени на выяснение того, кто что имел в виду, и больше времени на результаты, которые бизнес может назвать в предложении. Четкий сценарий не является гарантией, но он является лучшей основой для тех гарантий, которые вас просят дать. Сначала отформатируйте, затем просмотрите, затем запустите и держите Runbook на виду, а не в чьей-то голове. Именно так взрослые команды выполняют обещания, не выжигая людей. Если вы устали от сюрпризов, которые начинаются с небольшого файла, который никто не хочет перечитывать, эта привычка — дешевый шаг к более спокойной неделе.
Как отформатировать Ansible YAML
- Вставьте файл или неисправный блок задач, сохранив имена переменных и ссылки на роли.
- Запустите форматирование, затем еще раз проверьте уровень задачи и отступ модуля, чтобы блоки оставались на один слой глубже родительского, а не «почти» выровнены.
- Проведите пробный прогон в лаборатории перед началом производства и храните записи об идемпотентах там, где их ожидает культура вашей команды.