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 |
| Определяет, должна ли портгруппа существовать или нет. |
| 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