VMware Portgroup

8 min

Resumo

Crie um VMware Port Group em um VMware Standard Switch (vSS) para determinados hosts ESXi ou hosts de determinado cluster.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
switch	string		vSwitch para modificar.
portgroup	string		Nome do portgroup para ser adicionado
vlan_id	insterger	0	ID da VLAN para atribuir ao grupo de portas. Definido como 0 (sem marcação de VLAN) por padrão.
security	dict		A política de rede especifica as configurações de segurança da camada 2 para um portgroup como o modo promíscuo, onde o adaptador convidado escuta a todos os pacotes, alterações de endereço MAC e transmissões forjadas. Dict que configura os diferentes valores de segurança para portgroup.
teaming	dict		Dicionário que configura os diferentes valores de agrupamento para portgroup.
traffic_shaping	dict		Dicionário que configura o modelagem de tráfego para o switch.
cluster_name	string		Nome do nome do cluster para associação de host. O grupo de portas será criado em todos os hosts do cluster fornecido. Esta opção é necessária se C(hosts) não for especificado.
hosts	string		Lista de nomes de host ou hosts nos quais o grupo de portas precisa ser adicionado. Esta opção é necessária se C(cluster_name) não for especificado.
state	string	present absent	Determina se o portgroup deve estar presente ou não.

Estende fragmentos da documentação do módulo VMware Options.

Sub-options de security

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
promiscuous_mode	bool	False True	Indica se o modo promíscuo é permitido.
forged_transmits	bool	False True	Indica se as transmissões forjadas são permitidas.
mac_changes	bool	security_policy network_policy	Indica se as alterações do mac são permitidas.

Sub-options de teaming

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
load_balancing	string	loadbalance_ip loadbalance_srcmac loadbalance_srcid failover_explicit None	Política de agrupamento de adaptadores de rede.
network_falilure_detection	string	link_status_only beacon_probing	Detecção de falha de rede.
notify_switches	bool	False True	Indique se deve ou não notificar o comutador físico se um link falhar.
failback	bool	False True	Indique se deve ou não usar um failback ao restaurar links.
active_adapters	list/elements=string		Lista de adaptadores ativos usados para balanceamento de carga. Todos os vmnics são usados como adaptadores ativos se C(active_adapters) e C(standby_adapters) não estiverem definidos.
standby_adapters	list/elements=string		Lista de adaptadores em espera usados para failover. Todos os vmnics são usados como adaptadores ativos se C(active_adapters) e C(standby_adapters) não estiverem definidos.

Sub-options de traffic_shaping

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
enabled	bool		Status da Política de Modelagem de Tráfego.
average_bandwidth	interger	present absent add remove set	Largura de banda média (kbit/s).
peak_bandwidth	interger	VirtualMachine Datacenter ClusterComputeResource HostSystem DistributedVirtualSwitch DistributedVirtualPortgroup	Largura de banda máxima (kbit/s).
burst_size	interger		Tamanho da rajada (KB).

Notas

Observação

Testado em ESXi 7.0.2
Todos os módulos requerem acesso de gravação API e, portanto, não são suportados em uma licença ESXi gratuita.

Exemplos

- 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

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
result	dict	sempre	metadados sobre os portgroups