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

Новое в версии 2.8.

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

Обзор

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

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
hostname строка		Имя хоста или IP-адрес сервера vCenter vSphere или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
link_aggregation_groups список		Может использоваться только в том случае, если `lacp_support` установлено в `enhanced`. Требуются следующие параметры: - `name` (строка): Имя LAG. - `uplink_number` (целое число): Количество каналов. От 1 до 30. - `mode` (строка): Режим согласования каналов/портов. - варианты: [ активный, пассивный ] - `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: Идентификатор виртуального порта источника. - srcIp: IP-адрес источника. - srcIpTcpUdpPort: IP-адрес источника и номера портов TCP/UDP. - destIpTcpUdpPortVlan: IP-адрес назначения, номер порта TCP/UDP и VLAN. - destTcpUdpPort: Номер порта назначения TCP/UDP. - destIpVlan: IP-адрес назначения и VLAN. - srcDestIpVlan: IP-адреса источника и назначения и VLAN. - По умолчанию в клиенте vSphere используется режим балансировки srcDestIpTcpUdpPortVlan. Для получения дополнительной информации см. примеры.
password строка		Пароль сервера vCenter vSphere или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	По умолчанию: 443	Номер порта сервера vCenter vSphere или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
proxy_host строка добавлено в 2.9		Адрес прокси-сервера, который будет принимать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12
proxy_port целое число добавлено в 2.9		Порт 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. Если установлено в `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

Проверено на vSphere 6.7
Вам нужно выполнить задачу дважды, если вы хотите удалить все LAG и изменить режим поддержки на «basic»

Примеры

- name: Enable enhanced mode on a Distributed Switch
  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
  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': 'активный', 'name': 'lag1', 'uplink_number': 2}, {'load_balancing_mode': 'srcDestIp', 'mode': 'активный', 'name': 'lag2', 'uplink_number': 2}], 'link_aggregation_groups_previous': [], 'support_mode': 'enhanced', 'result': 'lacp lags изменены'}

Статус

Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.9/modules/vmware_dvswitch_lacp_module.html