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

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.7.0).

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

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

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

Обзор

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

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

python >= 2.6
PyVmomi

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
hostname строка			Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
link_aggregation_groups список / элементы=словарь			Может использоваться только в том случае, если `lacp_support` установлено в `enhanced`.
	load_balancing_mode строка	По умолчанию: "srcDestIpTcpUdpPortVlan"	Алгоритм балансировки нагрузки. Допустимые значения следующие - 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: Идентификатор виртуального порта источника. - srcIp: IP-адрес источника. - srcIpTcpUdpPort: IP-адрес источника и номер порта TCP/UDP. - destIpTcpUdpPortVlan: IP-адрес получателя, номер порта TCP/UDP и VLAN. - destTcpUdpPort: Номер порта TCP/UDP получателя. - destIpVlan: IP-адрес получателя и VLAN. - srcDestIpVlan: IP-адреса источника и получателя и VLAN. Более подробную информацию см. в примерах.
	mode строка	Варианты: active passive	Состояние согласования каналов/портов.
	name строка		Имя группы агрегирования каналов (LAG).
	uplink_number целое число		Количество каналов. От 1 до 30.
password строка			Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число		По умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка			Адрес прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port целое число			Порт HTTP-прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_PROXY_PORT`.
support_mode строка		Варианты: basic ← enhanced	Режим поддержки LACP. `basic`: Одна группа агрегирования каналов LACP в коммутаторе (singleLag). `enhanced`: Несколько групп агрегирования каналов LACP в коммутаторе (multipleLag).
switch строка / требуется			Имя распределённого коммутатора, который необходимо настроить. псевдонимы: dvswitch
username строка			Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево		Варианты: no да ←	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение `false`, когда сертификаты не надёжны. Если значение не указано в задаче, будет использовано значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение `true`, убедитесь, что на данном компьютере установлена Python >= 2.7.9.

Примечания

Примечание

Тестировалось на vSphere 6.7
Для удаления всех групп LAG и изменения режима поддержки на ‘basic’ необходимо выполнить задачу дважды.

Примеры

- 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'}

Авторы

Christian Kotte (@ckotte)

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