Модуль community.vmware.vmware_host_tcpip_stacks — управление конфигурацией стеков TCP/IP узла ESXi

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_host_tcpip_stacks.

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет изменять конфигурацию стеков TCP/IP.

Параметры

Параметр	Комментарии
default словарь	Конфигурация стеков TCP/IP для default.
alternate_dns строка	IP-адрес альтернативного DNS-сервера.
congestion_algorithm строка	Алгоритм управления перегрузкой TCP. Варианты: `"newreno"` ← (по умолчанию) `"cubic"`
domain строка / обязательный	Доменная часть имени DNS.
gateway строка	Адрес шлюза IPv4.
hostname строка / обязательный	Имя узла ESXi.
ipv6_gateway строка	Адрес шлюза IPv6.
max_num_connections целое число	Максимальное количество запрашиваемых подключений сокетов. По умолчанию: `11000`
preferred_dns строка	IP-адрес предпочтительного DNS-сервера.
search_domains список / элементы типа string	Домены для поиска узлов, перечисленные в порядке предпочтения. По умолчанию: `[]`
esxi_hostname строка / обязательный	Имя узла ESXi.
hostname строка	Имя узла или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_HOST`.
password псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PASSWORD`.
port целое число	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PORT`. По умолчанию: `443`
provisioning словарь	Конфигурация стеков TCP/IP для provisioning.
congestion_algorithm строка	Алгоритм управления перегрузкой TCP. Варианты: `"newreno"` ← (по умолчанию) `"cubic"`
gateway строка	Адрес шлюза IPv4.
ipv6_gateway строка	Адрес шлюза IPv6.
max_num_connections целое число	Максимальное количество запрашиваемых подключений сокетов. По умолчанию: `11000`
proxy_host строка	Адрес прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Формат: имя узла или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PROXY_HOST`.
proxy_port целое число	Порт HTTP-прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_PROXY_PORT`.
username псевдонимы: admin, user строка	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_USER`.
validate_certs логическое значение	Разрешает подключение при недействительных SSL-сертификатах. Если сертификаты не являются доверенными, задайте значение `false`. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
vmotion словарь	Конфигурация стеков TCP/IP для vmotion.
congestion_algorithm строка	Алгоритм управления перегрузкой TCP. Варианты: `"newreno"` ← (по умолчанию) `"cubic"`
gateway строка	Адрес шлюза IPv4.
ipv6_gateway строка	Адрес шлюза IPv6.
max_num_connections целое число	Максимальное количество запрашиваемых подключений сокетов. По умолчанию: `11000`
vxlan псевдоним: nsx_overlay словарь	Конфигурация стеков TCP/IP для vxlan.
congestion_algorithm строка	Алгоритм управления перегрузкой TCP. Варианты: `"newreno"` ← (по умолчанию) `"cubic"`
gateway строка	Адрес шлюза IPv4.
ipv6_gateway строка	Адрес шлюза IPv6.
max_num_connections целое число	Максимальное количество запрашиваемых подключений сокетов. По умолчанию: `11000`

Примечания

Примечание

Для всех модулей требуется доступ на запись через API, поэтому они не поддерживаются при бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Вы можете указать хранилище сертификатов, задав переменную окружения REQUESTS_CA_BUNDLE. Обратите внимание, что при наличии этой переменной в некоторых случаях значение ‘false’ параметра ‘validate_certs’ может быть проигнорировано. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- 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

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
default словарь	Словарь с конфигурацией стека 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}"`
provisioning словарь	Словарь с конфигурацией стека TCP/IP для provisioning. Возвращается: всегда Пример: `{"congestion_algorithm": "newreno", "gateway": "10.10.10.254", "ipv6_gateway": null, "max_num_connections": 12000}`
vmotion словарь	Словарь с конфигурацией стека TCP/IP для vmotion. Возвращается: всегда Пример: `{"congestion_algorithm": "newreno", "gateway": null, "ipv6_gateway": null, "max_num_connections": 11000}`
vxlan словарь	Словарь с конфигурацией стека TCP/IP для vxlan. Возвращается: всегда Пример: `{"congestion_algorithm": "newreno", "gateway": null, "ipv6_gateway": null, "max_num_connections": 11000}`

Авторы

sky-joker (@sky-joker)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_host_tcpip_stacks_module.html