community.vmware.vmware_portgroup – Создание VMware портгруппы
Примечание
Этот плагин входит в коллекцию community.vmware (версия 1.6.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-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в Ansible 2.6. | ||
| hosts список / элементы=строка | Список имён хостов, на которых необходимо добавить портгруппу. Этот параметр обязателен, если cluster_name не указан.псевдонимы: esxi_hostname | ||
| password строка | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | ||
| port целое число | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, будет использовано значение переменной окружения 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 булево |
| Указывает, разрешены ли сфабрикованные передачи. | |
| mac_changes булево |
| Указывает, разрешены ли изменения MAC-адресов. | |
| promiscuous_mode булево |
| Указывает, разрешён ли режим promiscuous. | |
| state строка |
| Определяет, должна ли портгруппа присутствовать или нет. | |
| switch строка / обязательно | vSwitch для изменения. псевдонимы: switch_name, vswitch | ||
| teaming словарь | Словарь для конфигурации различных значений для объединения портгрупп. псевдонимы: teaming_policy | ||
| active_adapters список / элементы=строка | Список активных адаптеров, используемых для балансировки нагрузки. Все vmnics используются в качестве активных адаптеров, если active_adapters и standby_adapters не определены. | ||
| failback булево |
| Указывает, нужно ли использовать резервное восстановление при восстановлении связей. | |
| load_balancing строка |
| Политика объединения сетевых адаптеров. псевдонимы: load_balance_policy | |
| network_failure_detection строка |
| Обнаружение сбоев сети. | |
| notify_switches булево |
| Указывает, нужно ли уведомлять физический коммутатор о сбое соединения. | |
| standby_adapters список / элементы=строка | Список резервных адаптеров, используемых для аварийного переключения. Все vmnics используются в качестве активных адаптеров, если active_adapters и standby_adapters не определены. | ||
| traffic_shaping словарь | Словарь для конфигурации ограничения трафика для коммутатора. | ||
| average_bandwidth целое число | Средняя полоса пропускания (кбит/с). | ||
| burst_size целое число | Размер пакета (КБ). | ||
| enabled булево |
| Состояние политики ограничения трафика. | |
| peak_bandwidth целое число | Пиковая полоса пропускания (кбит/с). | ||
| username строка | Имя пользователя сервера vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_USER. Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: admin, user | ||
| validate_certs булево |
| Разрешает подключение, когда 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/vmware/vmware_portgroup_module.html