wait_for_connection - Ожидание достижения доступности удаленной системы
Новая версия 2.3.
Описание
- Ожидание в течение
timeoutсекунд. - Повторная попытка подключения транспорта после истечения времени ожидания в
connect_timeout. - Проверка подключения транспорта каждые
sleepсекунды. - Этот модуль использует внутренний транспорт Ansible (и конфигурацию), а также модули ping/win_ping для обеспечения правильного взаимодействия «конец-в-конец».
- Этот модуль также поддерживается для целевых систем Windows.
Параметры
| параметр | обязательно | значение по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| connect_timeout | нет | 5 | Максимальное время в секундах ожидания подключения перед закрытием и повторной попыткой. | |
| delay | нет | Количество секунд ожидания перед началом опроса. | ||
| sleep | нет | 1 | Количество секунд ожидания между проверками. | |
| timeout | нет | 600 | Максимальное время ожидания в секундах. |
Примеры
- name: Wait 600 seconds for target connection to become reachable/usable
wait_for_connection:
- name: Wait 300 seconds, but only start checking after 60 seconds
wait_for_connection:
delay: 60
timeout: 300
# Wake desktops, wait for them to become ready and continue playbook
- hosts: all
gather_facts: no
tasks:
- name: Send magic Wake-On-Lan packet to turn on individual systems
wakeonlan:
mac: '{{ mac }}'
broadcast: 192.168.0.255
delegate_to: localhost
- name: Wait for system to become reachable
wait_for_connection:
- name: Gather facts for first time
setup:
# Build a new VM, wait for it to become ready and continue playbook
- hosts: all
gather_facts: no
tasks:
- name: Clone new VM, if missing
vmware_guest:
hostname: '{{ vcenter_ipaddress }}'
name: '{{ inventory_hostname_short }}'
template: Windows 2012R2
customization:
hostname: '{{ vm_shortname }}'
runonce:
- powershell.exe -ExecutionPolicy Unrestricted -File C:\Windows\Temp\ConfigureRemotingForAnsible.ps1 -ForceNewSSLCert -EnableCredSSP
delegate_to: localhost
- name: Wait for system to become reachable over WinRM
wait_for_connection:
timeout: 900
- name: Gather facts for first time
setup:
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| elapsed | Количество секунд, затраченных на ожидание подключения. | всегда | int | 23 |
Примечания
Примечание
- Этот модуль также поддерживается для целевых систем Windows.
Статус
Этот модуль помечен как 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/wait_for_connection_module.html