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

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。要使用此模块，您需要其他要求，请参阅 要求 获取详细信息。

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

概要

  • 此模块通过其 HP iLO 接口启动系统。启动介质可以是：cdrom、软盘、hdd、网络或 usb。

  • 此模块需要 hpilo python 模块。

要求

执行此模块的主机需要以下要求。

  • python-hpilo

参数

参数

注释

force

布尔值

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

作为安全措施，如果没有 force，hpilo_boot 将拒绝重新引导正在运行的服务器。

选项

  • false ← (默认)

  • true

host

字符串 / 必需

与物理系统关联的 HP iLO 主机名/地址。

image

字符串

cdrom、软盘或 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

支持：不支持

在差异模式下，将返回有关已更改内容（或可能需要在 check_mode 中更改）的详细信息。

备注

注意

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

  • 此模块应该从可以直接访问 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)