community.vmware.vmware_dvswitch – Создание или удаление распределённого коммутатора
Примечание
Этот плагин является частью коллекции community.vmware (версия 1.7.0).
Для его установки используйте: ansible-galaxy collection install community.vmware.
Для использования в плейбуке укажите: community.vmware.vmware_dvswitch.
Обзор
- Этот модуль можно использовать для создания и удаления распределённого коммутатора.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| contact словарь | Словарь, который настраивает имя и описание контакта администратора для распределённого коммутатора. | ||
| description строка | Описание или другие детали. | ||
| name строка | Имя администратора. | ||
| datacenter_name строка | Имя ЦОД, который будет содержать распределённый коммутатор. Этот параметр необязателен, если folder предоставлен.Взаимоисключающий с параметром folder. псевдонимы: datacenter | ||
| description строка | Описание распределённого коммутатора. | ||
| discovery_operation строка |
| Выберите операцию обнаружения. Обязательный параметр для state как present, так и absent, до версии Ansible 2.6.Требуется только если state установлено в present, для Ansible 2.6 и выше. | |
| discovery_proto строка |
| Протокол обнаружения связей между Cisco и Link Layer discovery. Обязательный параметр для state как present, так и absent, до версии Ansible 2.6.Требуется только если state установлено в present, для Ansible 2.6 и выше.cdp: Используйте протокол обнаружения Cisco (CDP).lldp: Используйте протокол обнаружения Link Layer (LLDP).disabled: Не использовать протокол обнаружения.псевдонимы: discovery_protocol | |
| folder строка | Папка назначения, абсолютный путь для размещения dvswitch. Папка должна включать ЦОД. Этот параметр чувствителен к регистру. Этот параметр необязателен, если datacenter предоставлен.Примеры: folder: /datacenter1/network folder: datacenter1/network folder: /datacenter1/network/folder1 folder: datacenter1/network/folder1 folder: /folder1/datacenter1/network folder: folder1/datacenter1/network folder: /folder1/datacenter1/network/folder2 | ||
| health_check словарь | По умолчанию: {"teaming_failover": false, "teaming_failover_interval": 0, "vlan_mtu": false, "vlan_mtu_interval": 0} | Словарь, который настраивает проверку работоспособности распределённого коммутатора. | |
| teaming_failover логическое значение |
| Проверка работоспособности объединения и аварийного переключения. | |
| teaming_failover_interval целое число | По умолчанию: 0 | Интервал проверки работоспособности объединения и аварийного переключения (в минутах). Значение по умолчанию равно 1 в клиенте vSphere, если проверка работоспособности объединения и аварийного переключения включена. | |
| vlan_mtu логическое значение |
| Проверка работоспособности VLAN и MTU. | |
| vlan_mtu_interval целое число | По умолчанию: 0 | Интервал проверки работоспособности VLAN и MTU (в минутах). Значение по умолчанию равно 1 в клиенте vSphere, если проверка работоспособности VLAN и MTU включена. | |
| hostname строка | Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в Ansible 2.6. | ||
| mtu целое число | По умолчанию: 1500 | Максимальный размер блока передачи коммутатора. Обязательный параметр для state как present, так и absent, до версии Ansible 2.6.Требуется только если state установлено в present, для Ansible 2.6 и выше.Принимает значения от 1280 до 9000 (включительно). | |
| multicast_filtering_mode строка |
| Режим фильтрации групповых трансляций. basic режим: трафик групповых трансляций для виртуальных машин пересылается в соответствии с MAC-адресом назначения группы групповых трансляций.snooping режим: распределённый коммутатор предоставляет IGMP и MLD snooping в соответствии с RFC 4541. | |
| password строка | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | ||
| port целое число | По умолчанию: 443 | Номер порта сервера vSphere vCenter или 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. | ||
| state строка |
| Если установлено в present, и распределённый коммутатор не существует, распределённый коммутатор будет создан.Если установлено в absent, и распределённый коммутатор существует, распределённый коммутатор будет удалён. | |
| switch_name строка / обязательный | Имя создаваемого или удаляемого распределённого коммутатора. псевдонимы: switch, dvswitch | ||
| switch_version строка |
| Версия создаваемого распределённого коммутатора. Может быть 6.0.0, 5.5.0, 5.1.0, 5.0.0 с vCenter, работающим на vSphere 6.0 и 6.5. Может быть 6.6.0, 6.5.0, 6.0.0 с vCenter, работающим на vSphere 6.7. Может быть 7.0.0, 6.6.0, 6.5.0 с vCenter, работающим на vSphere 7.0. Версия должна соответствовать версии ESXi-хостов, с которыми нужно подключиться. Если не указано, используется версия сервера vCenter. Требуется только если state установлено в present.псевдонимы: version | |
| uplink_prefix строка | По умолчанию: "Uplink " | Префикс, используемый для именования uplinks. Действителен только при создании распределённого коммутатора. Не используется, если распределённый коммутатор уже существует. Uplinks создаются как Uplink 1, Uplink 2 и т.д. по умолчанию. | |
| uplink_quantity целое число | Количество uplink на каждом ESXi-хосте, добавленных в распределённый коммутатор. Количество uplink можно увеличить или уменьшить, но уменьшение будет успешным только если uplink не используется какой-либо группой портов. Обязательный параметр для state как present, так и absent, до версии Ansible 2.6.Требуется только если state установлено в present, для Ansible 2.6 и выше. | ||
| username строка | Имя пользователя сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user | ||
| validate_certs логическое значение |
| Разрешает подключение, когда сертификаты SSL не валидны. Установите в false, когда сертификаты не доверяются.Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS. Поддержка переменных окружения добавлена в Ansible 2.6. Если установлено в true, убедитесь, что на данном компьютере установлен Python >= 2.7.9. | |
Примечания
Примечание
- Проверено на vSphere 6.5, 6.7 и 7.0
Примеры
- name: Create dvSwitch
community.vmware.vmware_dvswitch:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter: '{{ datacenter }}'
switch: dvSwitch
version: 6.0.0
mtu: 9000
uplink_quantity: 2
discovery_protocol: lldp
discovery_operation: both
state: present
delegate_to: localhost
- name: Create dvSwitch with all options
community.vmware.vmware_dvswitch:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter: '{{ datacenter }}'
switch: dvSwitch
version: 6.5.0
mtu: 9000
uplink_quantity: 2
uplink_prefix: 'Uplink_'
discovery_protocol: cdp
discovery_operation: both
multicast_filtering_mode: snooping
health_check:
vlan_mtu: true
vlan_mtu_interval: 1
teaming_failover: true
teaming_failover_interval: 1
state: present
delegate_to: localhost
- name: Delete dvSwitch
community.vmware.vmware_dvswitch:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
datacenter: '{{ datacenter }}'
switch: dvSwitch
state: absent
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие — поля, уникальные для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| result строка | всегда | информация об операции Пример: {'changed': False, 'contact': None, 'contact_details': None, 'description': None, 'discovery_operation': 'both', 'discovery_protocol': 'cdp', 'dvswitch': 'test', 'health_check_teaming': False, 'health_check_teaming_interval': 0, 'health_check_vlan': False, 'health_check_vlan_interval': 0, 'mtu': 9000, 'multicast_filtering_mode': 'basic', 'result': 'DVS уже правильно настроен', 'uplink_quantity': 2, 'uplinks': ['Uplink_1', 'Uplink_2'], 'version': '6.6.0'} |
Авторы
- Joseph Callen (@jcpowermac)
- Abhijeet Kasurde (@Akasurde)
- 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_module.html
