ansible.builtin.pause – Приостановка выполнения playbook
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля pause, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь такое же имя модуля.
Новое в версии 0.8: от ansible.builtin
Описание
- Приостанавливает выполнение playbook на заданное количество времени или до подтверждения запроса. Все параметры являются необязательными. По умолчанию используется приостановка с запросом.
- Для приостановки/ожидания/сна на хост-уровне используйте модуль ansible.builtin.wait_for.
- Вы можете использовать
ctrl+c, если хотите ускорить приостановку раньше, чем она истечёт, или если вам нужно полностью прервать выполнение playbook. Для продолжения раньше нажмитеctrl+cи затемc. Для прерывания playbook нажмитеctrl+cи затемa. - Модуль pause интегрируется в асинхронные/параллелизованные playbooks без каких-либо специальных соображений (см. Распределённые обновления). При использовании приостановок с параметром playbook
serial(как в распределённых обновлениях) вы получаете запрос только один раз для текущей группы хостов. - Этот модуль также поддерживается для Windows-целей.
Примечание
Этот модуль имеет соответствующий плагин действия.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
echo
boolean
добавлен в 2.5 от ansible.builtin
|
|
Управляет отображением ввода с клавиатуры при наборе.
Не имеет эффекта, если установлено значение 'seconds' или 'minutes'.
|
| minutes string |
Положительное число минут для приостановки. |
|
| prompt string |
Необязательный текст для сообщения запроса. |
|
| seconds string |
Положительное число секунд для приостановки. |
Примечания
Примечание
- Начиная с версии 2.2, если вы укажете 0 или отрицательное значение для минут или секунд, будет ожидаться 1 секунда, в предыдущих версиях ожидание было неограниченным.
- Этот модуль также поддерживается для Windows-целей.
- Ввод пользователя не сохраняется и не отображается, независимо от параметра echo, если установлены значения minutes или seconds.
Примеры
- name: Pause for 5 minutes to build app cache
pause:
minutes: 5
- name: Pause until you can verify updates to an application were successful
pause:
- name: A helpful reminder of what to look out for post-update
pause:
prompt: "Make sure org.foo.FooOverload exception is not present"
- name: Pause to get some sensitive input
pause:
prompt: "Enter a secret"
echo: no
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| delta string |
всегда | Время приостановки в секундах Пример: 2 |
| echo boolean |
всегда | Значение параметра echo Пример: True |
| start string |
всегда | Время начала приостановки Пример: 2017-02-23 14:35:07.298862 |
| stdout string |
всегда | Выход модуля pause Пример: Приостановлено на 0.04 минуты |
| stop string |
всегда | Время окончания приостановки Пример: 2017-02-23 14:35:09.552594 |
| user_input string |
если не задано время ожидания | Ввод пользователя из интерактивной консоли Пример: Пример ввода пользователя |
Авторы
- Tim Bielawa (@tbielawa)
© 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/ansible/builtin/pause_module.html