vmware_dvswitch_pvlans – Управление конфигурацией частных VLAN на распределённом коммутаторе

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

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

Обзор

Этот модуль может использоваться для конфигурирования частных VLAN (PVLAN) на распределённом коммутаторе.

Требования

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

python >= 2.6
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_HOST`. Поддержка переменных окружения добавлена в Ansible 2.6.
password строка		Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PASSWORD`. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd
port целое число добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PORT`. Поддержка переменных окружения добавлена в Ansible 2.6.
primary_pvlans список	Значение по умолчанию: []	Список идентификаторов VLAN, которые должны быть сконфигурированы как первичные PVLAN. Если `primary_pvlans` не указано, все PVLAN будут удалены, если они присутствуют. Каждый элемент списка требует указания primary_pvlan_id (целое число). Вторичный promiscuous PVLAN будет создан автоматически. Если `secondary_pvlans` не указано, первичные PVLAN и каждый вторичный promiscuous PVLAN будут созданы. Дополнительная информация в примерах.
proxy_host строка добавлено в 2.9		Адрес прокси-сервера, который будет получать все HTTPS-запросы и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PROXY_HOST`. Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12.
proxy_port целое число добавлено в 2.9		Порт HTTP-прокси-сервера, который будет получать все HTTPS-запросы и перенаправлять их. Если значение не указано в задаче, используется значение переменной окружения `VMWARE_PROXY_PORT`.
secondary_pvlans список	Значение по умолчанию: []	Список идентификаторов VLAN, которые должны быть сконфигурированы как вторичные PVLAN. `primary_pvlans` должны быть указаны для создания вторичных PVLAN. Если `primary_pvlans` не указано, все PVLAN будут удалены, если они присутствуют. Каждый элемент списка требует указания primary_pvlan_id (целое число), secondary_pvlan_id (целое число) и pvlan_type (строка). Тип вторичного PVLAN может быть изолированным или общим. Вторичный promiscuous PVLAN будет создан автоматически. Дополнительная информация в примерах.
switch строка / обязательно		Имя распределённого коммутатора. псевдонимы: dvswitch
username строка		Имя пользователя сервера 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 PVLANs on a Distributed Switch
  vmware_dvswitch_pvlans:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    primary_pvlans:
      - primary_pvlan_id: 1
      - primary_pvlan_id: 4
    secondary_pvlans:
      - primary_pvlan_id: 1
        secondary_pvlan_id: 2
        pvlan_type: isolated
      - primary_pvlan_id: 1
        secondary_pvlan_id: 3
        pvlan_type: community
      - primary_pvlan_id: 4
        secondary_pvlan_id: 5
        pvlan_type: community
  delegate_to: localhost

- name: Create primary PVLAN and secondary promiscuous PVLAN on a Distributed Switch
  vmware_dvswitch_pvlans:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    primary_pvlans:
      - primary_pvlan_id: 1
  delegate_to: localhost

- name: Remove all PVLANs from a Distributed Switch
  vmware_dvswitch_pvlans:
    hostname: '{{ inventory_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    primary_pvlans: []
    secondary_pvlans: []
  delegate_to: localhost

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
result строка	всегда	информация об выполненной операции Пример: {'changed': True, 'dvswitch': 'dvSwitch', 'private_vlans': [{'primary_pvlan_id': 1, 'pvlan_type': 'promiscuous', 'secondary_pvlan_id': 1}, {'primary_pvlan_id': 1, 'pvlan_type': 'isolated', 'secondary_pvlan_id': 2}, {'primary_pvlan_id': 1, 'pvlan_type': 'community', 'secondary_pvlan_id': 3}], 'private_vlans_previous': [], 'result': 'Все частные VLAN добавлены'}

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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_pvlans_module.html