Модуль community.vmware.vmware_dvswitch_lacp — Управление конфигурацией LACP на распределённом коммутаторе

Примечание

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

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

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

Для использования в плейбуке укажите: community.vmware.vmware_dvswitch_lacp.

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

Обзор

Этот модуль может использоваться для настройки режима поддержки протокола агрегирования каналов Link Aggregation Control Protocol (LACP) и групп агрегирования каналов (LAG).

Параметры

Параметр	Комментарии
hostname строка	Имя хоста или IP-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST` вместо него.
link_aggregation_groups список / элементы=словарь	Может быть использован только если `support_mode=enhanced`. По умолчанию: `[]`
load_balancing_mode строка	Алгоритм балансировки нагрузки. Допустимые значения: srcTcpUdpPort: Номер порта TCP/UDP источника. srcDestIpTcpUdpPortVlan: IP-адрес источника и назначения, номер порта TCP/UDP источника и назначения и VLAN. srcIpVlan: IP-адрес источника и VLAN. srcDestTcpUdpPort: Номера портов TCP/UDP источника и назначения. srcMac: MAC-адрес источника. destIp: IP-адрес назначения. destMac: MAC-адрес назначения. vlan: Только VLAN. srcDestIp: IP-адреса источника и назначения. srcIpTcpUdpPortVlan: IP-адрес источника, номер порта TCP/UDP и VLAN. srcDestIpTcpUdpPort: IP-адреса источника и назначения и номера портов TCP/UDP. srcDestMac: MAC-адреса источника и назначения. destIpTcpUdpPort: IP-адрес назначения и номера портов TCP/UDP. srcPortId: ID виртуального порта источника. srcIp: IP-адрес источника. srcIpTcpUdpPort: IP-адрес источника и номера портов TCP/UDP. destIpTcpUdpPortVlan: IP-адрес назначения, номер порта TCP/UDP и VLAN. destTcpUdpPort: Номер порта TCP/UDP назначения. destIpVlan: IP-адрес назначения и VLAN. srcDestIpVlan: IP-адреса источника и назначения и VLAN. Дополнительную информацию см. в примерах. По умолчанию: `"srcDestIpTcpUdpPortVlan"`
mode строка	Состояние согласования каналов/портов. Доступные значения: `"active"` `"passive"`
name строка	Имя LAG.
uplink_number целое число	Количество каналов. От 1 до 30.
password псевдонимы: pass, pwd строка	Пароль сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD` вместо него.
port целое число	Номер порта сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT` вместо него. По умолчанию: `443`
proxy_host строка	Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их. Формат - имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST` вместо него.
proxy_port целое число	Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT` вместо него.
support_mode строка	Режим поддержки LACP. `basic`: Одна группа протокола Link Aggregation Control в коммутаторе (singleLag). `enhanced`: Несколько групп протокола Link Aggregation Control в коммутаторе (multipleLag). Доступные значения: `"basic"` ← (по умолчанию) `"enhanced"`
switch псевдонимы: dvswitch строка / обязательно	Имя распределённого коммутатора для управления.
username псевдонимы: admin, user строка	Имя пользователя сервера vCenter vSphere или ESXi. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER` вместо него.
validate_certs булево	Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в `false`, когда сертификаты не доверяются. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS` вместо него. Доступные значения: `false` `true` ← (по умолчанию)

Примечания

Примечание

Необходимо выполнить задачу дважды, если требуется удалить все LAG и изменить режим поддержки на «basic»
Все модули требуют доступа к API для записи и поэтому не поддерживаются в бесплатной лицензии ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.

Примеры

- name: Enable enhanced mode on a Distributed Switch
  community.vmware.vmware_dvswitch_lacp:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    support_mode: enhanced
    validate_certs: "{{ validate_vcenter_certs }}"
  delegate_to: localhost
  loop_control:
    label: "{{ item.name }}"
  with_items: "{{ vcenter_distributed_switches }}"

- name: Enable enhanced mode and create two LAGs on a Distributed Switch
  community.vmware.vmware_dvswitch_lacp:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    support_mode: enhanced
    link_aggregation_groups:
        - name: lag1
          uplink_number: 2
          mode: active
          load_balancing_mode: srcDestIpTcpUdpPortVlan
        - name: lag2
          uplink_number: 2
          mode: passive
          load_balancing_mode: srcDestIp
    validate_certs: "{{ validate_vcenter_certs }}"
  delegate_to: localhost
  loop_control:
    label: "{{ item.name }}"
  with_items: "{{ vcenter_distributed_switches }}"

Значения возврата

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

Ключ	Описание
result строка	информация об операции Возвращается: всегда Пример: `"{'changed': True, 'dvswitch': 'dvSwitch', 'link_aggregation_groups': [{'load_balancing_mode': 'srcDestIpTcpUdpPortVlan', 'mode': 'active', 'name': 'lag1', 'uplink_number': 2}, {'load_balancing_mode': 'srcDestIp', 'mode': 'active', 'name': 'lag2', 'uplink_number': 2}], 'link_aggregation_groups_previous': [], 'result': 'lacp lags changed', 'support_mode': 'enhanced'}"`

Ключ

Описание

result

строка

информация об операции

Возвращается: всегда

Пример: "{'changed': True, 'dvswitch': 'dvSwitch', 'link_aggregation_groups': [{'load_balancing_mode': 'srcDestIpTcpUdpPortVlan', 'mode': 'active', 'name': 'lag1', 'uplink_number': 2}, {'load_balancing_mode': 'srcDestIp', 'mode': 'active', 'name': 'lag2', 'uplink_number': 2}], 'link_aggregation_groups_previous': [], 'result': 'lacp lags changed', 'support_mode': 'enhanced'}"

Авторы

Christian Kotte (@ckotte)

Ссылки на сборку

© 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_dvswitch_lacp_module.html