vmware_portgroup - Создание VMware портгруппы
Новая в версии 2.0.
Краткое описание
- Создать VMware портгруппу на заданном хосте/хостах или хостах заданного кластера
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cluster_name (добавлено в 2.5) | Имя кластера для членства хоста. Группа портов будет создана на всех хостах данного кластера. Этот параметр обязателен, если hosts не указан. | |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды 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 mode), изменения MAC-адресов и поддельные передачи. Словарь, настраивающий различные значения безопасности для группы портов. Допустимые атрибуты: - promiscuous_mode (bool): указывает, разрешён ли режим прослушивания всех пакетов. (по умолчанию: false)- forged_transmits (bool): указывает, разрешены ли поддельные передачи. (по умолчанию: false)- mac_changes (bool): указывает, разрешены ли изменения MAC-адресов. (по умолчанию: false) |
| password строка | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: pass, pwd | |
| port целое число (добавлено в 2.5) | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды 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 или ESXi vSphere. Если значение не указано в задаче, вместо него будет использовано значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в версии 2.6. псевдонимы: admin, user |
| validate_certs bool |
| Разрешает подключение, когда 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
- 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
- name: Add Management Network VM Portgroup to specific hosts
vmware_portgroup:
hostname: vCenter_hostname
username: esxi_username
password: esxi_password
hosts: [esxi_hostname_one]
switch_name: vswitch_name
portgroup_name: portgroup_name
vlan_id: vlan_id
- name: Add Management Network VM Portgroup to all hosts in a cluster
vmware_portgroup:
hostname: vCenter_hostname
username: esxi_username
password: esxi_password
cluster_name: rh_engineering
switch_name: vswitch_name
portgroup_name: portgroup_name
vlan_id: vlan_id
- name: Remove Management Network VM Portgroup to all hosts in a cluster
vmware_portgroup:
hostname: vCenter_hostname
username: esxi_username
password: esxi_password
cluster_name: rh_engineering
switch_name: vswitch_name
portgroup_name: portgroup_name
vlan_id: vlan_id
state: absent
- 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
register: teaming_result
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| result dict | всегда | метаданные о портгруппе Пример: {'esxi01.example.com': {'portgroup_name': 'pg0010', 'switch_name': 'vswitch_0001', 'vlan_id': 1}} |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и обслуживание модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом 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.6/modules/vmware_portgroup_module.html
