community.windows.win_wait_for_process – Ожидание существования или отсутствия процесса перед продолжением.
Примечание
Этот плагин является частью коллекции community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows
Для использования в плейбуке укажите: community.windows.win_wait_for_process
Обзор
- Ожидание запуска или завершения процесса.
- Это полезно, когда службы Windows работают плохо и не перечисляют внешние зависимости в своём манифесте.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| owner строка | Владелец процесса. Требуется версия PowerShell 4.0 или выше. | |
| pid целое число | Идентификатор процесса (PID). | |
| post_wait_delay целое число | По умолчанию: 0 | Секунды ожидания после проверки процессов. |
| pre_wait_delay целое число | По умолчанию: 0 | Секунды ожидания перед проверкой процессов. |
| process_min_count целое число | По умолчанию: 1 | Минимальное количество процессов, соответствующих заданному шаблону, для удовлетворения условия present. Применимо только к present. |
| process_name_exact список / элементы=строка | Название(я) процесса(ов) для ожидания. Имя(на) процесса(ов) не должно содержать расширения файла. | |
| process_name_pattern строка | Шаблон RegEx для поиска желаемого процесса(ов). | |
| sleep целое число | По умолчанию: 1 | Количество секунд для ожидания между проверками. Применимо только при ожидании запуска процесса. Ожидание запуска процесса не имеет собственного механизма без опроса. Ожидание завершения использует собственный PowerShell и не требует опроса. |
| state строка |
| При проверке работающего процесса present будет блокировать выполнение до существования процесса или достижения таймаута. absent будет блокировать выполнение до тех пор, пока процесс больше не существует, или пока не будет достигнут таймаут.При ожидании present, модуль вернёт изменённое значение только если процесс отсутствовал при первоначальной проверке, но появился на последующих проверках.Если во время ожидания absent, запускаются новые процессы, соответствующие заданному шаблону, эти новые процессы не будут включены в действие. |
| timeout целое число | По умолчанию: 300 | Максимальное время в секундах ожидания запуска или завершения процесса перед ошибкой. |
См. также
См. также
- ansible.builtin.wait_for
-
Официальная документация модуля ansible.builtin.wait_for.
- ansible.windows.win_wait_for
-
Официальная документация модуля ansible.windows.win_wait_for.
Примеры
- name: Wait 300 seconds for all Oracle VirtualBox processes to stop. (VBoxHeadless, VirtualBox, VBoxSVC)
community.windows.win_wait_for_process:
process_name_pattern: 'v(irtual)?box(headless|svc)?'
state: absent
timeout: 500
- name: Wait 300 seconds for 3 instances of cmd to start, waiting 5 seconds between each check
community.windows.win_wait_for_process:
process_name_exact: cmd
state: present
timeout: 500
sleep: 5
process_min_count: 3
Возвращаемые значения
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| elapsed вещественное число | всегда | Прошедшие секунды с момента начала опроса до завершения модуля. Пример: 3.14159265 | |
| matched_processes сложное | всегда | Список сопоставленных процессов (как остановленных, так и запущенных). | |
| name строка | всегда | Имя сопоставленного процесса. Пример: svchost | |
| owner строка | при поддержке PowerShell | Владелец сопоставленного процесса. Пример: NT AUTHORITY\SYSTEM | |
| pid целое число | всегда | Идентификатор процесса (PID) сопоставленного процесса. Пример: 7908 | |
Авторы
- Charles Crossan (@crossan007)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_wait_for_process_module.html
