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

Примечание

Этот плагин входит в коллекцию community.vmware (версия 1.6.0).

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

Чтобы использовать его в playbook, укажите: community.vmware.vmware_dvswitch_lacp.

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

Обзор

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
hostname строка			Имя хоста или IP-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `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 vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число		По умолчанию: 443	Номер порта сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `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`: Одна группа Link Aggregation Control Protocol на коммутаторе (singleLag). `enhanced`: Несколько групп Link Aggregation Control Protocol на коммутаторе (multipleLag).
switch строка / обязательный			Имя распределенного коммутатора для управления. псевдонимы: dvswitch
username строка			Имя пользователя сервера vCenter vSphere или ESXi. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user
validate_certs булево		Варианты: no yes ←	Разрешает подключение, когда сертификаты 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_dvswitch_lacp_module.html