vmware_dvswitch_lacp – Управление конфигурацией LACP на распределённом коммутаторе
Новая в версии 2.8.
Обзор
- Этот модуль можно использовать для настройки режима поддержки протокола агрегирования каналов 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. Требуются следующие параметры: - name (строка): Название LAG.- uplink_number (целое число): Количество каналов. От 1 до 30.- mode (строка): Режим согласования каналов/портов.- варианты: [ active, passive ] - 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 или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлено в 2.5 | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT. Поддержка переменных окружения добавлена в Ansible 2.6. |
| support_mode строка |
| Режим поддержки LACP. basic: Одна группа Link Aggregation Control Protocol на коммутаторе (singleLag).enhanced: Несколько групп Link Aggregation Control Protocol на коммутаторе (multipleLag). |
| switch - / обязательно | Имя распределённого коммутатора для управления. псевдонимы: dvswitch | |
| username строка | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs булево |
| Разрешает подключение, когда сертификаты 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': 'active', 'name': 'lag1', 'uplink_number': 2}, {'load_balancing_mode': 'srcDestIp', 'mode': 'active', 'name': 'lag2', 'uplink_number': 2}], 'link_aggregation_groups_previous': [], 'support_mode': 'enhanced', 'result': 'lacp lags changed'} |
Статус
- Гарантируется, что этот модуль не будет иметь обратной совместимости. [предварительная версия]
- Этот модуль поддерживается сообществом 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.8/modules/vmware_dvswitch_lacp_module.html
