community.vmware.vmware_portgroup – Создать VMware портгруппу
Примечание
Этот плагин является частью коллекции community.vmware (версия 1.7.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-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в Ansible 2.6. | ||
| hosts список / элементы=строка | Список имен хостов, на которых необходимо добавить портгруппу. Этот параметр необходим, если cluster_name не указан.Псевдонимы: esxi_hostname | ||
| password строка | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения VMWARE_PASSWORD. Поддержка переменных окружения добавлена в Ansible 2.6. Псевдонимы: pass, pwd | ||
| port целое число | По умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, будет использовано значение переменной окружения 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 строка | Имя пользователя сервера vSphere 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/vmware/vmware_portgroup_module.html