ping

Модуль ansible.builtin.ping предназначен для проверки возможности подключения к управляемому узлу и наличия на нем приемлемой версии Python.

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

Особенности использования модуля ansible.builtin.ping:

• применение модуля в сценариях не имеет практического смысла, но полезно при запуске из командной строки;

• модуль по умолчанию возвращает pong при успешном соединении;

• модуль не является аналогом утилиты ping и не использует протокол ICMP;

• для проверки возможности подключения к узлам под управлением Windows используйте ansible.windows.win_ping;

• для проверки возможности подключения к сетевым устройствам используйте ansible.netcommon.net_ping.

Параметры

Модуль принимает только параметр data – строка, возвращаемая модулем. Если указано значение crash, работа модуля завершится с ошибкой (используется для тестирования).

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

Возвращаемые значения

Модуль ansible.builtin.ping возвращает единственное значение, указанное в параметре data. Условия возвращения: успешное завершение.

Атрибуты

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

Атрибут	Описание
check_mode	Модуль поддерживает режим проверки.
diff_mode	Модуль не поддерживает режим сравнения.
platform	Модуль поддерживает только POSIX-совместимые ОС.

Примеры

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

Проверка из сценария

Следующий пример демонстрирует проверку подключения к узлу из сценария:

- name: Example from an Ansible Playbook
  ansible.builtin.ping:

Проверка из командной строки

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

ansible webservers -m ansible.builtin.ping