VMware Guest Network

5 min

Resumo

Este módulo é usado para adicionar, reconfigurar e remover o adaptador de rede de determinada máquina virtual.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentarios
cluster	string		Nome do cluster ao qual a VM pertence.
connected	boolean	Escolhas: - false - true (default)	Se a NIC deve ser conectada à rede.
datacenter	string	"ha-datacenter" (default)	Datacenter ao qual a VM pertence.
device_type	string	Escolhas: - e1000 - e1000e - pcnet32 - vmxnet3 (default) - sriov	Tipo de dispositivo de rede virtual.
directpath_io	boolean	Escolhas: - false (default) - true	Ative o Universal Pass-through (UPT). Compatível apenas com o tipo de dispositivo vmxnet3.
esxi_hostname	string		Nome de host do host ESXi ao qual a VM pertence.
folder	string		Localização da pasta de determinada VM, isso só é necessário quando há várias VMs com o mesmo nome.
force	boolean	Escolhas: - false (default) - true	Força a criação do adaptador mesmo se um adaptador existente estiver conectado à mesma rede.
gather_network_info	boolean	Escolhas: - false (default) - true	Retorne informações sobre os adaptadores de rede convidados atuais.
guest_control	boolean	Escolhas: - false - true (default)	Permite o controle do convidado sobre se o dispositivo conectável está conectado.
label	string		Altere o nome do adaptador de rede.
mac_address	string		Endereço MAC do NIC que deve ser alterado, se um endereço MAC não for fornecido, um novo nic será criado. Requerido quando state = absent.
moid	string		ID do objeto gerenciado da instância a ser gerenciado, se conhecido, é um identificador exclusivo apenas em uma única instância do vCenter. Requerido se uuid ou nome não for fornecido.
name	string		Nome da máquina virtual. Obrigatório se uuid ou moid não for fornecido.
network_name	string		Nome da rede no vSphere.
networks (Possiveis valores)	list / elements=dictionary		Lista de adaptadores de rede. MAC ou label ou device_type é necessário para reconfigurar ou remover um adaptador de rede existente. Se houver vários adaptadores de rede com o mesmo device_type, você deve definir label ou mac para corresponder a um deles, ou irá aplicar alterações em todos os adaptadores de rede com o device_type especificado.
start_connected	boolean	Escolhas: - false - true (default)	Se a NIC deve ser conectada à rede na inicialização.
state	string	Escolhas: - present (default) - absent	Quando state for present, um nic será adicionado se um endereço mac ou label não existir anteriormente ou não estiver definido. Quando state for absent, o parâmetro mac_address deve ser definido.
switch	string		Nome do switch (dv) para a rede de destino, isso só é necessário para dvswitches.
use_instance_uuid	boolean	Escolhas: - false (default) - true	Se deve usar o UUID da instância do VMware em vez do UUID do BIOS.
uuid	string		VM uuid. Obrigatório se name ou moid não for fornecido.
vlan_id	integer		ID de VLAN associada à rede.
wake_onlan	boolean	Escolhas: - false (default) - true	Ativar o wake on LAN.

Subcampos da opção networks

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
connected	boolean	Escolhas: - false (default) - true	Indica que o adaptador de rede virtual se conecta à máquina virtual associada.
device_type	string	Escolhas: - e1000 - e1000e - pcnet32 - vmxnet2 - vmxnet3 - sriov	Os tipos de dispositivo de rede virtual válidos são e1000, e1000e, pcnet32, vmxnet2, vmxnet3 (padrão), sriov. Usado para adicionar um novo adaptador de rede, reconfigurar ou remover o adaptador de rede existente com este tipo. Se o mac e o label não forem especificados ou não encontrar o adaptador de rede por mac ou label usará este parâmetro.
directpath_io	boolean	Escolhas: - false (default) - true	Se definido, Universal Pass-Through (UPT ou DirectPath I / O) será habilitado no adaptador de rede. UPT só é compatível com o adaptador Vmxnet3.
dvswitch_name	string		Nome do vSwitch distribuído. Este valor é necessário se vários grupos de portas distribuídos existirem com o mesmo nome.
label	string		Label do adaptador de rede existente a ser reconfigurado ou removido, por exemplo, "Adaptador de rede 1".
mac	string		Endereço MAC do adaptador de rede existente a ser reconfigurado ou removido.
manual_mac	string		Endereço MAC especificado manualmente do adaptador de rede ao criar ou reconfigurar. Se não for especificado ao criar um novo adaptador de rede, o endereço mac será gerado automaticamente. Ao reconfigurar o endereço MAC, a VM deve estar desligada.
name	string		Nome do grupo de portas ou grupo de portas virtuais distribuído para esta interface. Ao especificar o grupo de portas virtuais distribuídas, certifique-se de que esxi_hostname ou cluster está associado a ele.
start_connected	boolean	Escolhas: - false (default) - true	Indica que o adaptador de rede virtual começa com a máquina virtual associada ligada.
state	string	Escolhas: - present - absent - new	Estado do adaptador de rede. Se definido como present, fará a reconfiguração do adaptador de rede especificado. Se definido como new, adicionará o adaptador de rede especificado. Se definido como absent, removerá este adaptador de rede.
vlan	integer		Número da VLAN para esta interface.

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

Exemplos

# Exemplo: Mudar de rede para 00:50:56:11:22:33 em vm01.domain.fake
- vmware_guest_network:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    name: vm01.domain.fake
    mac_address: 00:50:56:11:22:33
    network_name: admin-network
    state: present

# Exemplo: Adicionar um nic na rede com vlan id 2001 para 422d000d-2000-ffff-0000-b00000000000
- vmware_guest_network:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    uuid: 422d000d-2000-ffff-0000-b00000000000
    vlan_id: 2001

# Exemplo: Remover nic com mac 00:50:56:11:22:33 de vm01.domain.fake
- vmware_guest_network:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    mac_address: 00:50:56:11:22:33
    name: vm01.domain.fake
    state: absent

# Exemplo: Adicione vários nics a vm01.domain.fake
- vmware_guest_network:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    name: vm01.domain.fake
    state: present
    vlan_id: "{{ item.vlan_id | default(omit) }}"
    network_name: "{{ item.network_name | default(omit) }}"
    connected: "{{ item.connected | default(omit) }}"
  loop:
    - vlan_id: 2000
      connected: false
    - network_name: guest-net
      connected: true

Valores retornados

Chave	Tipo	Retornado quando	Descrição
network_data	dictionary	Quando gather_network_info estiver ativado ou ter passado os parâmetros de network.	Dados sobre os adaptadores de rede da máquina virtual
network_info	list / elements=string	Sempre	Dados sobre os adaptadores de rede da máquina virtual