community.windows.win_wait_for_process – Ожидание существования или несуществования процесса перед продолжением.
Примечание
Этот плагин является частью коллекции community.windows (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.windows.
Для использования в playbook укажите: 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 строка | Шаблон регулярного выражения для поиска нужного процесса(ов). | |
| 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/windows/win_wait_for_process_module.html
