Spec-Zone.ru › Ansible 2.8

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

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

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

Обзор

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

Требования

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

  • python >= 2.6
  • PyVmomi

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cluster_name
-
Добавлен в 2.5
Имя кластера для членства хостов.
Портгруппа будет создана на всех хостах заданного кластера.
Этот параметр требуется, если hosts не указан.
hostname
строка
Имя хоста или IP-адрес vSphere vCenter или ESXi сервера.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST.
Поддержка переменных окружения добавлена в Ansible 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 (булево): указывает, разрешен ли режим promiscuous. (по умолчанию: false)
- forged_transmits (булево): указывает, разрешены ли поддельные передачи. (по умолчанию: false)
- mac_changes (булево): указывает, разрешены ли изменения mac-адресов. (по умолчанию: false)
password
строка
Пароль vSphere vCenter или ESXi сервера.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD.
Поддержка переменных окружения добавлена в Ansible 2.6.

Псевдонимы: pass, pwd
port
целое число
Добавлен в 2.5
По умолчанию:
443
Номер порта vSphere vCenter или ESXi сервера.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PORT.
Поддержка переменных окружения добавлена в Ansible 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 (булево): Указывает, применяется ли политика группировки и к входящим кадрам. (по умолчанию: False)
- notify_switches (булево): Указывает, необходимо ли уведомлять физический коммутатор в случае отказа соединения. (по умолчанию: True)
- rolling_order (булево): Указывает, необходимо ли использовать политику поэтапного восстановления при восстановлении соединений. (по умолчанию: False)
username
строка
Имя пользователя vSphere vCenter или ESXi сервера.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER.
Поддержка переменных окружения добавлена в Ansible 2.6.

Псевдонимы: admin, user
validate_certs
логическое значение
    Варианты:
  • нет
  • да ←
Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты не доверяются.
Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_VALIDATE_CERTS.
Поддержка переменных окружения добавлена в Ansible 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. [сообщество]

Авторы

  • 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.8/modules/vmware_portgroup_module.html

Spec-Zone.ru

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