ansible常用模块之 -- reboot模块 – 重新启动机器

reboot模块 – 重新启动机器

一、摘要

• 重新启动机器，等待它关闭，然后重新启动，然后响应命令。
• 对于Windows目标，请使用win_reboot模块

二、参数

参数	选项/默认值	描述
connect_timeout integer		在再次尝试之前等待成功连接到托管主机的最长时间。 如果未指定，则使用底层连接插件的默认设置。
msg string	Default: “Reboot initiated by Ansible”	在重新启动之前显示给用户的消息。
post_reboot_delay integer	Default: 0	在重新启动命令成功后，尝试验证成功重新启动的系统之前要等待的秒数。 如果你想等待一些事情解决，尽管你的连接已经在工作，这是很有用的。
pre_reboot_delay integer	Default: 0	重启前的等待时间。作为参数传递给reboot命令。 在Linux、macOS和OpenBSD上，此时间转换为分钟并向下四舍五入。如果小于60，它将被设置为0。 在Solaris和FreeBSD上，这将是几秒钟的时间。
reboot_timeout integer	Default: 600	等待计算机重新启动和响应测试命令的最大秒数。这个超时在重新引导验证和测试命令成功时分别计算，因此模块的最大执行时间是这个量的两倍。
search_paths list	Default: [“/sbin”, “/usr/sbin”, “/usr/local/sbin”]	在远程计算机上搜索关机命令的路径。 只有这些路径才会被搜索到shutdown命令 搜索shutdown命令时，在远程节点中忽略PATH。
test_command string	Default: “whoami”	命令在重新启动的主机上运行，并期望从中获得成功，以确定该计算机已准备好执行进一步的任务。

三、示例

# 无条件地使用所有默认值重新启动计算机
- 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

官方文档：https://docs.ansible.com/ansible/2.9/modules/reboot_module.html#reboot-module