community.vmware.vmware_dvswitch – Создание или удаление распределённого коммутатора
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.6.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 и протоколом обнаружения уровня канала. Обязательный параметр для state как present, так и absent, до версии Ansible 2.6.Обязателен только если state задано как present, для Ansible 2.6 и выше.cdp: Используйте протокол обнаружения Cisco (CDP).lldp: Используйте протокол обнаружения уровня канала (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 строка / обязательный | Имя создаваемого или удаляемого распределённого коммутатора vSwitch. Псевдонимы: 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 " | Префикс, используемый для именования каналов связи. Действителен только при создании распределённого коммутатора. Не используется, если распределённый коммутатор уже существует. По умолчанию каналы связи создаются как Uplink 1, Uplink 2 и т. д. | |
| uplink_quantity целое число | Количество каналов связи на один ESXi-хост, добавленное в распределённый коммутатор. Количество каналов связи можно увеличить или уменьшить, но уменьшение возможно только если канал связи не используется группой портов. Обязательный параметр для 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–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_module.html
