wait_for – Ожидание условия перед продолжением

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

Описание

• Вы можете ожидать определённое количество времени timeout, это значение по умолчанию, если ничего не указано или указано только timeout. Это не приводит к ошибке.
• Ожидание готовности порта полезно, когда службы не становятся доступными сразу после возвращения их скриптов инициализации, что характерно для некоторых Java-приложений.
• Это также полезно при запуске гостей с модулем virt и необходимости приостановить выполнение, пока они не будут готовы.
• Этот модуль также можно использовать для ожидания совпадения регулярного выражения со строкой, присутствующей в файле.
• В Ansible 1.6 и более поздних версиях этот модуль также можно использовать для ожидания наличия или отсутствия файла в файловой системе.
• В Ansible 1.8 и более поздних версиях этот модуль также можно использовать для ожидания закрытия активных соединений перед продолжением, что полезно, если узел выводится из пула балансировщиков нагрузки.
• Для целевых систем Windows используйте модуль win_wait_for вместо этого.

Параметры

Примечания

См. также

Примеры

- name: sleep for 300 seconds and continue with play
  wait_for:
    timeout: 300
  delegate_to: localhost

- name: Wait for port 8000 to become open on the host, don't start checking for 10 seconds
  wait_for:
    port: 8000
    delay: 10

- name: Waits for port 8000 of any IP to close active connections, don't start checking for 10 seconds
  wait_for:
    host: 0.0.0.0
    port: 8000
    delay: 10
    state: drained

- name: Wait for port 8000 of any IP to close active connections, ignoring connections for specified hosts
  wait_for:
    host: 0.0.0.0
    port: 8000
    state: drained
    exclude_hosts: 10.2.1.2,10.2.1.3

- name: Wait until the file /tmp/foo is present before continuing
  wait_for:
    path: /tmp/foo

- name: Wait until the string "completed" is in the file /tmp/foo before continuing
  wait_for:
    path: /tmp/foo
    search_regex: completed

- name: Wait until regex pattern matches in the file /tmp/foo and print the matched group
  wait_for:
    path: /tmp/foo
    search_regex: completed (?P<task>\w+)
  register: waitfor
- debug:
    msg: Completed {{ waitfor['groupdict']['task'] }}

- name: Wait until the lock file is removed
  wait_for:
    path: /var/lock/file.lock
    state: absent

- name: Wait until the process is finished and pid was destroyed
  wait_for:
    path: /proc/3466/status
    state: absent

- name: Output customized message when failed
  wait_for:
    path: /tmp/foo
    state: present
    msg: Timeout to find file /tmp/foo

# Do not assume the inventory_hostname is resolvable and delay 10 seconds at start
- name: Wait 300 seconds for port 22 to become open and contain "OpenSSH"
  wait_for:
    port: 22
    host: '{{ (ansible_ssh_host|default(ansible_host))|default(inventory_hostname) }}'
    search_regex: OpenSSH
    delay: 10
  connection: local

# Same as above but you normally have ansible_connection set in inventory, which overrides 'connection'
- name: Wait 300 seconds for port 22 to become open and contain "OpenSSH"
  wait_for:
    port: 22
    host: '{{ (ansible_ssh_host|default(ansible_host))|default(inventory_hostname) }}'
    search_regex: OpenSSH
    delay: 10
  vars:
    ansible_connection: local

Возвращаемые значения

Общие значения возврата описаны здесь. Ниже приведены поля, уникальные для данного модуля:

Статус

• Этот модуль гарантированно не будет иметь изменений интерфейса, несовместимых со старыми версиями, в будущем. [stableinterface]
• Этот модуль поддерживается командой Ansible Core. [core]

Поддержка Red Hat

Дополнительную информацию о поддержке этого модуля Red Hat см. в этой статье базы знаний Red Hat.

Авторы

• Jeroen Hoekx (@jhoekx)
• John Jarvis (@jarv)
• Andrii Radyk (@AnderEnder)