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 |
| Определяет, должна ли портгруппа присутствовать или нет. |
| 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 |
| Разрешает подключение, когда сертификаты 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