Пользовательские проверки с модулем fail
Остановите плейбук понятным сообщением
«Пользовательские проверки с модулем fail» — бесплатный урок DevOps Bootcamp на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения DevOps Bootcamp, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс DevOps Bootcamp содержит 4 уроков всего.
Остановите выполнение понятным сообщением
Иногда нужно намеренно остановить плей с полезным пояснением причины. Модуль fail делает именно это. 🛑
Модуль fail
ansible.builtin.fail останавливает выполнение на текущем узле и выводит написанное Вами сообщение вместо непонятной ошибки.
- name: Refuse unsupported OS
ansible.builtin.fail:
msg: "This playbook supports Ubuntu only"Условное выполнение fail с помощью when
Обычный fail всегда останавливает выполнение, поэтому объединяйте его с when. Плей завершается сбоем только при выполнении заданного Вами условия.
- ansible.builtin.fail:
msg: "app_version is required"
when: app_version is not definedЗавершайте выполнение быстро и заранее
Размещайте проверки в начале плейбука. Раннее обнаружение неверных входных данных early лучше, чем сбой в середине развёртывания.
Модуль assert
ansible.builtin.assert удобнее для проверки: передайте ему условия в параметре that, и он завершит задачу сбоем, если какое-либо условие ложно.
- ansible.builtin.assert:
that:
- app_port is defined
- app_port | int > 1024Пользовательские сообщения assert
Добавьте к assert параметры fail_msg и success_msg, чтобы получать понятный вывод при любом результате. Ясная обратная связь при каждом запуске.
- ansible.builtin.assert:
that: disk_free > 500
fail_msg: "Need at least 500MB free"
success_msg: "Disk space OK"assert проверяет сразу несколько условий
assert принимает список в параметре that. Каждое условие должно быть истинным; первое ложное условие завершает задачу сбоем и выводит Ваше сообщение.
fail и assert
Используйте fail для одной намеренной остановки с логикой в when, а assert — для краткой проверки набора условий.
Подстановка значений
В параметр msg можно включать переменные для пояснения контекста. Покажите неверное значение, чтобы оператор точно знал, что нужно исправить.
- ansible.builtin.fail:
msg: "Port {{ app_port }} is out of range"Утверждения как документация
Хорошие утверждения одновременно служат актуальной документацией: они формулируют ожидания от плейбука и в одном месте обеспечивают их выполнение. 📝
Режим quiet для assert
Установите для assert параметр quiet в значение true, чтобы отключить вывод по каждому условию. Это удобно, когда важны только сбои, а не успешно пройденные проверки.
- ansible.builtin.assert:
that: app_port is defined
quiet: trueБыстрая проверка
Выберем подходящий инструмент.
Итоги
Модуль fail останавливает плей с понятным сообщением, а assert аккуратно проверяет условия. Заблаговременно защищайте свои плейбуки. ✅
Часто задаваемые вопросы
Урок «Пользовательские проверки с модулем fail» бесплатный?
Да — полный текст урока «Пользовательские проверки с модулем fail» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс DevOps Bootcamp, подпишись на CoddyKit PRO. Курс DevOps Bootcamp содержит 4 уроков всего.
Чему я научусь в уроке «Пользовательские проверки с модулем fail»?
Остановите плейбук понятным сообщением Ты практикуешь DevOps Bootcamp с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать DevOps Bootcamp?
Предыдущий опыт не требуется. DevOps Bootcamp на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.
Сколько времени занимает урок «Пользовательские проверки с модулем fail»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке DevOps Bootcamp?
Да. Каждый урок DevOps Bootcamp включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Группировка задач с block
- Try / Catch с rescue и always
- Управление сбоями: failed_when и ignore_errors
- Пользовательские проверки с модулем fail