23.2. 使用 rhel_mgmt.ipmi_power 模块设置系统电源状态


您可以使用 redhat.rhel_mgmt 集合的 ipmi_power 模块来设置硬件状态。例如,您可以确保主机已加电或被硬重置,而不涉及操作系统。ipmi_power 模块使用智能平台管理接口(IPMI)来执行操作。

重要

当您使用此 Ansible 模块时,会涉及三个主机:控制节点、受管节点和在其上应用实际 IPMI 操作的带有基板管理控制器(BMC)的主机。控制节点在受管节点上执行 playbook。受管主机连接到远程 BMC ,以执行 IPMI 操作。例如,如果您在 playbook 中设置了 hosts: managed-node-01.example.comname: server.example.com,则 managed-node-01.example.com 会使用 server.example.com 上的 IPMI 更改设置。

先决条件

  • 您已准备好控制节点和受管节点
  • 您以可在受管主机上运行 playbook 的用户身份登录到控制节点。
  • 您用于连接到受管节点的帐户对它们具有 sudo 权限。
  • ansible-collection-redhat-rhel_mgmt 软件包已安装在控制节点上。
  • 您有访问 BMC 的凭证,这些凭证有更改设置的权限。
  • 受管节点可以通过网络访问远程 BMC。

流程

  1. 将敏感变量存储在加密的文件中:

    1. 创建 vault :

      $ ansible-vault create ~/vault.yml
      New Vault password: <vault_password>
      Confirm New Vault password: <vault_password>
      Copy to Clipboard Toggle word wrap
    2. ansible-vault create 命令打开编辑器后,以 <key>: <value> 格式输入敏感数据:

      ipmi_usr: <username>
      ipmi_pwd: <password>
      Copy to Clipboard Toggle word wrap
    3. 保存更改,并关闭编辑器。Ansible 加密 vault 中的数据。
  2. 创建一个包含以下内容的 playbook 文件,如 ~/playbook.yml

    ---
    - name: Configure the system state by using IPMI
      hosts: managed-node-01.example.com
      vars_files:
        - ~/vault.yml
      tasks:
        - name: Install python3-pyghmi prerequisite
          ansible.builtin.dnf:
            name: python3-pyghmi
            state: latest
    
        - name: Ensure a machine is powered on
          redhat.rhel_mgmt.ipmi_power:
            name: <bmc_hostname_or_ip_address>
            port: <bmc_port_number>
            user: "{{ ipmi_usr }}"
            password: "{{ ipmi_pwd }}"
            state: on
    Copy to Clipboard Toggle word wrap

    示例 playbook 中指定的设置包括如下:

    name: <bmc_hostname_or_ip_address>
    定义 BMC 的主机名或 IP 地址。这是受管节点在其上执行操作的主机的 BMC。
    port: <bmc_port_number>
    设置远程管理控制协议(RMCP)端口号。默认值为 623
    state: <value>

    设置设备应处于的状态。您可以选择以下值之一:

    • on :打开系统的电源。
    • ff :在不通知操作系统的情况下关闭系统。
    • shutdown :从操作系统请求关闭。
    • reset :执行硬重置。
    • boot : 如果系统已关闭,打开系统电源,或如果系统已关闭,重置系统。

    如需关于 playbook 中使用的所有变量的详细信息,请在控制节点上使用 ansible-doc redhat.rhel_mgmt.ipmi_power 命令显示模块的文档。

  3. 验证 playbook 语法:

    $ ansible-playbook --ask-vault-pass --syntax-check ~/playbook.yml
    Copy to Clipboard Toggle word wrap

    请注意,这个命令只验证语法,不能防止错误的、但有效的配置。

  4. 运行 playbook:

    $ ansible-playbook --ask-vault-pass ~/playbook.yml
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat