community.general.hpilo_boot 模块 – 通过 HP iLO 接口使用特定介质启动系统

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。您需要进一步的要求才能使用此模块，请参阅 要求 了解详细信息。

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

概要

  • 此模块通过其 HP iLO 接口启动系统。启动介质可以是以下之一：cdrom、floppy、hdd、network 或 usb。

  • 此模块需要 hpilo python 模块。

要求

以下要求需要在执行此模块的主机上满足。

  • python-hpilo

参数

参数

注释

force

布尔值

是否强制重启（即使系统已启动）。

作为一种保护措施，如果没有 force，hpilo_boot 将拒绝重启已经运行的服务器。

选择

  • false ←（默认）

  • true

host

字符串 / 必填

链接到物理系统的 HP iLO 主机名/地址。

image

字符串

cdrom、floppy 或 usb 启动介质映像的 URL。 protocol://username:password@hostname:port/filename

protocol 是 'http' 或 'https'

username:password 是可选的

port 是可选的

login

字符串

用于向 HP iLO 接口进行身份验证的登录名。

默认值： "Administrator"

media

字符串

要从中启动系统的启动介质

选择

  • "cdrom"

  • "floppy"

  • "rbsu"

  • "hdd"

  • "network"

  • "normal"

  • "usb"

password

字符串

用于向 HP iLO 接口进行身份验证的密码。

默认值： "admin"

ssl_version

字符串

更改使用的 ssl_version。

选择

  • "SSLv3"

  • "SSLv23"

  • "TLSv1" ←（默认）

  • "TLSv1_1"

  • "TLSv1_2"

state

字符串

启动介质的状态。

no_boot：不从设备启动

boot_once：从设备启动一次，之后不再启动

boot_always：每次服务器重启时都从设备启动

connect：连接虚拟介质设备并设置为 boot_always

disconnect：断开虚拟介质设备的连接并设置为 no_boot

poweroff：关闭服务器电源

选择

  • "boot_always"

  • "boot_once" ←（默认）

  • "connect"

  • "disconnect"

  • "no_boot"

  • "poweroff"

属性

属性

支持

描述

check_mode

支持：无

可以在 check_mode 中运行，并返回更改状态预测，而无需修改目标。

diff_mode

支持：无

当处于 diff 模式时，将返回有关已更改（或可能需要在 check_mode 中更改）的内容的详细信息。

注释

注意

  • 要使用 USB 密钥映像，您需要将 floppy 指定为启动介质。

  • 此模块应该从可以直接访问 HP iLO 接口的系统运行，可以使用 local_action 或使用 delegate_to。

示例

- name: Task to boot a system using an ISO from an HP iLO interface only if the system is an HP server
  community.general.hpilo_boot:
    host: YOUR_ILO_ADDRESS
    login: YOUR_ILO_LOGIN
    password: YOUR_ILO_PASSWORD
    media: cdrom
    image: http://some-web-server/iso/boot.iso
  when: cmdb_hwmodel.startswith('HP ')
  delegate_to: localhost

- name: Power off a server
  community.general.hpilo_boot:
    host: YOUR_ILO_HOST
    login: YOUR_ILO_LOGIN
    password: YOUR_ILO_PASSWORD
    state: poweroff
  delegate_to: localhost

作者

  • Dag Wieers (@dagwieers)