community.vmware.vmware_host_tcpip_stacks 模块 – 管理 ESXi 主机的 TCP/IP 堆栈配置

注意

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

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

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

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

概要 

此模块可用于修改 TCP/IP 堆栈配置。

参数 

参数	注释
默认字典	默认的 TCP/IP 堆栈配置。
备用DNS 字符串	备用DNS服务器的IP地址。
拥塞算法字符串	TCP 拥塞控制算法。选项 `"newreno"` ← (默认) `"cubic"`
域名字符串 / 必需	DNS名称的域名部分。
网关字符串	IPv4 网关地址。
主机名字符串 / 必需	ESXi 主机的主机名。
IPv6 网关字符串	IPv6 网关地址。
最大连接数整数	请求的套接字连接的最大数量。默认值： `11000`
首选DNS 字符串	首选DNS服务器的IP地址。
搜索域名列表 / 元素=字符串	用于搜索主机的域名，按优先级顺序排列。默认值： `[]`
ESXi 主机名字符串 / 必需	ESXi 主机的名称。
主机名字符串	vSphere vCenter 或 ESXi 服务器的主机名或 IP 地址。如果任务中未指定此值，则将改用环境变量 `VMWARE_HOST` 的值。
密码别名：pass，pwd 字符串	vSphere vCenter 或 ESXi 服务器的密码。如果任务中未指定此值，则将改用环境变量 `VMWARE_PASSWORD` 的值。
端口整数	vSphere vCenter 或 ESXi 服务器的端口号。如果任务中未指定此值，则将改用环境变量 `VMWARE_PORT` 的值。默认值： `443`
配置字典	配置的 TCP/IP 堆栈配置。
拥塞算法字符串	TCP 拥塞控制算法。选项 `"newreno"` ← (默认) `"cubic"`
网关字符串	IPv4 网关地址。
IPv6 网关字符串	IPv6 网关地址。
最大连接数整数	请求的套接字连接的最大数量。默认值： `11000`
代理主机字符串	将接收所有 HTTPS 请求并转发它们的代理的地址。格式为主机名或 IP。如果任务中未指定此值，则将改用环境变量 `VMWARE_PROXY_HOST` 的值。
代理端口整数	将接收所有 HTTPS 请求并转发它们的 HTTP 代理的端口。如果任务中未指定此值，则将改用环境变量 `VMWARE_PROXY_PORT` 的值。
用户名别名：admin，user 字符串	vSphere vCenter 或 ESXi 服务器的用户名。如果任务中未指定此值，则将改用环境变量 `VMWARE_USER` 的值。
验证证书布尔值	当 SSL 证书无效时允许连接。当证书不受信任时，设置为 `false`。如果任务中未指定此值，则将改用环境变量 `VMWARE_VALIDATE_CERTS` 的值。选项 `false` `true` ← (默认)
vMotion 字典	vMotion 的 TCP/IP 堆栈配置。
拥塞算法字符串	TCP 拥塞控制算法。选项 `"newreno"` ← (默认) `"cubic"`
网关字符串	IPv4 网关地址。
IPv6 网关字符串	IPv6 网关地址。
最大连接数整数	请求的套接字连接的最大数量。默认值： `11000`
VXLAN 别名：nsx_overlay 字典	VXLAN 的 TCP/IP 堆栈配置。
拥塞算法字符串	TCP 拥塞控制算法。选项 `"newreno"` ← (默认) `"cubic"`
网关字符串	IPv4 网关地址。
IPv6 网关字符串	IPv6 网关地址。
最大连接数整数	请求的套接字连接的最大数量。默认值： `11000`

备注 

注意

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

示例 

- name: Update the TCP/IP stack configuration of the default
  community.vmware.vmware_host_tcpip_stacks:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    validate_certs: false
    esxi_hostname: "{{ esxi_hostname }}"
    default:
      hostname: "{{ esxi_hostname }}"
      domain: example.com
      preferred_dns: 192.168.10.1
      alternate_dns: 192.168.20.1
      search_domains:
        - hoge.com
        - fuga.com
      gateway: 192.168.10.1
      congestion_algorithm: cubic
      max_num_connections: 12000

- name: Update the TCP/IP stack configuration of the provisioning
  community.vmware.vmware_host_tcpip_stacks:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    validate_certs: false
    esxi_hostname: "{{ esxi_hostname }}"
    provisioning:
      congestion_algorithm: newreno
      max_num_connections: 12000
      gateway: 10.10.10.254

- name: Update the TCP/IP stack configuration of the default and provisioning
  community.vmware.vmware_host_tcpip_stacks:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    validate_certs: false
    esxi_hostname: "{{ esxi_hostname }}"
    default:
      hostname: "{{ esxi_hostname }}"
      domain: example.com
      preferred_dns: 192.168.10.1
      alternate_dns: 192.168.20.1
      search_domains:
        - hoge.com
        - fuga.com
      gateway: 192.168.10.1
      congestion_algorithm: cubic
      max_num_connections: 12000
    provisioning:
      congestion_algorithm: newreno
      max_num_connections: 12000
      gateway: 10.10.10.254

- name: Update the ipv6 gateway of the provisioning TCP/IP stack
  community.vmware.vmware_host_tcpip_stacks:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    validate_certs: false
    esxi_hostname: "{{ esxi_hostname }}"
    provisioning:
      ipv6_gateway: ::ffff:6440:301

返回值 

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

键	描述
默认字典	默认TCP/IP堆栈配置的字典。返回值：始终示例： `"{\n \"alternate_dns\": \"192.168.20.1\",\n \"congestion_algorithm\": \"cubic\",\n \"domain\": \"example.com\",\n \"gateway\": \"192.168.10.1\",\n \"ipv6_gateway\", null,\n \"hostname\": \"esxi-test03\",\n \"max_num_connections\": 12000,\n \"preferred_dns\": \"192.168.10.1\",\n \"search_domains\": [\n \"hoge.com\",\n \"fuga.com\"\n ]\n}"`
配置字典	配置供应程序的 TCP/IP 协议栈的字典。返回值：始终示例： `{"congestion_algorithm": "newreno", "gateway": "10.10.10.254", "ipv6_gateway": null, "max_num_connections": 12000}`
vMotion 字典	配置 vMotion 的 TCP/IP 协议栈的字典。返回值：始终示例： `{"congestion_algorithm": "newreno", "gateway": null, "ipv6_gateway": null, "max_num_connections": 11000}`
VXLAN 字典	配置 VXLAN 的 TCP/IP 协议栈的字典。返回值：始终示例： `{"congestion_algorithm": "newreno", "gateway": null, "ipv6_gateway": null, "max_num_connections": 11000}`

作者

sky-joker (@sky-joker)