ansible.builtin.reboot – Перезагрузка компьютера

Примечание

Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля reboot, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать полное имя FQCN для лёгкой ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.

Новое в версии 2.7: of ansible.builtin

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

Описание

Перезагрузите компьютер, подождите, пока он выключится, включится и ответит на команды.
Для целевых систем Windows используйте модуль ansible.windows.win_reboot вместо этого.

Примечание

У этого модуля есть соответствующий плагин действий.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
boot_time_command строка добавлен в 2.10 of ansible.builtin	Значение по умолчанию: "cat /proc/sys/kernel/random/boot_id"	Команда, которая возвращает уникальную строку, указывающую последний раз, когда система была загружена. Установка значения на команду, имеющую различный вывод каждый раз при запуске, приведёт к сбоям задачи.
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 of ansible.builtin	Значение по умолчанию: ["/sbin", "/usr/sbin", "/usr/local/sbin"]	Пути для поиска на удалённой машине команды `shutdown`. Только эти пути будут проверяться на наличие команды `shutdown`. `PATH` игнорируется на удалённом узле при поиске команды `shutdown`.
test_command строка	Значение по умолчанию: "whoami"	Команда, выполняемая на перезагруженном хосте и ожидающая успешного выполнения, чтобы определить готовность компьютера к дальнейшим задачам.

Примечания

Примечание

PATH игнорируется на удалённом узле при поиске команды shutdown . Используйте search_paths для указания расположений для поиска, если пути по умолчанию не работают.

См. также

ansible.windows.win_reboot: Официальная документация по модулю ansible.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

- name: Reboot a machine with shutdown command in unusual place
  reboot:
    search_paths:
     - '/lib/molly-guard'

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

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

Ключ	Возвращаемое значение	Описание
elapsed целое число	всегда	Количество секунд, затраченных на ожидание перезагрузки системы. Пример: 23
rebooted булево	всегда	true, если компьютер был перезагружен Пример: True

Авторы

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.10/collections/ansible/builtin/reboot_module.html