ping - Попытка подключения к хосту, проверка работоспособности Python и возврат pong при успехе
Описание
- Это тривиальный модуль для тестирования, который всегда возвращает
pongпри успешном подключении. Он не имеет смысла в playbooks, но полезен для/usr/bin/ansibleдля проверки возможности входа и работоспособности установленного Python. - Это НЕ ICMP-пингование, это просто тривиальный модуль тестирования.
- Для целевых систем Windows используйте модуль win_ping.
Параметры
| параметр | обязательный | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| data | нет | pong | Данные, которые должны быть возвращены для значения ping.Если этот параметр установлен на crash, модуль вызовет исключение. |
Примеры
# Test we can logon to 'webservers' and execute python with json lib.
# ansible webservers -m ping
# Example from an Ansible Playbook
- ping:
# Induce an exception to see what happens
- ping:
data: crash
Возвращаемые значения
Общие значения, возвращаемые модулем, документированы здесь Возвращаемые значения. Ниже приведены поля, уникальные для данного модуля:
| название | описание | возвращаемое значение | тип | пример |
|---|---|---|---|---|
| ping | Значение, предоставленное с помощью параметра data | успешно | строка | pong |
Примечания
Примечание
- Для целевых систем Windows используйте модуль win_ping.
Статус
Данный модуль отмечен как stableinterface, что означает, что разработчики гарантируют отсутствие обратной несовместимости в изменениях интерфейса модуля.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией Red Hat можно найти по этой ссылке knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей обратитесь к Справочной информации по сообществу и участию в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ping_module.html