Spec-Zone.ru › Ansible 2.9

vmware_portgroup – Создание VMware портгруппы

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

Описание

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

Требования

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

  • python >= 2.6
  • PyVmomi

Параметры

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

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

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

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

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

псевдонимы: security_policy, network_policy
state
строка
добавлено в 2.5
    Варианты:
  • present ←
  • absent
Определяет, должна ли портгруппа существовать или нет.
switch
строка / обязательно
vSwitch для изменения.

псевдонимы: switch_name, vswitch
teaming
словарь
добавлено в 2.6
Словарь, который настраивает различные значения объединения для портгруппы.
Допустимые атрибуты:
- load_balancing (строка): Политика объединения сетевых адаптеров. load_balance_policy также является псевдонимом для этого параметра. (по умолчанию: loadbalance_srcid)
- варианты: [ loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit ]
- network_failure_detection (строка): Обнаружение сетевого сбоя. (по умолчанию: link_status_only)
- варианты: [ link_status_only, beacon_probing ]
- notify_switches (логическое значение): Указывает, следует ли уведомлять физический коммутатор о сбое соединения. (по умолчанию: None)
- failback (логическое значение): Указывает, следует ли использовать восстановление при восстановлении соединения. (по умолчанию: None)
- active_adapters (список): Список активных адаптеров, используемых для балансировки нагрузки.
- standby_adapters (список): Список резервных адаптеров, используемых для переключения.
- Все vmnics используются как активные адаптеры, если active_adapters и standby_adapters не определены.
- inbound_policy (логическое значение): Указывает, применяется ли политика объединения к входящим кадрам. Устарело. (по умолчанию: False)
- rolling_order (логическое значение): Указывает, следует ли использовать поэтапную политику при восстановлении соединений. Устарело. (по умолчанию: False)

псевдонимы: teaming_policy
traffic_shaping
словарь
добавлено в 2.9
Словарь, который настраивает формирование трафика для коммутатора.
Допустимые атрибуты:
- enabled (логическое значение): Статус политики формирования трафика. (по умолчанию: None)
- average_bandwidth (целое число): Средняя пропускная способность (кбит/с). (по умолчанию: None)
- peak_bandwidth (целое число): Пиковая пропускная способность (кбит/с). (по умолчанию: None)
- burst_size (целое число): Размер буфера (КБ). (по умолчанию: None)
username
строка
Имя пользователя сервера vSphere 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.
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
  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
  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
  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
  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
  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
  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': {'changed': True, 'failback': 'Без перезаписи', 'failover_active': 'Без перезаписи', 'failover_standby': 'Без перезаписи', 'failure_detection': 'Без перезаписи', 'load_balancing': 'Без перезаписи', 'msg': 'Группа портов добавлена', 'notify_switches': 'Без перезаписи', 'portgroup': 'vMotion', 'sec_forged_transmits': False, 'sec_mac_changes': False, 'sec_promiscuous_mode': False, 'traffic_shaping': 'Без перезаписи', 'vlan_id': 33, 'vswitch': 'vSwitch1'}}


Статус

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

Авторы

  • Joseph Callen (@jcpowermac)
  • Russell Teague (@mtnbikenc)
  • 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_portgroup_module.html

Spec-Zone.ru

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