vmware_portgroup – Создание VMware портгруппы
Описание
- Создание VMware портгруппы на стандартном VMware коммутаторе (vSS) для указанных хостов ESXi или хостов заданного кластера.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name строка добавлено в 2.5 | Имя кластера для принадлежности хоста. Портгруппа будет создана на всех хостах данного кластера. Этот параметр обязателен, если hosts не указан.псевдонимы: cluster | |
| hostname строка | Имя хоста или IP-адрес сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения VMWARE_HOST. Поддержка переменных окружения добавлена в Ansible 2.6. | |
| hosts список добавлено в 2.5 | Список имен хостов, на которых требуется добавить портгруппу. Этот параметр обязателен, если cluster_name не указан.псевдонимы: esxi_hostname | |
| password строка | Пароль сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения VMWARE_PASSWORD.Поддержка переменных окружения добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлено в 2.5 | По умолчанию: 443 | Номер порта сервера vSphere vCenter или ESXi. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения VMWARE_PORT.Поддержка переменных окружения добавлена в Ansible 2.6. |
| portgroup строка / обязательно | Имя портгруппы для добавления. псевдонимы: portgroup_name | |
| proxy_host строка добавлено в 2.9 | Адрес прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения VMWARE_PROXY_HOST.Эта функция зависит от версии pyvmomi, большей чем v6.7.1.2018.12 | |
| proxy_port целое число добавлено в 2.9 | Порт HTTP-прокси-сервера, который будет принимать все запросы HTTPS и перенаправлять их. Если значение не указано в задаче, вместо него будет использовано значение переменной окружения VMWARE_PROXY_PORT. | |
| security словарь | Политика сети определяет параметры безопасности второго уровня для портгруппы, такие как режим promiscuous, где гостевой адаптер прослушивает все пакеты, изменения MAC-адресов и сфабрикованные передачи. Словарь, который настраивает различные значения безопасности для портгруппы. Допустимые атрибуты: - promiscuous_mode (логическое значение): указывает, разрешен ли режим promiscuous. (по умолчанию: None)- forged_transmits (логическое значение): указывает, разрешены ли сфабрикованные передачи. (по умолчанию: None)- mac_changes (логическое значение): указывает, разрешены ли изменения MAC-адресов. (по умолчанию: None)псевдонимы: security_policy, network_policy | |
| state строка добавлено в 2.5 |
| Определяет, должна ли портгруппа существовать или нет. |
| switch строка / обязательно | vSwitch для изменения. псевдонимы: switch_name, vswitch | |
| teaming словарь добавлено в 2.6 | Словарь, который настраивает различные значения объединения для портгруппы. Допустимые атрибуты: - load_balancing (строка): Политика объединения сетевых адаптеров. load_balance_policy также является псевдонимом для этого параметра. (по умолчанию: loadbalance_srcid)- варианты: [ loadbalance_ip, loadbalance_srcmac, loadbalance_srcid, failover_explicit ] - network_failure_detection (строка): Обнаружение сетевого сбоя. (по умолчанию: link_status_only)- варианты: [ link_status_only, beacon_probing ] - notify_switches (логическое значение): Указывает, следует ли уведомлять физический коммутатор о сбое соединения. (по умолчанию: None)- failback (логическое значение): Указывает, следует ли использовать восстановление при восстановлении соединения. (по умолчанию: None)- active_adapters (список): Список активных адаптеров, используемых для балансировки нагрузки.- standby_adapters (список): Список резервных адаптеров, используемых для переключения.- Все vmnics используются как активные адаптеры, если active_adapters и standby_adapters не определены.- inbound_policy (логическое значение): Указывает, применяется ли политика объединения к входящим кадрам. Устарело. (по умолчанию: False)- rolling_order (логическое значение): Указывает, следует ли использовать поэтапную политику при восстановлении соединений. Устарело. (по умолчанию: False)псевдонимы: teaming_policy | |
| traffic_shaping словарь добавлено в 2.9 | Словарь, который настраивает формирование трафика для коммутатора. Допустимые атрибуты: - enabled (логическое значение): Статус политики формирования трафика. (по умолчанию: None)- average_bandwidth (целое число): Средняя пропускная способность (кбит/с). (по умолчанию: None)- peak_bandwidth (целое число): Пиковая пропускная способность (кбит/с). (по умолчанию: None)- burst_size (целое число): Размер буфера (КБ). (по умолчанию: None) | |
| 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 целое число | По умолчанию: 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
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
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
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
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
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
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': {'changed': True, 'failback': 'Без перезаписи', 'failover_active': 'Без перезаписи', 'failover_standby': 'Без перезаписи', 'failure_detection': 'Без перезаписи', 'load_balancing': 'Без перезаписи', 'msg': 'Группа портов добавлена', 'notify_switches': 'Без перезаписи', 'portgroup': 'vMotion', 'sec_forged_transmits': False, 'sec_mac_changes': False, 'sec_promiscuous_mode': False, 'traffic_shaping': 'Без перезаписи', 'vlan_id': 33, 'vswitch': 'vSwitch1'}} |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.9/modules/vmware_portgroup_module.html