assert

Содержание

assert#

Модуль ansible.builtin.assert проверяет истинность выражений.

Особенности работы#

Модуль может работать с узлами под управлением ОС Windows.

Параметры#

Модуль принимает следующие параметры:

fail_msg, msg#: Сообщение, которое выводится при ложности выражения.

quiet#

Подробность вывода.

Возможные значения:

false – краткий вывод;
true – подробный вывод.

Значение по умолчанию: false.

success_msg#: Сообщение, которое выводится при истинности выражения.

that#

Обязательный параметр.

Строка или список строковых выражений в той же форме, что и при использовании параметра when. Подробности см. в секции Условные выражения.

Атрибуты#

Атрибуты определяют функции Ansible, которые может использовать модуль.

Атрибут	Описание
`action`	Модуль имеет соответствующее расширение действий (action plugin). Это расширение выполняет работу на управляющем узле.
`async`	Модуль не поддерживает асинхронное выполнение.
`become`	Модуль не поддерживает повышение привилегий.
`bypass_host_loop`	Модуль не выполняется как глобальная задача. Для каждого узла выполняется отдельный цикл с учетом всех ограничений.
`check_mode`	Модуль работает в режиме проверки (`check_mode`) в полном объеме. Режим проверки позволяет проверить истинность выражений.
`connection`	Модуль не использует информацию о настройках подключения к целевому узлу при выполнении заданий на нем.
`delegation`	Модуль не поддерживает `delegate_to`, то есть не может выполняться на другом узле.
`diff_mode`	Модуль не поддерживает режим сравнения.
`platform`	Модуль поддерживает все платформы, с которыми может работать Ansible.

Примеры#

Для изучения возможностей модуля ознакомьтесь с приведенными ниже примерами.

Проверка простого выражения#

Следующий пример демонстрирует проверку простого выражения:

---
- name: Check that is Astra Linux
  ansible.builtin.assert:
    that: "ansible_os_family == 'Astra Linux'"

Проверка нескольких выражений#

Следующий пример демонстрирует проверку нескольких выражений:

---
- name: Check CPU and RAM counts
  ansible.builtin.assert:
    that:
      - ansible_processor_count >= 4
      - ansible_memory_mb.real.total >= 4096

Собственные сообщения о результатах проверки#

Следующий пример демонстрирует использование собственных сообщений для вывода результатов проверки истинности выражений:

---
- name: Check hardware requirements
  ansible.builtin.assert:
    that:
      - ansible_os_family == "Astra Linux"
      - ansible_processor_count >= 4
      - ansible_memory_mb.real.total >= 4096
    fail_msg: "This computer require upgrade"
    success_msg: "This computer ready for work"