reboot – Перезагрузка машины
Новое в версии 2.7.
Описание
- Перезагрузить машину, подождать её выключения, включения и готовности к командам.
- Для целевых систем Windows используйте модуль win_reboot.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| connect_timeout целое число | Максимальное время (в секундах) ожидания успешного подключения к управляемым хостам перед повторной попыткой. Если не указано, используется значение по умолчанию для соответствующего плагина подключения. | |
| msg строка | Значение по умолчанию: "Перезагрузка инициирована Ansible" | Сообщение для отображения пользователям перед перезагрузкой. |
| post_reboot_delay целое число | Значение по умолчанию: 0 | Время ожидания (в секундах) после успешного выполнения команды перезагрузки перед проверкой успешного завершения перезагрузки системы. Это полезно, если требуется подождать, пока что-то стабилизируется, несмотря на то, что подключение уже работает. |
| pre_reboot_delay целое число | Значение по умолчанию: 0 | Время ожидания (в секундах) перед перезагрузкой. Передаётся как параметр команде перезагрузки. В Linux, macOS и OpenBSD это время преобразуется в минуты и округляется вниз. Если оно меньше 60, оно устанавливается в 0. В Solaris и FreeBSD это время в секундах. |
| reboot_timeout целое число | Значение по умолчанию: 600 | Максимальное время ожидания (в секундах) перезагрузки машины и ответа на тестовую команду. Это время ожидания оценивается отдельно как для проверки перезагрузки, так и для успешного выполнения тестовой команды, поэтому максимальное время выполнения модуля составляет вдвое больше этого значения. |
| search_paths список добавлено в 2.8 | Значение по умолчанию: ["/sbin", "/usr/sbin", "/usr/local/sbin"] | Пути для поиска на удалённой машине команды shutdown.
Только эти пути будут проверены на наличие команды shutdown. PATH игнорируется на удалённом узле при поиске команды shutdown. |
| test_command строка | Значение по умолчанию: "whoami" | Команда, выполняемая на перезагруженном хосте, для определения готовности машины к дальнейшим задачам. |
Примечания
Примечание
-
PATHигнорируется на удалённом узле при поиске командыshutdown. Используйтеsearch_pathsдля указания мест поиска, если пути по умолчанию не работают.
См. также
См. также
- win_reboot – Перезагрузка машины Windows
- Официальная документация по модулю win_reboot.
Примеры
- name: Unconditionally reboot the machine with all defaults
reboot:
- name: Reboot a slow machine that might have lots of updates to apply
reboot:
reboot_timeout: 3600
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| elapsed целое число | всегда | Количество секунд, затраченных на ожидание перезагрузки системы. Пример: 23 |
| rebooted булево | всегда | true, если машина была перезагружена Пример: True |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается командой разработчиков Ansible. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке данного модуля компанией Red Hat можно найти в этой статье базы знаний Red Hat.
Авторы
- Matt Davis (@nitzmahone)
- Sam Doran (@samdoran)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/reboot_module.html