vmware_dvswitch – Создание или удаление распределённого коммутатора

Новая версия с 2.0.

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

Описание

Этот модуль может использоваться для создания и удаления распределённого коммутатора.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
contact словарь добавлено в 2.8		Словарь, который настраивает имя и описание контакта администратора для распределённого коммутатора. Допустимые атрибуты: - `name` (str): Имя администратора. - `description` (str): Описание или другие детали.
datacenter_name - / обязательно		Имя центров обработки данных, которое будет содержать распределённый коммутатор. псевдонимы: datacenter
description строка добавлено в 2.8		Описание распределённого коммутатора.
discovery_operation -	Варианты: both advertise listen ←	Выберите операцию обнаружения. Обязательный параметр для `state` both `present` и `absent`, до версии Ansible 2.6. Обязательно только если `state` установлено в `present`, для Ansible 2.6 и более поздних версий.
discovery_proto -	Варианты: cdp ← lldp disabled	Протокол обнаружения связей между Cisco и Link Layer discovery. Обязательный параметр для `state` both `present` и `absent`, до версии Ansible 2.6. Обязательно только если `state` установлено в `present`, для Ansible 2.6 и более поздних версий. `cdp`: Использовать протокол обнаружения Cisco (CDP). `lldp`: Использовать протокол обнаружения Link Layer (LLDP). `disabled`: Не использовать протокол обнаружения. псевдонимы: discovery_protocol
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` both `present` и `absent`, до версии Ansible 2.6. Обязательно только если `state` установлено в `present`, для Ansible 2.6 и более поздних версий. Принимает значения от 1280 до 9000 (включительно).
multicast_filtering_mode строка добавлено в 2.8	Варианты: basic ← snooping	Режим фильтрации 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.
state -	Варианты: present ← absent	Если установлено в `present` и распределённый коммутатор не существует, то он будет создан. Если установлено в `absent` и распределённый коммутатор существует, то он будет удалён.
switch_name - / обязательно		Имя создаваемого или удаляемого распределённого vSwitch. псевдонимы: switch, dvswitch
switch_version - добавлено в 2.5	5.0.0 5.1.0 5.5.0 6.0.0 6.5.0 6.6.0	Версия распределённого коммутатора для создания. Может быть 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 "	Префикс, используемый для именования uplinks. Действителен только при создании распределённого коммутатора. Не используется, если распределённый коммутатор уже существует. По умолчанию uplinks создаются как Uplink 1, Uplink 2 и т. д.
uplink_quantity -		Количество uplink на каждом ESXi хосте, добавляемых в распределённый коммутатор. Количество uplink можно увеличить или уменьшить, но уменьшение будет успешным только если uplink не используется группой портов. Обязательный параметр для `state` both `present` и `absent`, до версии Ansible 2.6. Обязательно только если `state` установлено в `present`, для Ansible 2.6 и более поздних версий.
username строка		Имя пользователя сервера vCenter или 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.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. [сообщество]

Авторы

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.8/modules/vmware_dvswitch_module.html