23.4. 使用 rhel_mgmt.redfish_info 模块从带外控制器查询信息
您可以使用 redhat.rhel_mgmt 集合的 redfish_info 模块,通过 Redfish API 从带外(OOB)控制器远程查询信息。要显示返回的值,请使用获取的信息注册变量,并显示此变量的内容。
当您使用此 Ansible 模块时,会涉及三个主机:控制节点、受管节点和执行实际操作的 OOB 控制器的主机。控制节点在受管节点上执行 playbook,受管主机使用 Redfish API 连接到远程 OOB 控制器。例如,如果您在 playbook 中设置 hosts: managed-node-01.example.com 和 baseuri: server.example.com,则 managed-node-01.example.com 对 server.example.com 执行操作。
先决条件
- 您已准备好控制节点和受管节点。
- 以可在受管主机上运行 playbook 的用户登录到控制节点。
-
用于连接到受管节点的帐户具有
sudo权限。 -
ansible-collection-redhat-rhel_mgmt软件包安装在控制节点上。 - 您有访问 OOB 控制器的凭证,这些凭证有查询设置的权限。
- 受管节点可以通过网络访问远程 OOB 控制器。
流程
将您的敏感变量存储在一个加密文件中:
创建 vault :
$ ansible-vault create ~/vault.yml New Vault password: <vault_password> Confirm New Vault password: <vault_password>在
ansible-vault create命令打开编辑器后,以<key>: <value>格式输入敏感数据:redfish_usr: <username> redfish_pwd: <password>- 保存更改,并关闭编辑器。Ansible 加密 vault 中的数据。
创建一个包含以下内容的 playbook 文件,如
~/playbook.yml:--- - name: Query information by using the Redfish API hosts: managed-node-01.example.com vars_files: - ~/vault.yml tasks: - name: Get CPU inventory redhat.rhel_mgmt.redfish_info: baseuri: <uri> username: "{{ redfish_usr }}" password: "{{ redfish_pwd }}" category: Systems command: GetCpuInventory register: result - name: Display the fetched information ansible.builtin.debug: msg: "{{ result.redfish_facts.cpu.entries | to_nice_json }}"示例 playbook 中指定的设置包括以下内容:
baseuri: <uri>- 定义 OOB 控制器的 URI。这是受管节点在其上执行操作的主机的 OOB 控制器。
category: < ;value>设置要查询的信息类别。可用的类别如下:
-
帐户:OOB 控制器的用户帐户 -
机箱:与机箱相关的设置 -
Manager: Redfish 服务 -
会话:Redfish 登录会话 -
系统(默认):与机器相关的设置 -
更新:与固件相关的设置 -
All: 来自所有类别的信息.
如果使用列表,您还可以设置多个类别,如
["Systems", "Accounts"]。-
command: <command>- 设置要执行的查询命令。
如需有关 playbook 中使用的所有变量的详细信息,请在控制节点上使用
ansible-doc redhat.rhel_mgmt.redfish_info命令显示模块的文档。验证 playbook 语法:
$ ansible-playbook --ask-vault-pass --syntax-check ~/playbook.yml请注意,这个命令只验证语法,不能防止错误的、但有效的配置。
运行 playbook:
$ ansible-playbook --ask-vault-pass ~/playbook.yml