community.hrobot.boot 模块 – 设置引导配置

注意

此模块是 community.hrobot 集合（版本 2.0.2）的一部分。

如果您使用的是 ansible 包，则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.hrobot。

要在剧本中使用它，请指定：community.hrobot.boot。

community.hrobot 1.2.0 中的新增功能

概要

• 为专用服务器设置引导配置。

参数

参数	注释
hetzner_password 字符串 / 必需	Robot Web 服务用户的密码。
hetzner_user 字符串 / 必需	Robot Web 服务用户的用户名。
install_cpanel 字典	如果提供了此选项，则将在下次启动时激活 cPanel 安装。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。
arch 整数	安装要使用的架构。 并非所有发行版都提供所有架构。 默认为 64。 选择 32 64
dist 字符串 / 必需	要安装的发行版。
hostname 字符串 / 必需	主机名。
lang 字符串 / 必需	操作系统要使用的语言。
install_linux 字典	如果提供了此选项，则将在下次启动时激活 Linux 系统安装。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。
arch 整数	安装要使用的架构。 并非所有发行版都提供所有架构。 默认为 64。 选择 32 64
authorized_keys 列表 / 元素=字符串	用于装备救援系统的一个或多个 SSH 密钥指纹。 只能使用 Robot API 中存储的 SSH 密钥的指纹。 您可以使用 community.hrobot.ssh_key_info 模块查询可以使用的 SSH 密钥，并使用 community.hrobot.ssh_key 模块添加或更新 SSH 密钥。
dist 字符串 / 必需	要安装的发行版。
lang 字符串 / 必需	操作系统要使用的语言。
install_plesk 字典	如果提供了此选项，则将在下次启动时激活 Plesk 安装。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。
arch 整数	安装要使用的架构。 并非所有发行版都提供所有架构。 默认为 64。 选择 32 64
dist 字符串 / 必需	要安装的发行版。
hostname 字符串 / 必需	主机名。
lang 字符串 / 必需	操作系统要使用的语言。
install_vnc 字典	如果提供了此选项，则将在下次启动时激活 VNC 安装。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。
arch 整数	安装要使用的架构。 并非所有发行版都提供所有架构。 默认为 64。 选择 32 64
dist 字符串 / 必需	要安装的发行版。
lang 字符串 / 必需	操作系统要使用的语言。
install_windows 字典	如果提供了此选项，则将在下次启动时激活 Windows 安装。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。
lang 字符串 / 必需	Windows 要使用的语言。
regular_boot 布尔值	如果提供了此选项，则将删除所有特殊引导配置，并且下次将启动安装的操作系统（假设它是可引导的）。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。 选择 false true
rescue 字典	如果提供了此选项，则将在下次启动时激活救援系统。 必须提供 regular_boot、rescue、install_linux、install_vnc、install_windows、install_plesk 和 install_cpanel 中的精确一个。
arch 整数	救援系统要使用的架构。 并非所有操作系统都提供所有架构。 默认为 64。 选择 32 64
authorized_keys 列表 / 元素=字符串	用于装备救援系统的一个或多个 SSH 密钥指纹。 只能使用 Robot API 中存储的 SSH 密钥的指纹。 您可以使用 community.hrobot.ssh_key_info 模块查询可以使用的 SSH 密钥，并使用 community.hrobot.ssh_key 模块添加或更新 SSH 密钥。
os 字符串 / 必需	救援系统要使用的操作系统。可能的选择会随着时间而变化。 目前，linux、linuxold、freebsd、freebsdold、freebsdax、freebsdbetaax、vkvm 和 vkvmold 似乎可用。
server_number 整数 / 必需	要调整其引导配置的服务器的服务器编号。

属性

属性	支持	描述
action_group	操作组： community.hrobot.robot 在 community.hrobot 1.6.0 中添加	在 module_defaults 中使用 group/community.hrobot.robot 来为此模块设置默认值。
check_mode	支持: 完全	可以在 check_mode 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持: 无	当处于 diff 模式时，将返回已更改（或可能需要在 check_mode 中更改）的详细信息。

另请参阅

另请参阅

community.hrobot.ssh_key

添加、删除或更新 SSH 密钥

community.hrobot.ssh_key_info

查询 SSH 密钥信息

示例

- name: Disable all special boot configurations
  community.hrobot.boot:
    hetzner_user: foo
    hetzner_password: bar
    regular_boot: true

- name: Enable a rescue system (64bit Linux) for the next boot
  community.hrobot.boot:
    hetzner_user: foo
    hetzner_password: bar
    rescue:
      os: linux

- name: Enable a Linux install for the next boot
  community.hrobot.boot:
    hetzner_user: foo
    hetzner_password: bar
    install_linux:
      dist: CentOS 5.5 minimal
      lang: en
      authorized_keys:
        - 56:29:99:a4:5d:ed:ac:95:c1:f5:88:82:90:5d:dd:10
        - 15:28:b0:03:95:f0:77:b3:10:56:15:6b:77:22:a5:bb

返回值

常见返回值在此处记录 这里，以下是此模块独有的字段

键	描述
configuration_type 字符串	描述活动的启动配置。 返回: 成功 只能返回 "regular_boot" "rescue" "install_linux" "install_vnc" "install_windows" "install_plesk" "install_cpanel"
password 字符串	如果可用，则为活动启动配置的 root 密码。 对于非救援启动配置，建议尽快更改 root 密码。 返回: 成功，并且如果 configuration_type 不是 regular_boot

作者

• Felix Fontein (@felixfontein)

集合链接

• 问题跟踪器
• 存储库（源代码）
• 寻求帮助 (Hetzner Robot)
• 提交错误报告
• 请求功能
• 交流