Spec-Zone.ru › Ansible 2.11

community.vmware.vmware_portgroup – Создать VMware портгруппу

Примечание

Этот плагин является частью коллекции community.vmware (версия 1.7.0).

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

Для использования в книге задач укажите: community.vmware.vmware_portgroup.

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

Описание

  • Создать VMware портгруппу на стандартном VMware коммутаторе (vSS) для указанных ESXi хостов или хостов указанного кластера.

Требования

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

  • python >= 2.6
  • PyVmomi

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cluster_name
строка
Имя кластера для членства хостов.
Портгруппа будет создана на всех хостах указанного кластера.
Этот параметр необходим, если hosts не указан.

Псевдонимы: cluster
hostname
строка
Имя хоста или IP-адрес сервера vSphere vCenter или ESXi.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST.
Поддержка переменных окружения добавлена в Ansible 2.6.
hosts
список / элементы=строка
Список имен хостов, на которых необходимо добавить портгруппу.
Этот параметр необходим, если cluster_name не указан.

Псевдонимы: esxi_hostname
password
строка
Пароль сервера vSphere vCenter или ESXi.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD.
Поддержка переменных окружения добавлена в Ansible 2.6.

Псевдонимы: pass, pwd
port
целое число
По умолчанию:
443
Номер порта сервера vSphere vCenter или ESXi.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT.
Поддержка переменных окружения добавлена в Ansible 2.6.
portgroup
строка / обязательно
Имя добавляемой портгруппы.

Псевдонимы: portgroup_name
proxy_host
строка
Адрес прокси-сервера, который будет принимать все запросы HTTPS и пересылать их.
Формат — имя хоста или IP-адрес.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_HOST.
Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12
proxy_port
целое число
Порт HTTP-прокси-сервера, который будет принимать все запросы HTTPS и пересылать их.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PROXY_PORT.
security
словарь
Политика сети задает параметры безопасности уровня 2 для портгруппы, такие как режим promiscuous, где адаптер гостя прослушивает все пакеты, изменения MAC-адресов и сфальсифицированные передачи.
Словарь, настраивающий различные параметры безопасности для портгруппы.

Псевдонимы: security_policy, network_policy
forged_transmits
булево
    Варианты:
  • no
  • yes
Указывает, разрешены ли сфальсифицированные передачи.
mac_changes
булево
    Варианты:
  • no
  • yes
Указывает, разрешены ли изменения MAC-адресов.
promiscuous_mode
булево
    Варианты:
  • no
  • yes
Указывает, разрешен ли режим promiscuous.
state
строка
    Варианты:
  • present ←
  • absent
Определяет, должна ли портгруппа присутствовать или нет.
switch
строка / обязательно
vSwitch для изменения.

Псевдонимы: switch_name, vswitch
teaming
словарь
Словарь, который настраивает различные параметры объединения для портгруппы.

Псевдонимы: teaming_policy
active_adapters
список / элементы=строка
Список активных адаптеров, используемых для балансировки нагрузки.
Все vmnics используются в качестве активных адаптеров, если active_adapters и standby_adapters не определены.
failback
булево
    Варианты:
  • no
  • yes
Указывает, использовать ли восстановление при восстановлении соединений.
load_balancing
строка
    Варианты:
  • loadbalance_ip
  • loadbalance_srcmac
  • loadbalance_srcid
  • failover_explicit
  • None
Политика объединения сетевых адаптеров.

Псевдонимы: load_balance_policy
network_failure_detection
строка
    Варианты:
  • link_status_only
  • beacon_probing
Обнаружение сбоев в сети.
notify_switches
булево
    Варианты:
  • no
  • yes
Указывает, уведомлять ли физический коммутатор о сбоях в соединении.
standby_adapters
список / элементы=строка
Список резервных адаптеров, используемых для переключения.
Все vmnics используются в качестве активных адаптеров, если active_adapters и standby_adapters не определены.
traffic_shaping
словарь
Словарь, настраивающий формирование трафика для коммутатора.
average_bandwidth
целое число
Средняя пропускная способность (кбит/с).
burst_size
целое число
Размер всплеска (КБ).
enabled
булево
    Варианты:
  • no
  • yes
Статус политики формирования трафика.
peak_bandwidth
целое число
Пиковая пропускная способность (кбит/с).
username
строка
Имя пользователя сервера vSphere vCenter или ESXi.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.
Поддержка переменных окружения добавлена в Ansible 2.6.

Псевдонимы: admin, user
validate_certs
булево
    Варианты:
  • no
  • yes ←
Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты ненадёжны.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS.
Поддержка переменных окружения добавлена в Ansible 2.6.
Если установлено значение true, убедитесь, что на данном компьютере установлен Python >= 2.7.9.
vlan_id
целое число
По умолчанию:
0
Идентификатор VLAN для назначения портгруппы.
По умолчанию установлено значение 0 (без маркировки VLAN).

Псевдонимы: vlan

Примечания

Примечание

  • Проверено на vSphere 5.5 и 6.5
  • Полная конфигурация проверена только на vSphere 6.5
  • inbound_policy и rolling_order удалены в версии 2.11.
  • Эти два параметра используются только при создании портгруппы. Обновление с этими параметрами не поддерживается.

Примеры

- name: Add Management Network VM Portgroup
  community.vmware.vmware_portgroup:
    hostname: "{{ esxi_hostname }}"
    username: "{{ esxi_username }}"
    password: "{{ esxi_password }}"
    switch: "{{ vswitch_name }}"
    portgroup: "{{ portgroup_name }}"
    vlan_id: "{{ vlan_id }}"
  delegate_to: localhost

- name: Add Portgroup with Promiscuous Mode Enabled
  community.vmware.vmware_portgroup:
    hostname: "{{ esxi_hostname }}"
    username: "{{ esxi_username }}"
    password: "{{ esxi_password }}"
    switch: "{{ vswitch_name }}"
    portgroup: "{{ portgroup_name }}"
    security:
        promiscuous_mode: True
  delegate_to: localhost

- name: Add Management Network VM Portgroup to specific hosts
  community.vmware.vmware_portgroup:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    hosts: [esxi_hostname_one]
    switch: "{{ vswitch_name }}"
    portgroup: "{{ portgroup_name }}"
    vlan_id: "{{ vlan_id }}"
  delegate_to: localhost

- name: Add Management Network VM Portgroup to all hosts in a cluster
  community.vmware.vmware_portgroup:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    cluster_name: "{{ cluster_name }}"
    switch: "{{ vswitch_name }}"
    portgroup: "{{ portgroup_name }}"
    vlan_id: "{{ vlan_id }}"
  delegate_to: localhost

- name: Remove Management Network VM Portgroup to all hosts in a cluster
  community.vmware.vmware_portgroup:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    cluster_name: "{{ cluster_name }}"
    switch: "{{ vswitch_name }}"
    portgroup: "{{ portgroup_name }}"
    vlan_id: "{{ vlan_id }}"
    state: absent
  delegate_to: localhost

- name: Add Portgroup with all settings defined
  community.vmware.vmware_portgroup:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    esxi_hostname: "{{ inventory_hostname }}"
    switch: "{{ vswitch_name }}"
    portgroup: "{{ portgroup_name }}"
    vlan_id: 10
    security:
        promiscuous_mode: False
        mac_changes: False
        forged_transmits: False
    traffic_shaping:
        enabled: True
        average_bandwidth: 100000
        peak_bandwidth: 100000
        burst_size: 102400
    teaming:
        load_balancing: failover_explicit
        network_failure_detection: link_status_only
        notify_switches: true
        failback: true
        active_adapters:
            - vmnic0
        standby_adapters:
            - vmnic1
  delegate_to: localhost
  register: teaming_result

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

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

Ключ Возвращаемое значение Описание
result
словарь
всегда
метаданные о группе портов

Пример:
{'esxi01.example.com': {'изменён': True, 'failback': 'Без переопределения', 'failover_active': 'Без переопределения', 'failover_standby': 'Без переопределения', 'failure_detection': 'Без переопределения', 'load_balancing': 'Без переопределения', 'сообщение': 'Группа портов добавлена', 'notify_switches': 'Без переопределения', 'портгруппа': 'vMotion', 'sec_forged_transmits': False, 'sec_mac_changes': False, 'sec_promiscuous_mode': False, 'traffic_shaping': 'Без переопределения', 'vlan_id': 33, 'vswitch': 'vSwitch1'}}


Авторы

  • Joseph Callen (@jcpowermac)
  • Russell Teague (@mtnbikenc)
  • Abhijeet Kasurde (@Akasurde)
  • Christian Kotte (@ckotte)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_portgroup_module.html

Spec-Zone.ru

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