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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.vmware.

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

Обзор
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

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

Параметры

Параметр	Комментарии
default словарь	Конфигурация стека TCP/IP для по умолчанию.
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 список / элементы=строка	Домены, в которых нужно искать хосты, в порядке приоритета. По умолчанию: `[]`
esxi_hostname строка / обязательно	Имя хоста ESXi.
hostname строка	Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_HOST`.
пароль псевдонимы: pass, pwd строка	Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `VMWARE_PASSWORD`.
порт целое число	Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `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`.

логин псевдонимы: admin, пользователь строка	Имя пользователя сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения `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 чувствительны к регистру.

Примеры

- 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 для развёртывания. Возвращается: всегда Пример: `{"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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_host_tcpip_stacks_module.html