wait_for_connection – Ожидание подключения к удалённой системе
Описание
- Ожидание в течение
timeoutсекунд. - Повторная попытка подключения после таймаута в
connect_timeout. - Проверка подключения каждые
sleepсекунды. - Этот модуль использует внутренний транспорт Ansible (и конфигурацию), а также модули ping/win_ping для обеспечения корректной работы «от начала до конца».
- Этот модуль также поддерживает целевые системы Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| connect_timeout целое число | По умолчанию: 5 | Максимальное время в секундах ожидания подключения до закрытия и повторной попытки. |
| delay целое число | По умолчанию: 0 | Время в секундах ожидания перед началом опроса. |
| sleep целое число | По умолчанию: 1 | Время в секундах ожидания между проверками. |
| timeout целое число | По умолчанию: 600 | Максимальное время ожидания в секундах. |
Примечания
Примечание
- Этот модуль также поддерживает целевые системы Windows.
См. также
См. также
- wait_for – Ожидание выполнения условия
- Официальная документация модуля wait_for.
- win_wait_for – Ожидание выполнения условия
- Официальная документация модуля win_wait_for.
- win_wait_for_process – Ожидание процесса
- Официальная документация модуля win_wait_for_process.
Примеры
- 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 вещественное число | всегда | Количество секунд, затраченное на ожидание подключения. Пример: 23.1 |
Статус
- Этот модуль гарантирует обратную совместимость интерфейса в будущем. [stableinterface]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- Dag Wieers (@dagwieers)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/wait_for_connection_module.html