wait_for_connection – Ожидание подключения к удаленной системе
Новое в версии 2.3.
Описание
- Ожидание в течение
timeoutсекунд. - Повторная попытка подключения после таймаута
connect_timeout. - Проверка подключения каждые
sleepсекунды. - Этот модуль использует внутренний транспорт Ansible (и конфигурацию), а также модули ping/win_ping для обеспечения корректной работы end-to-end.
- Этот модуль также поддерживается для целевых систем Windows.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| connect_timeout - | По умолчанию: 5 | Максимальное время ожидания подключения в секундах перед закрытием и повторной попыткой. |
| delay - | По умолчанию: 0 | Количество секунд ожидания перед началом опроса. |
| sleep - | По умолчанию: 1 | Количество секунд ожидания между проверками. |
| timeout - | По умолчанию: 600 | Максимальное время ожидания в секундах. |
Примечания
Примечание
- Этот модуль также поддерживается для целевых систем Windows.
Примеры
- 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 |
Статус
- Для этого модуля гарантируются отсутствие несовместимых изменений интерфейса в будущем. [stableinterface]
- Этот модуль поддерживается Командой ядра Ansible. [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.7/modules/wait_for_connection_module.html