Adicione interfaces de rede dinâmicas a uma instância

Esta página descreve como adicionar uma interface de rede dinâmica (NIC) a uma instância do Compute Engine existente.

Para obter informações sobre a criação de novas instâncias, consulte o artigo Crie VMs com várias interfaces de rede.

Antes de começar

Antes de adicionar NICs dinâmicas a uma instância, faça o seguinte:

Adicione uma NIC dinâmica

As secções seguintes descrevem como adicionar uma NIC dinâmica a uma instância individual ou a instâncias que fazem parte de um grupo de instâncias gerido (MIG).

Quando adiciona uma NIC dinâmica, pode observar um atraso na propagação. Normalmente, este atraso é de alguns segundos, mas, em casos raros, pode demorar até um minuto.

Adicione uma NIC dinâmica a uma instância

Esta secção descreve como adicionar uma NIC dinâmica a uma instância.

Consola

  1. Na Google Cloud consola, aceda à página Instâncias de VM.

    Aceda às instâncias de VM

  2. Clique no nome da instância à qual quer adicionar uma NIC dinâmica.

  3. Na página de detalhes da instância, clique em Editar.

  4. Na secção Interfaces de rede dinâmicas, clique em Adicionar uma interface de rede dinâmica e faça o seguinte:

    1. No campo Tipo de interface, selecione VPC.

    2. No campo Interface de rede principal, selecione a vNIC principal para a qual criar a NIC dinâmica.

    3. No campo ID da VLAN, introduza o ID da VLAN da NIC dinâmica.

    4. Para Rede e Sub-rede, selecione a rede e a sub-rede que quer usar.

    5. Selecione uma das seguintes opções para o tipo de pilha de IP para a NIC dinâmica:

      • IPv4 (pilha única)
      • IPv4 e IPv6 (dual-stack)
      • IPv6 (pilha única)

    6. Para NICs dinâmicos com endereços IPv4, faça o seguinte:

      1. Para Endereço IPv4 interno principal, selecione uma das seguintes opções:

        • Efémero (automático) para atribuir automaticamente um novo endereço IPv4 efémero
        • Efémero (personalizado) para especificar manualmente um novo endereço IPv4 efémero
        • Um endereço IPv4 interno estático reservado da lista
        • Reservar endereço IPv4 interno estático para reservar e atribuir um novo endereço IPv4 interno estático

      2. Para Endereço IPv4 externo, selecione uma das seguintes opções:

        • Efémero para atribuir um novo endereço IPv4 efémero
        • Nenhum para não atribuir um endereço IPv4 externo
        • Um endereço IPv4 estático reservado da lista
        • Reservar endereço IP externo estático para reservar e atribuir um novo endereço IPv4 externo estático

      3. Opcionalmente, pode atribuir um ou mais intervalos de IP de alias à interface de rede. Para atribuir um intervalo de IP de alias, faça o seguinte:

        1. Em Intervalos de IP de alias, clique em Adicionar intervalo de IP.
        2. Em Intervalo de sub-rede, selecione um intervalo de endereços IPv4 principal da sub-rede ou um intervalo de endereços IPv4 secundário da sub-rede a usar.
        3. Para o Intervalo de IPs de alias, introduza um intervalo de IPs na notação CIDR. Este intervalo tem de ser um intervalo não usado do intervalo de IPs da sub-rede que selecionou.

        Para mais informações sobre como atribuir intervalos de IPs de alias a interfaces de rede de VMs, consulte o artigo Configure intervalos de IPs de alias.

    7. Para NICs dinâmicos com endereços IPv6, configure um intervalo de endereços IPv6 interno ou externo, consoante o tipo de acesso da sub-rede ligada. Para o Endereço IPv6 interno principal ou o Endereço IPv6 externo, selecione uma das seguintes opções:

      • Efémero (automático) para atribuir automaticamente um novo intervalo de endereços IPv6 efémeros
      • Efémero (personalizado) para especificar manualmente um novo intervalo de endereços IPv6 efémeros
      • Um intervalo de endereços IPv6 estáticos reservados da lista
      • Reservar endereço IPv6 interno estático ou Reservar endereço IPv6 externo estático para reservar e atribuir um novo intervalo de endereços IPv6 estáticos

    8. Para terminar a edição das propriedades da NIC dinâmica, clique em Concluído.

  5. Para guardar a configuração, clique em Guardar.

gcloud

Para adicionar uma NIC dinâmica a uma instância existente, use o comando gcloud compute instances network-interfaces add.

gcloud compute instances network-interfaces add INSTANCE_NAME \
   --zone=ZONE \
   --vlan=VLAN_ID \
   --parent-nic-name=PARENT_VNIC_NAME \
   --network=NETWORK \
   --subnetwork=SUBNET

Substitua o seguinte:

  • INSTANCE_NAME: o nome da instância à qual adicionar a NIC dinâmica
  • ZONE: a zona da instância
  • VLAN_ID: o ID da VLAN da NIC dinâmica
  • PARENT_VNIC_NAME: o nome da vNIC principal, como nic0
  • NETWORK: a rede à qual a NIC dinâmica se associa
  • SUBNET: a sub-rede à qual a NIC dinâmica se associa

Em alternativa, pode adicionar uma NIC dinâmica a uma instância quando atualiza as propriedades da instância. Para mais informações, consulte o artigo Atualize as propriedades da instância.

API

Para adicionar uma NIC dinâmica a uma instância existente, use o método instances.addNetworkInterface.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/addNetworkInterface
{
  "subnetwork": "regions/REGION/subnetworks/SUBNET",
  "parentNicName": "PARENT_VNIC_NAME",
  "vlan": "VLAN_ID"
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto que contém a instância
  • ZONE: a zona que contém a instância
  • INSTANCE_NAME: o nome da instância à qual adicionar um NIC dinâmico
  • REGION: a região que contém a instância
  • SUBNET: a sub-rede à qual a NIC dinâmica está associada
  • PARENT_VNIC_NAME: o nome da vNIC principal, como nic0
  • VLAN_ID: o ID da VLAN da NIC dinâmica

Em alternativa, pode adicionar uma NIC dinâmica a uma instância quando atualiza as propriedades da instância. Para mais informações, consulte o artigo Atualize as propriedades da instância.

Adicione uma NIC dinâmica a instâncias num MIG

Esta secção descreve como adicionar uma NIC dinâmica a instâncias num MIG criando um novo modelo de instância e aplicando a configuração ao MIG. A atualização de um modelo de instância existente não é suportada.

Para mais informações sobre como criar modelos de instâncias, consulte o artigo Crie modelos de instâncias. Para ver os modelos de instâncias existentes, consulte o artigo Obtenha, liste e elimine modelos de instâncias.

Consola

  1. Aceda à página Modelos de instâncias.

    Aceda a Modelos de instâncias

  2. Clique no modelo de instância que quer copiar e atualizar.

  3. Clique em Criar semelhante.

  4. Expanda a secção Opções avançadas e, de seguida, expanda a secção Redes.

  5. Na secção Interfaces de rede dinâmicas, clique em Adicionar uma interface de rede dinâmica e faça o seguinte:

    1. No campo Tipo de interface, selecione VPC.

    2. No campo Interface de rede principal, selecione a vNIC principal para a qual criar a NIC dinâmica.

    3. No campo ID da VLAN, introduza o ID da VLAN da NIC dinâmica.

    4. Para Rede e Sub-rede, selecione a rede e a sub-rede que quer usar.

    5. Selecione uma das seguintes opções para o tipo de pilha de IP para a NIC dinâmica:

      • IPv4 (pilha única)
      • IPv4 e IPv6 (dual-stack)
      • IPv6 (pilha única)

    6. Para NICs dinâmicos com endereços IPv4, faça o seguinte:

      1. Para Endereço IPv4 interno principal, selecione uma das seguintes opções:

        • Efémero (automático) para atribuir automaticamente um novo endereço IPv4 efémero
        • Efémero (personalizado) para especificar manualmente um novo endereço IPv4 efémero
        • Um endereço IPv4 interno estático reservado da lista
        • Reservar endereço IPv4 interno estático para reservar e atribuir um novo endereço IPv4 interno estático

      2. Para Endereço IPv4 externo, selecione uma das seguintes opções:

        • Efémero para atribuir um novo endereço IPv4 efémero
        • Nenhum para não atribuir um endereço IPv4 externo
        • Um endereço IPv4 estático reservado da lista
        • Reservar endereço IP externo estático para reservar e atribuir um novo endereço IPv4 externo estático

      3. Opcionalmente, pode atribuir um ou mais intervalos de IP de alias à interface de rede. Para atribuir um intervalo de IP de alias, faça o seguinte:

        1. Em Intervalos de IP de alias, clique em Adicionar intervalo de IP.
        2. Em Intervalo de sub-rede, selecione um intervalo de endereços IPv4 principal da sub-rede ou um intervalo de endereços IPv4 secundário da sub-rede a usar.
        3. Para o Intervalo de IPs de alias, introduza um intervalo de IPs na notação CIDR. Este intervalo tem de ser um intervalo não usado do intervalo de IPs da sub-rede que selecionou.

        Para mais informações sobre como atribuir intervalos de IPs de alias a interfaces de rede de VMs, consulte o artigo Configure intervalos de IPs de alias.

    7. Para NICs dinâmicos com endereços IPv6, configure um intervalo de endereços IPv6 interno ou externo, consoante o tipo de acesso da sub-rede ligada. Para o Endereço IPv6 interno principal ou o Endereço IPv6 externo, selecione uma das seguintes opções:

      • Efémero (automático) para atribuir automaticamente um novo intervalo de endereços IPv6 efémeros
      • Efémero (personalizado) para especificar manualmente um novo intervalo de endereços IPv6 efémeros
      • Um intervalo de endereços IPv6 estáticos reservados da lista
      • Reservar endereço IPv6 interno estático ou Reservar endereço IPv6 externo estático para reservar e atribuir um novo intervalo de endereços IPv6 estáticos

    8. Para terminar a edição das propriedades da NIC dinâmica, clique em Concluído.

  6. Para criar o modelo de instância, clique em Criar.

  7. Siga os passos para aplicar novas configurações de VM num MIG.

    Se quiser atualizar as instâncias sem as reiniciar nem as recriar, defina a ação mínima como REFRESH. Para mais informações, consulte o seguinte:

gcloud

  1. Para criar um novo modelo de instância que adicione uma NIC dinâmica, use o comando gcloud compute instance-templates create.

    Inclua a flag --network-interface para cada interface de rede do modelo de instância existente e adicione uma nova interface de rede que especifique a chave vlan para criar uma NIC dinâmica.

    O exemplo seguinte adiciona uma NIC dinâmica em nic0. Pode especificar interfaces de rede e propriedades adicionais conforme necessário. Para ver mais exemplos de como criar instâncias com várias interfaces de rede, consulte o artigo Crie VMs com várias interfaces de rede.

    gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
   --network-interface=network=NETWORK_A,subnet=SUBNET_A \
   --network-interface=network=NETWORK_B,subnet=SUBNET_B,vlan=VLAN_ID

    Substitua o seguinte:

    • INSTANCE_TEMPLATE_NAME: um nome para o novo modelo de instância.
    • NETWORK_A, NETWORK_B: a rede à qual a interface está associada.
    • SUBNET_A, SUBNET_B: a sub-rede onde a interface está anexada.
    • VLAN_ID: um ID de VLAN. A especificação de um ID de VLAN configura a interface de rede como uma NIC dinâmica. Tem de colocar um NIC dinâmico após o vNIC principal no comando.

  2. Siga os passos para aplicar novas configurações de VM num MIG.

    Se quiser atualizar as instâncias sem as reiniciar nem as recriar, defina a ação mínima como REFRESH. Para mais informações, consulte o seguinte:

API

  1. Para criar um novo modelo de instância que adicione uma NIC dinâmica, use o método instanceTemplates.insert para criar um modelo de instância global ou o método regionInstanceTemplates.insert para criar um modelo de instância regional.

    No campo networkInterfaces, especifique cada interface de rede do modelo de instância existente e adicione uma nova interface de rede que inclua o campo vlan para criar uma NIC dinâmica.

    O exemplo seguinte adiciona uma NIC dinâmica em nic0. Pode especificar interfaces de rede e propriedades adicionais conforme necessário. Para ver mais exemplos de como criar instâncias com várias interfaces de rede, consulte o artigo Crie VMs com várias interfaces de rede.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/instanceTemplates
{
   ....

   "networkInterfaces": [
     {
       "subnetwork": "regions/REGION/subnetworks/SUBNET_A"
     },
     {
       "subnetwork": "regions/REGION/subnetworks/SUBNET_B",
       "vlan": "VLAN_ID"
     },
       additional network interfaces...
   ],
   other instance settings...
 }

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto que contém o modelo de instância.
    • REGION: a região que contém as instâncias.
    • SUBNET_A, SUBNET_B: as sub-redes onde cada interface de rede está localizada.
    • VLAN_ID: um ID de VLAN. A especificação de um ID de VLAN configura a interface de rede como uma NIC dinâmica. Tem de colocar uma NIC dinâmica após a vNIC principal no pedido.

  2. Siga os passos para aplicar novas configurações de VM num MIG.

    Se quiser atualizar as instâncias sem as reiniciar nem as recriar, defina a ação mínima como REFRESH. Para mais informações, consulte o seguinte:

Configure o SO convidado para NICs dinâmicos

Esta secção descreve como concluir a configuração adicional do SO convidado necessária quando adiciona NICs dinâmicos a uma instância nova ou existente.

Escolha uma das seguintes opções de configuração:

Opção de configuração Descrição
Configure a gestão automática de NICs dinâmicas (recomendado)

Use o agente convidado para a gestão automática de NICs dinâmicos.

O ambiente convidado inclui o agente convidado, que automatiza a instalação e a gestão de interfaces VLAN no espaço de nomes raiz nas distribuições Linux de Google Cloud imagens do SO.

Se configurar a gestão automática de NICs dinâmicos, use a versão 20251115.00 ou posterior do agente convidado. Embora o suporte desta funcionalidade tenha sido introduzido na versão do agente convidado 20250204.02, existe um problema conhecido com as versões do agente convidado 20250901.00 a 20251108.00 em que as NICs dinâmicas não são instaladas nem geridas automaticamente.
Configure o SO convidado manualmente

Execute comandos no SO convidado para instalar as NICs dinâmicas.

Se usar esta opção, a configuração não é automaticamente mantida após um reinício da instância. Para que as configurações persistam após um reinício, use o método recomendado para configurar interfaces de rede persistentes para a sua distribuição do Linux. Por exemplo, consulte NetworkConfiguration para o Debian e interfaces para o Ubuntu.

Configure a gestão automática de NICs dinâmicos

Esta secção descreve como configurar a gestão automática de NICs dinâmicos através do agente convidado.

Só tem de concluir estes passos uma vez por instância. Se adicionou uma NIC dinâmica a uma instância para a qual já concluiu estes passos, não precisa de os repetir.

Para configurar a gestão automática de NICs dinâmicas:

  1. Estabeleça ligação à instância através do SSH.

  2. Certifique-se de que a instância está a executar a versão 20251115.00 ou posterior do agente convidado:

    1. Para determinar se a instância está a executar o agente convidado, execute o comando adequado indicado em Pacotes instalados para o ambiente convidado.

      1. Se a sua instância não estiver a executar o agente convidado, instale o ambiente convidado.

      2. Se a sua instância estiver a executar o agente convidado, atualize o ambiente convidado.

      A instalação ou a atualização do ambiente convidado garante que tem a versão mais recente do agente convidado. Pode confirmar a versão seguindo os passos em Validar o ambiente convidado.

  3. Configure o agente convidado para gerir NICs dinâmicos:

    1. Abra ou crie o ficheiro de configuração do ambiente convidado.

      edit /etc/default/instance_configs.cfg

    2. Adicione o seguinte ao ficheiro de configuração e, em seguida, guarde as alterações e saia do editor.

      [NetworkInterfaces]
vlan_setup_enabled = true
manage_primary_nic = true

      Para obter informações acerca destas definições, consulte o seguinte:

      • vlan_setup_enabled = true: configura o agente convidado para instalar e gerir NICs dinâmicos
      • manage_primary_nic = true: uma definição adicional necessária para o agente convidado gerir NICs dinâmicos criados em nic0

      Para mais informações sobre como editar o ficheiro de configuração do agente convidado, consulte a secção Configuração na documentação do agente convidado.

    3. Reinicie o agente convidado executando o seguinte comando. Em alternativa, pode reiniciar a instância.

      sudo systemctl restart google-guest-agent.service

  4. Liste as interfaces de rede na sua instância para ver que o agente convidado instalou as NICs dinâmicas.

    Por exemplo, o comando seguinte apresenta um nome como a-gcp.ens4.11 para uma NIC dinâmica com um ID de VLAN de 11 criado como um elemento subordinado da interface ens4.

    sudo ip -d addr

Configure o SO convidado manualmente

Para configurar NICs dinâmicos no SO convidado de uma instância manualmente:

  1. Estabeleça ligação à instância através do SSH.

  2. Se a instância estiver a executar o agente convidado, desative a gestão automática das NICs dinâmicas. Pode determinar se a instância está a executar o agente convidado através do comando adequado indicado em Pacotes instalados para o ambiente convidado.

    Para desativar a gestão automática de NICs dinâmicos:

    1. Abra ou crie o ficheiro de configuração do ambiente convidado.

        edit /etc/default/instance_configs.cfg

    2. Adicione o seguinte ao ficheiro de configuração, guarde as alterações e saia do editor.

      [NetworkInterfaces]
vlan_setup_enabled = false
manage_primary_nic = false

      Para mais informações sobre como editar o ficheiro de configuração do agente convidado, consulte a secção Configuração na documentação do agente convidado.

    3. Reinicie o agente convidado executando o seguinte comando. Em alternativa, pode reiniciar a instância.

      sudo systemctl restart google-guest-agent.service

  3. Para cada NIC dinâmico que criou, faça o seguinte:

    1. Obtenha o endereço MAC da placa NIC dinâmica. Para encontrar o endereço MAC, consulte o servidor de metadados executando o seguinte comando:

      curl http://metadata.google.internal/computeMetadata/v1/instance/vlan-network-interfaces/VNIC_NUMBER/VLAN_ID/mac -H "Metadata-Flavor: Google"

      Substitua VNIC_NUMBER/VLAN_ID pelo número da vNIC principal e o ID da VLAN da NIC dinâmica. Por exemplo, 0/2 para nic0.2 ou 1/4 para nic1.4.

    2. Configure uma subinterface no SO convidado da instância. Por exemplo, numa VM Debian, execute os seguintes comandos:

      sudo modprobe 8021q
sudo ip link add link VNIC_NAME name VNIC_NAME.VLAN_ID type vlan id VLAN_ID
sudo ip addr add IP_ADDRESS dev VNIC_NAME.VLAN_ID
sudo ip link set dev VNIC_NAME.VLAN_ID address MAC_ADDRESS
sudo ip link set up VNIC_NAME.VLAN_ID

      Substitua o seguinte:

      • VNIC_NAME: o nome da vNIC principal atribuído pelo sistema operativo, como eth1 ou ens4
      • IP_ADDRESS: o endereço IP da NIC dinâmica que criou
      • VLAN_ID: o ID da VLAN que atribuiu à NIC dinâmica
      • MAC_ADDRESS: o endereço MAC que obteve no passo anterior

O que se segue?