Spec-Zone.ru › Ansible 2.7

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

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

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

Обзор

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

Требования

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

  • python >= 2.6
  • PyVmomi

Параметры

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

псевдонимы: esxi_hostname
network_policy
-
добавлен в 2.2
По умолчанию:
{"forged_transmits": false, "mac_changes": false, "promiscuous_mode": false}
Политика сети определяет параметры безопасности уровня 2 для портгруппы, такие как режим promiscuous, где гостевой адаптер прослушивает все пакеты, изменения MAC-адреса и поддельные передачи.
Словарь, который настраивает различные значения безопасности для портгруппы.
Допустимые атрибуты:
- promiscuous_mode (bool): указывает, разрешен ли режим promiscuous. (по умолчанию: false)
- forged_transmits (bool): указывает, разрешены ли поддельные передачи. (по умолчанию: false)
- mac_changes (bool): указывает, разрешены ли изменения mac. (по умолчанию: false)
password
строка
Пароль сервера vCenter vSphere или ESXi.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD.
Поддержка переменных среды добавлена в версии 2.6.

псевдонимы: pass, pwd
port
целое число
добавлен в 2.5
По умолчанию:
443
Номер порта сервера vCenter vSphere или ESXi.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT.
Поддержка переменных среды добавлена в версии 2.6.
portgroup_name
- / обязательно
Имя портгруппы для добавления.
state
-
добавлен в 2.5
    Варианты:
  • present ←
  • absent
Определяет, должна ли портгруппа присутствовать или нет.
switch_name
- / обязательно
vSwitch для изменения.
teaming_policy
-
добавлен в 2.6
По умолчанию:
{"inbound_policy": false, "load_balance_policy": "loadbalance_srcid", "notify_switches": true, "rolling_order": false}
Словарь, который настраивает различные значения объединения для портгруппы.
Допустимые атрибуты:
- load_balance_policy (строка): Политика объединения сетевых адаптеров. (по умолчанию: loadbalance_srcid)
- варианты: [ loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit ]
- inbound_policy (bool): Указывает, применяется ли политика объединения к входящим кадрам. (по умолчанию: False)
- notify_switches (bool): Указывает, следует ли уведомлять физический коммутатор о сбое соединения. (по умолчанию: True)
- rolling_order (bool): Указывает, следует ли использовать политику поэтапного восстановления при восстановлении соединений. (по умолчанию: False)
username
строка
Имя пользователя сервера vCenter vSphere или ESXi.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER.
Поддержка переменных среды добавлена в версии 2.6.

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

Примечания

Примечание

  • Тестировалось на vSphere 5.5, 6.5

Примеры

- name: Add Management Network VM Portgroup
  vmware_portgroup:
    hostname: "{{ esxi_hostname }}"
    username: "{{ esxi_username }}"
    password: "{{ esxi_password }}"
    switch_name: "{{ vswitch_name }}"
    portgroup_name: "{{ 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_name: "{{ vswitch_name }}"
    portgroup_name: "{{ portgroup_name }}"
    network_policy:
        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_name: "{{ vswitch_name }}"
    portgroup_name: "{{ 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_name: "{{ vswitch_name }}"
    portgroup_name: "{{ 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_name: "{{ vswitch_name }}"
    portgroup_name: "{{ portgroup_name }}"
    vlan_id: "{{ vlan_id }}"
    state: absent
  delegate_to: localhost

- name: Add Portgroup with teaming policy
  vmware_portgroup:
    hostname: "{{ esxi_hostname }}"
    username: "{{ esxi_username }}"
    password: "{{ esxi_password }}"
    switch_name: "{{ vswitch_name }}"
    portgroup_name: "{{ portgroup_name }}"
    teaming_policy:
      load_balance_policy: 'failover_explicit'
      inbound_policy: True
  delegate_to: localhost
  register: teaming_result

Значения возврата

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

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

Пример:
{'esxi01.example.com': {'portgroup_name': 'pg0010', 'switch_name': 'vswitch_0001', 'vlan_id': 1}}


Статус

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

Авторы

  • Joseph Callen (@jcpowermac)
  • Russell Teague (@mtnbikenc)
  • Abhijeet Kasurde (@Akasurde) <akasurde@redhat.com>

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/vmware_portgroup_module.html

Spec-Zone.ru

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