vmware_dvswitch – Создание или удаление распределённого коммутатора
Описание
- Этот модуль можно использовать для создания и удаления распределённого коммутатора.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| contact словарь добавлено в 2.8 | Словарь, который настраивает имя и описание контакта администратора для распределенного коммутатора. Допустимые атрибуты: - name (str): Имя администратора.- description (str): Описание или другие детали. | |
| datacenter_name строка | Имя дата-центра, который будет содержать распределенный коммутатор. Этот параметр необязателен, если folder указан.Исключающий параметр с folder параметром.псевдонимы: datacenter | |
| description строка добавлено в 2.8 | Описание распределенного коммутатора. | |
| 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 Discovery Protocol (CDP).lldp: Использовать протокол Link Layer Discovery Protocol (LLDP).disabled: Не использовать протокол обнаружения.псевдонимы: discovery_protocol |
| folder строка добавлено в 2.9 | Папка назначения, абсолютный путь для размещения 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 словарь добавлено в 2.8 | По умолчанию: {"teaming_failover": false, "teaming_failover_interval": 0, "vlan_mtu": false, "vlan_mtu_interval": 0} | Словарь, который настраивает проверку работоспособности распределенного коммутатора. Допустимые атрибуты: - vlan_mtu (bool): Проверка работоспособности VLAN и MTU. (по умолчанию: False)- teaming_failover (bool): Проверка работоспособности Teaming и failover. (по умолчанию: False)- vlan_mtu_interval (int): Интервал проверки работоспособности VLAN и MTU (минуты). (по умолчанию: 0)- По умолчанию для vlan_mtu_interval - 1 в vSphere Client, если проверка VLAN и MTU включена.- teaming_failover_interval (int): Интервал проверки работоспособности Teaming и failover (минуты). (по умолчанию: 0)- По умолчанию для teaming_failover_interval - 1 в vSphere Client, если проверка Teaming и failover включена. |
| hostname строка | Имя хоста или IP-адрес сервера 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 строка добавлено в 2.8 |
| Режим фильтрации multicast. basic режим: трафик multicast для виртуальных машин пересылается в соответствии с MAC-адресом назначения группы multicast.snooping режим: распределенный коммутатор предоставляет IGMP и MLD snooping в соответствии с RFC 4541. |
| password строка | Пароль сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлено в 2.5 | По умолчанию: 443 | Номер порта сервера vCenter или 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. | |
| state строка |
| Если установлено в present и распределенный коммутатор не существует, то распределенный коммутатор будет создан.Если установлено в absent и распределенный коммутатор существует, то распределенный коммутатор будет удален. |
| switch_name строка / обязательно | Имя распределенного vSwitch для создания или удаления. псевдонимы: switch, dvswitch | |
| switch_version строка добавлено в 2.5 |
| Версия распределенного коммутатора для создания. Может быть 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. Версия должна соответствовать версии ESXi-хостов, с которыми вы хотите подключиться. Если не указано, используется версия сервера vCenter. Требуется только если state установлено в present.псевдонимы: version |
| uplink_prefix строка добавлено в 2.8 | По умолчанию: "Uplink " | Префикс, используемый для именования uplink. Действителен только при создании распределенного коммутатора. Не используется, если распределенный коммутатор уже существует. Uplink создаются как Uplink 1, Uplink 2 и т.д. по умолчанию. |
| uplink_quantity целое число | Количество uplink на ESXi-хост, добавленных к распределенному коммутатору. Количество uplink можно увеличить или уменьшить, но уменьшение будет успешным только если uplink не используется портгруппой. Требуемый параметр для state как present так и absent, до версии Ansible 2.6.Требуется только если state установлено в present, для Ansible 2.6 и выше. |
| Имя пользователя строка | Имя пользователя сервера 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.5 и 6.7
Примеры
- name: Create dvSwitch
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
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
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'} |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.9/modules/vmware_dvswitch_module.html
