Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию community.vmware (версия 4.7.1).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для её установки используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_dvswitch.

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Обзор

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

Параметры

Параметр

Комментарии

контакт

словарь

Словарь, который настраивает имя и описание контакта администратора для распределенного коммутатора.

описание

строка

Описание или другие детали.

имя

строка

Имя администратора.

имя_датацентра

алиасы: датацентр

строка

Имя датацентра, который будет содержать распределенный коммутатор.

Требуется, если folder не указан.

Исключает параметр folder.

описание

строка

Описание распределенного коммутатора.

операция_обнаружения

строка

Выберите операцию обнаружения.

Требуется, если state=present.

Варианты:

  • "both"
  • "advertise"
  • "listen" ← (по умолчанию)

протокол_обнаружения

алиасы: протокол_обнаружения

строка

Протокол обнаружения связи между Cisco и обнаружением на уровне канала.

Требуется, если state=present.

cdp: Используйте Cisco Discovery Protocol (CDP).

lldp: Используйте Link Layer Discovery Protocol (LLDP).

disabled: Не используйте протокол обнаружения.

Варианты:

  • "cdp" ← (по умолчанию)
  • "lldp"
  • "disabled"

папка

строка

Папка назначения, абсолютный путь для размещения dvswitch.

Папка должна включать датацентр.

Требуется, если datacenter не указан.

Исключает параметр datacenter.

Примеры:

папка: /datacenter1/сеть

папка: datacenter1/сеть

папка: /datacenter1/сеть/папка1

папка: datacenter1/сеть/папка1

папка: /папка1/datacenter1/сеть

папка: папка1/datacenter1/сеть

папка: /папка1/datacenter1/сеть/папка2

контроль_состояния

словарь

Словарь, который настраивает контроль состояния распределенного коммутатора.

По умолчанию: {"teaming_failover": false, "teaming_failover_interval": 0, "vlan_mtu": false, "vlan_mtu_interval": 0}

команда_сбой_сбой

логическое

Контроль состояния Teaming и failover.

Варианты:

  • false ← (по умолчанию)
  • true

интервал_команда_сбой_сбой

целое число

Интервал контроля состояния Teaming и failover (минуты).

Значение по умолчанию равно 1 в клиенте vSphere, если включен контроль состояния Teaming и failover.

По умолчанию: 0

vlan_mtu

логическое

Контроль состояния VLAN и MTU.

Варианты:

  • false ← (по умолчанию)
  • true

интервал_vlan_mtu

целое число

Интервал контроля состояния VLAN и MTU (минуты).

Значение по умолчанию равно 1 в клиенте vSphere, если включен контроль состояния VLAN и MTU.

По умолчанию: 0

имя_хоста

строка

Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.

Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_HOST.

mtu

целое число

Максимальный размер блока передачи данных коммутатора.

Требуется, если state=present.

Принимает значения от 1280 до 9000 (включительно).

По умолчанию: 1500

режим_фильтрации_многоадресной_рассылки

строка

Режим фильтрации многоадресной рассылки.

Режим basic: трафик многоадресной рассылки для виртуальных машин пересылается в соответствии с MAC-адресом назначения многоадресной группы.

Режим snooping: распределенный коммутатор обеспечивает IGMP и MLD snooping в соответствии с RFC 4541.

Варианты:

  • "basic" ← (по умолчанию)
  • "snooping"

сетевой_поток

словарь

Словарь, который настраивает сетевой поток для распределенного коммутатора.

По умолчанию: {"active_flow_timeout": 60, "collector_port": 0, "idle_flow_timeout": 15, "internal_flows_only": false, "observation_domain_id": 0, "sampling_rate": 4096}
END_OF_DOCUMENT_MARKER

active_flow_timeout

integer

Время в секундах ожидания отправки информации после инициализации потока.

По умолчанию: 60

collector_ip

string

IP-адрес (IPv4 или IPv6) коллектора NetFlow.

collector_port

integer

Порт коллектора NetFlow.

По умолчанию: 0

idle_flow_timeout

integer

Время в секундах ожидания отправки информации после инициализации потока.

По умолчанию: 15

internal_flows_only

boolean

Если True, данные о сетевой активности между ВМ на одном хосте будут собираться только.

Варианты:

  • false ← (по умолчанию)
  • true

observation_domain_id

integer

Идентифицирует информацию, относящуюся к коммутатору.

По умолчанию: 0

sampling_rate

integer

Часть данных, которую собирает коммутатор.

Частота выборки представляет количество пакетов, которые NetFlow пропускает после каждого собранного пакета.

Если частота равна 0, NetFlow выбирает каждый пакет, то есть собирает один пакет и не пропускает ни одного.

Если частота равна 1, NetFlow выбирает один пакет и пропускает следующий, и так далее.

По умолчанию: 4096

switch_ip

string

added in community.vmware 4.3.0

Назначьте IP-адрес, чтобы увидеть распределённый коммутатор как одно сетевое устройство в коллекторе NetFlow.

Вместо нескольких устройств, соответствующих каждому хосту.

В среде IPv6 хосты ESXi игнорируют IP-адрес коммутатора.

network_policy

dictionary

Словарь, который настраивает различные значения безопасности по умолчанию для групп портов.

Если установлено, эти параметры наследуются группами портов DVS.

forged_transmits

boolean

Указывает, разрешены ли поддельные передачи.

Варианты:

  • false ← (по умолчанию)
  • true

mac_changes

boolean

Указывает, разрешены ли изменения MAC-адресов.

Варианты:

  • false ← (по умолчанию)
  • true

promiscuous

boolean

Указывает, разрешен ли режим promiscuous.

Варианты:

  • false ← (по умолчанию)
  • true

password

aliases: pass, pwd

string

Пароль сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD вместо этого.

port

integer

Порт сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT вместо этого.

По умолчанию: 443

proxy_host

string

Адрес прокси-сервера, который будет получать все запросы HTTPS и перенаправлять их.

Формат — имя хоста или IP-адрес.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_HOST вместо этого.

proxy_port

integer

Порт HTTP-прокси, который будет получать все запросы HTTPS и перенаправлять их.

Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_PORT вместо этого.

state

string

Если установлено значение present, и распределённый коммутатор не существует, он будет создан.

Если установлено значение absent, и распределённый коммутатор существует, он будет удалён.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

switch_name

aliases: switch, dvswitch

string / обязательно

Имя распределенного коммутатора vSwitch для создания или удаления.

switch_version

aliases: version

string

Версия распределенного коммутатора для создания.

Версия должна соответствовать версии хостов ESXi, с которыми вы хотите подключиться.

Если не указано, используется версия сервера vCenter.

Требуется, если state=present.

uplink_prefix

string

Префикс, используемый для наименования каналов связи.

Действителен только при создании распределенного коммутатора. Не используется, если распределенный коммутатор уже существует.

Каналы связи создаются по умолчанию как Uplink 1, Uplink 2 и т. д.

По умолчанию: "Uplink "

uplink_quantity

целое число

Количество каналов связи на каждый хост ESXi, добавленный в распределенный коммутатор.

Количество каналов связи можно увеличить или уменьшить, но уменьшение будет успешным только в том случае, если канал связи не используется группой портов.

Требуется, если state=present.

username

aliases: admin, user

string

Имя пользователя сервера vCenter vSphere или ESXi.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_USER.

validate_certs

boolean

Разрешает подключение, когда сертификаты SSL недействительны. Устанавливается в false, когда сертификаты не доверяются.

Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Все модули требуют доступа к API для записи и поэтому не поддерживаются в бесплатной лицензии ESXi.
  • Все имена переменных и объектов VMware чувствительны к регистру.

Примеры

- 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
    net_flow:
        collector_ip: 192.168.10.50
        collector_port: 50034
        observation_domain_id: 0
        switch_ip: 192.168.10.40
        active_flow_timeout: 60
        idle_flow_timeout: 15
        sampling_rate: 4096
        internal_flows_only: false
    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

string

Информация об выполненной операции

Возвращается: всегда

Пример: "{'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', 'net_flow_active_flow_timeout': 60, 'net_flow_collector_ip': '192.168.10.50', 'net_flow_collector_port': 50034, 'net_flow_idle_flow_timeout': 15, 'net_flow_internal_flows_only': False, 'net_flow_observation_domain_id': 0, 'net_flow_sampling_rate': 4096, 'net_flow_switch_ip': '192.168.10.40', 'result': 'DVS already configured properly', '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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/vmware/vmware_dvswitch_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API