community.vmware.vmware_host_sriov 模块 – 管理主机上的 SR-IOV 设置

注意

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

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

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

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

摘要 

此模块可用于配置、启用或禁用 ESXi 主机上的 SR-IOV 功能。
模块在更改后不会重新启动主机，但会将其置于输出“rebootRequired”状态。
用户可以指定 ESXi 主机名或集群名称。如果是集群名称，则会更新所有 ESXi 主机。

参数 

参数	注释
cluster_name 字符串	将从中使用所有主机系统的集群名称。如果未指定 `esxi_hostname`，则需要此参数。
esxi_hostname 字符串	要使用的主机系统的名称。如果未指定 `cluster_name`，则需要此参数。用户可以指定集群中的特定主机。
hostname 字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。如果任务中未指定该值，则将改用环境变量 `VMWARE_HOST` 的值。
num_virt_func 整数 / 必需	要在接口上激活的功能数量。 0 表示 SR-IOV 已禁用。大于 0 的数字表示 SR-IOV 已启用。
password 别名：pass，pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。如果任务中未指定该值，则将改用环境变量 `VMWARE_PASSWORD` 的值。
port 整数	vSphere vCenter 或 ESXi 服务器的端口号。如果任务中未指定该值，则将改用环境变量 `VMWARE_PORT` 的值。默认值： `443`
proxy_host 字符串	将接收所有 HTTPS 请求并转发它们的代理的地址。格式为主机名或 IP。如果任务中未指定该值，则将改用环境变量 `VMWARE_PROXY_HOST` 的值。
proxy_port 整数	将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。如果任务中未指定该值，则将改用环境变量 `VMWARE_PROXY_PORT` 的值。
sriov_on 布尔值	可选参数，与 `num_virt_func` 相关。只有当 `num_virt_func` > 0 时才能启用 SR-IOV。选项 `false` `true`
username 别名：admin，user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。如果任务中未指定该值，则将改用环境变量 `VMWARE_USER` 的值。
validate_certs 布尔值	允许在SSL证书无效时连接。当证书不受信任时，将其设置为`false`。如果任务中未指定此值，则将使用环境变量`VMWARE_VALIDATE_CERTS`的值。选项 `false` `true` ← (默认)
vmnic 字符串 / 必填	接口名称，例如vmnic0。

备注 

注意

所有模块都需要API写入权限，因此在免费ESXi许可证上不受支持。
所有变量和VMware对象名称都区分大小写。

示例 

- name: enable SR-IOV on vmnic0 with 8 functions
  community.vmware.vmware_host_sriov:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    esxi_hostname: "{{ esxi1 }}"
    vmnic: vmnic0
    sriov_on: true
    num_virt_func: 8

- name: enable SR-IOV on already enabled interface vmnic0
  community.vmware.vmware_host_sriov:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    esxi_hostname: "{{ esxi1 }}"
    vmnic: vmnic0
    sriov_on: true
    num_virt_func: 8

- name: enable SR-IOV on vmnic0 with big number of functions
  community.vmware.vmware_host_sriov:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    esxi_hostname: "{{ esxi1 }}"
    vmnic: vmnic0
    sriov_on: true
    num_virt_func: 100
  ignore_errors: true

- name: disable SR-IOV on vmnic0
  community.vmware.vmware_host_sriov:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    esxi_hostname: "{{ esxi1 }}"
    vmnic: vmnic0
    sriov_on: false
    num_virt_func: 0

返回值 

常用的返回值已在此处记录，以下是此模块特有的字段

键

描述

host_sriov_diff

字典

包含关于vmnic上SR-IOV状态的before、after和requested更改的信息

有时vCenter会缓慢更新信息，“after”包含与“before”相同的信息，需要在check_mode下再次运行或根据ESXi的要求重新启动主机。

返回值：始终

示例： {"changed": true, "diff": {"after": {"host_test": {"maxVirtualFunctionSupported": 63, "numVirtualFunction": 0, "numVirtualFunctionRequested": 8, "rebootRequired": true, "sriovActive": false, "sriovCapable": true, "sriovEnabled": true}}, "before": {"host_test": {"maxVirtualFunctionSupported": 63, "numVirtualFunction": 0, "numVirtualFunctionRequested": 0, "rebootRequired": false, "sriovActive": false, "sriovCapable": true, "sriovEnabled": false}}, "changes": {"host_test": {"numVirtualFunction": 8, "rebootRequired": true, "sriovEnabled": true}}}}

作者

Viktor Tsymbalyuk (@victron)