Spec-Zone.ru › Ansible 2.8

wait_for_connection – Ожидание подключения к удалённой системе

Новая в версии 2.3.

  • Описание
  • Параметры
  • Примечания
  • См. также
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

  • Ожидание в течение 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
float
всегда
Количество секунд, затраченных на ожидание подключения.

Пример:
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.8/modules/wait_for_connection_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API