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

Nesta página, descrevemos como adicionar uma interface de rede dinâmica (NIC) a uma instância do Compute Engine.

Para informações sobre como criar novas instâncias, consulte Criar 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:

Adicionar uma NIC dinâmica

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

Ao adicionar uma NIC dinâmica, talvez você observe um atraso na propagação. Esse atraso normalmente é de alguns segundos, mas pode levar até um minuto em casos raros.

Adicionar uma NIC dinâmica a uma instância

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

Console

  1. No console do Google Cloud , acesse a página Instâncias de VM.

    Acessar instâncias de VM

  2. Clique no nome da instância em que você quer adicionar uma NIC dinâmica.

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

  4. Na seçã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 criar a NIC dinâmica.

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

    4. Em Rede e Sub-rede, selecione a rede e a sub-rede que você quer usar.

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

      • IPv4 (pilha única)
      • IPv4 e IPv6 (pilha dupla)
      • IPv6 (pilha única)

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

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

        • Temporário (automático) para atribuir automaticamente um novo endereço IPv4 temporário
        • Temporário (personalizado) para especificar manualmente um novo endereço IPv4 temporário
        • 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. Em Endereço IPv4 externo, selecione uma das seguintes opções:

        • Temporário para atribuir um novo endereço IPv4 temporário
        • Nenhum, para não atribuir um endereço IPv4 externo
        • Um endereço IPv4 estático reservado da lista
        • Reserve um endereço IP externo estático para reservar e atribuir um novo endereço IPv4 externo estático

      3. Se quiser, você pode atribuir um ou mais intervalos de IP de alias à interface de rede. Para atribuir um intervalo de IPs de alias, faça o seguinte:

        1. Em Intervalos de IP do alias, clique em Adicionar intervalo de IP.
        2. Em Intervalo da sub-rede, selecione um intervalo de endereços IPv4 principal ou secundário da sub-rede para usar.
        3. Em Intervalo de IP do alias, digite um intervalo de IP na notação CIDR. Esse intervalo precisa ser um intervalo não utilizado do intervalo de IP da sub-rede selecionada.

        Para mais informações sobre como atribuir intervalos de IP de alias a interfaces de rede de VM, consulte Configurar intervalos de IP de alias.

    7. Para NICs dinâmicas com endereços IPv6, configure um intervalo de endereços IPv6 internos ou externos, dependendo do tipo de acesso da sub-rede conectada. Em Endereço IPv6 interno principal ou Endereço IPv6 externo, selecione uma das seguintes opções:

      • Temporário (automático) para atribuir automaticamente um novo intervalo de endereços IPv6 temporários
      • Temporário (personalizado) para especificar manualmente um novo intervalo de endereços IPv6 temporários
      • 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 concluir a edição das propriedades da NIC dinâmica, clique em Concluído.

  5. Para salvar a configuração, clique em Salvar.

gcloud

Para adicionar uma NIC dinâmica a uma instância atual, 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:

  • INSTANCE_NAME: o nome da instância a que você quer adicionar a NIC dinâmica.
  • ZONE: 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 em que a NIC dinâmica é anexada.
  • SUBNET: a sub-rede em que a NIC dinâmica é anexada.

Como alternativa, você pode adicionar uma NIC dinâmica a uma instância ao atualizar as propriedades dela. Para mais informações, consulte Atualizar propriedades da instância.

API

Para adicionar uma NIC dinâmica a uma instância atual, 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:

  • 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 a que uma NIC dinâmica será adicionada
  • REGION: a região que contém a instância
  • SUBNET: a sub-rede em que a NIC dinâmica é anexada.
  • PARENT_VNIC_NAME: o nome da vNIC principal, como nic0
  • VLAN_ID: o ID da VLAN da NIC dinâmica

Como alternativa, você pode adicionar uma NIC dinâmica a uma instância ao atualizar as propriedades dela. Para mais informações, consulte Atualizar propriedades da instância.

Adicionar uma NIC dinâmica a instâncias em um MIG

Esta seção descreve como adicionar uma NIC dinâmica a instâncias em um MIG criando um modelo de instância e aplicando a configuração ao MIG. Não é possível atualizar um modelo de instância atual.

Para mais informações sobre como criar modelos de instância, consulte Como criar modelos de instância. Para conferir os modelos de instâncias atuais, consulte Receber, listar e excluir modelos de instâncias.

Console

  1. Acesse a página Modelos de instância.

    Acesse "Modelos de instância"

  2. Clique no modelo da instância que você quer copiar e atualizar.

  3. Clique em Criar semelhante.

  4. Expanda a seção Opções avançadas e depois a seção Rede.

  5. Na seçã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 criar a NIC dinâmica.

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

    4. Em Rede e Sub-rede, selecione a rede e a sub-rede que você quer usar.

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

      • IPv4 (pilha única)
      • IPv4 e IPv6 (pilha dupla)
      • IPv6 (pilha única)

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

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

        • Temporário (automático) para atribuir automaticamente um novo endereço IPv4 temporário
        • Temporário (personalizado) para especificar manualmente um novo endereço IPv4 temporário
        • 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. Em Endereço IPv4 externo, selecione uma das seguintes opções:

        • Temporário para atribuir um novo endereço IPv4 temporário
        • Nenhum, para não atribuir um endereço IPv4 externo
        • Um endereço IPv4 estático reservado da lista
        • Reserve um endereço IP externo estático para reservar e atribuir um novo endereço IPv4 externo estático

      3. Se quiser, você pode atribuir um ou mais intervalos de IP de alias à interface de rede. Para atribuir um intervalo de IPs de alias, faça o seguinte:

        1. Em Intervalos de IP do alias, clique em Adicionar intervalo de IP.
        2. Em Intervalo da sub-rede, selecione um intervalo de endereços IPv4 principal ou secundário da sub-rede para usar.
        3. Em Intervalo de IP do alias, digite um intervalo de IP na notação CIDR. Esse intervalo precisa ser um intervalo não utilizado do intervalo de IP da sub-rede selecionada.

        Para mais informações sobre como atribuir intervalos de IP de alias a interfaces de rede de VM, consulte Configurar intervalos de IP de alias.

    7. Para NICs dinâmicas com endereços IPv6, configure um intervalo de endereços IPv6 internos ou externos, dependendo do tipo de acesso da sub-rede conectada. Em Endereço IPv6 interno principal ou Endereço IPv6 externo, selecione uma das seguintes opções:

      • Temporário (automático) para atribuir automaticamente um novo intervalo de endereços IPv6 temporários
      • Temporário (personalizado) para especificar manualmente um novo intervalo de endereços IPv6 temporários
      • 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 concluir 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 as etapas para aplicar novas configurações de VM em um MIG.

    Se você quiser atualizar as instâncias sem reiniciá-las ou recriá-las, defina a ação mínima como REFRESH. Para ver mais informações, consulte os seguintes tópicos:

gcloud

  1. Para criar um 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 atual e adicione uma nova interface que especifique a chave vlan para criar uma NIC dinâmica.

    O exemplo a seguir adiciona uma NIC dinâmica em nic0. Você pode especificar outras interfaces de rede e propriedades conforme necessário. Para mais exemplos de como criar instâncias com várias interfaces de rede, consulte Criar 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:

    • INSTANCE_TEMPLATE_NAME: um nome para o novo modelo de instância.
    • NETWORK_A, NETWORK_B: a rede em que a interface é anexada.
    • SUBNET_A, SUBNET_B: a sub-rede em que a interface é anexada.
    • VLAN_ID: um ID da VLAN. Especificar um ID da VLAN configura a interface de rede como uma NIC dinâmica. Você precisa colocar uma NIC dinâmica depois da vNIC mãe no comando.

  2. Siga as etapas para aplicar novas configurações de VM em um MIG.

    Se você quiser atualizar as instâncias sem reiniciá-las ou recriá-las, defina a ação mínima como REFRESH. Para ver mais informações, consulte os seguintes tópicos:

API

  1. Para criar um 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 atual e adicione uma nova interface que inclua o campo vlan para criar uma NIC dinâmica.

    O exemplo a seguir adiciona uma NIC dinâmica em nic0. Você pode especificar outras interfaces de rede e propriedades conforme necessário. Para mais exemplos de como criar instâncias com várias interfaces de rede, consulte Criar 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:

    • 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 em que cada interface de rede está localizada.
    • VLAN_ID: um ID da VLAN. Especificar um ID da VLAN configura a interface de rede como uma NIC dinâmica. Você precisa colocar uma NIC dinâmica após a vNIC mãe na solicitação.

  2. Siga as etapas para aplicar novas configurações de VM em um MIG.

    Se você quiser atualizar as instâncias sem reiniciá-las ou recriá-las, defina a ação mínima como REFRESH. Para ver mais informações, consulte os seguintes tópicos:

Configurar o SO convidado para NICs dinâmicas

Nesta seção, descrevemos como concluir a configuração adicional do SO convidado necessária ao adicionar NICs dinâmicas a uma instância nova ou atual.

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

Opção de configuração Descrição
Configurar o gerenciamento automático de NICs dinâmicas (recomendado)

Use o agente convidado para o gerenciamento automático de NICs dinâmicas.

O ambiente convidado inclui o agente convidado, que automatiza a instalação e o gerenciamento de interfaces de VLAN no namespace raiz em distribuições Linux de imagens do Google Cloud OS.

Se você configurar o gerenciamento automático de NICs dinâmicas, use a versão 20251115.00 ou mais recente do agente convidado. Embora o suporte a essa funcionalidade tenha sido introduzido na versão 20250204.02 do agente convidado, há um problema conhecido com as versões 20250901.00 a 20251108.00 do agente convidado em que as NICs dinâmicas não são instaladas e gerenciadas automaticamente.
Configurar o SO convidado manualmente

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

Se você usar essa opção, a configuração não será mantida automaticamente após a reinicialização da instância. Para que as configurações persistam após uma reinicialização, use o método recomendado para configurar interfaces de rede permanentes na sua distribuição do Linux. Por exemplo, consulte NetworkConfiguration para Debian e interfaces para Ubuntu.

Configurar o gerenciamento automático de NICs dinâmicas

Nesta seção, descrevemos como configurar o gerenciamento automático de NICs dinâmicas usando o agente convidado.

Você só precisa concluir essas etapas uma vez por instância. Se você adicionou uma NIC dinâmica a uma instância para a qual já concluiu essas etapas, não é necessário repeti-las.

Para configurar o gerenciamento automático de NICs dinâmicas:

  1. Conecte-se à instância usando SSH.

  2. Verifique se a instância está executando a versão 20251115.00 ou mais recente do agente convidado:

    1. Para determinar se a instância está executando o agente convidado, execute o comando apropriado listado em Pacotes instalados para o ambiente de convidado.

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

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

      Ao instalar ou atualizar o ambiente convidado, você garante que tem a versão mais recente do agente convidado. Para confirmar a versão, siga as etapas em Validar o ambiente de convidado.

  3. Configure o agente convidado para gerenciar NICs dinâmicas:

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

      edit /etc/default/instance_configs.cfg

    2. Adicione o seguinte ao arquivo de configuração, salve as mudanças e saia do editor.

      [NetworkInterfaces]
vlan_setup_enabled = true
manage_primary_nic = true

      Para informações sobre essas configurações, consulte:

      • vlan_setup_enabled = true: configura o agente convidado para instalar e gerenciar NICs dinâmicas
      • manage_primary_nic = true: uma configuração adicional necessária para que o agente convidado gerencie NICs dinâmicas criadas em nic0

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

    3. Reinicie o agente convidado executando o seguinte comando: Como alternativa, reinicie a instância.

      sudo systemctl restart google-guest-agent.service

  4. Liste as interfaces de rede na instância para verificar se o agente convidado instalou as NICs dinâmicas.

    Por exemplo, o comando a seguir mostra um nome como a-gcp.ens4.11 para uma NIC dinâmica com um ID de VLAN de 11 criada como filha da interface ens4.

    sudo ip -d addr

Configurar o SO convidado manualmente

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

  1. Conecte-se à instância usando SSH.

  2. Se a instância estiver executando o agente convidado, desative o gerenciamento automático de NICs dinâmicas. Para determinar se a instância está executando o agente de convidado, use o comando apropriado listado em Pacotes instalados para o ambiente de convidado.

    Para desativar o gerenciamento automático de NICs dinâmicas:

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

        edit /etc/default/instance_configs.cfg

    2. Adicione o seguinte ao arquivo de configuração, salve as mudanças e saia do editor.

      [NetworkInterfaces]
vlan_setup_enabled = false
manage_primary_nic = false

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

    3. Reinicie o agente convidado executando o seguinte comando: Como alternativa, reinicie a instância.

      sudo systemctl restart google-guest-agent.service

  3. Para cada NIC dinâmica criada, faça o seguinte:

    1. Receba o endereço MAC da 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 mãe e pelo 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, em uma VM do 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:

      • VNIC_NAME: o nome da vNIC principal atribuído pelo sistema operacional, como eth1 ou ens4
      • IP_ADDRESS: o endereço IP da NIC dinâmica que você criou.
      • VLAN_ID: o ID da VLAN atribuído à NIC dinâmica
      • MAC_ADDRESS: o endereço MAC que você recebeu na etapa anterior.

A seguir