Cómo agregar NIC dinámicas a una instancia

Para obtener información sobre cómo crear instancias nuevas, consulta Crea VMs con interfaces de red múltiples.

Antes de comenzar

Antes de agregar NIC dinámicas a una instancia, haz lo siguiente:

• Asegúrate de conocer las propiedades y limitaciones de las NIC dinámicas, como se describe en la descripción general de las interfaces de red múltiples.
• Si es necesario, sigue las instrucciones que se indican en Cómo ver las interfaces de red de una instancia para ver las interfaces de red existentes de tu instancia.

Cómo agregar una NIC dinámica

En esta sección, se describe cómo agregar una NIC dinámica a una instancia.

Cuando agregues una NIC dinámica, es posible que observes una demora de propagación. Esta demora suele ser de algunos segundos, pero puede ser, en algunos casos, de hasta un minuto.

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

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

Configura el SO invitado para las NIC dinámicas

En esta sección, se describe cómo completar la configuración adicional del SO invitado que se requiere cuando agregas NIC dinámicas a una instancia nueva o existente.

Elige una de las siguientes opciones de configuración:

Configura la administración automática de las NIC dinámicas

En esta sección, se describe cómo configurar la administración automática de las NIC dinámicas con el agente invitado de Google.

Solo debes completar estos pasos una vez por instancia. Si agregaste una NIC dinámica a una instancia para la que ya completaste estos pasos, no es necesario que los repitas.

Para configurar la administración automática de las NIC dinámicas, sigue estos pasos:

1. Conéctate a la instancia mediante SSH.

2. Asegúrate de que la instancia ejecute el agente invitado de Google en la versión 20250204.02 o posterior:

   1. Para determinar si la instancia ejecuta el agente invitado de Google, ejecuta el comando adecuado que se enumera en Paquetes instalados para el entorno invitado.

      1. Si tu instancia no ejecuta el agente de invitado de Google, instala el entorno invitado.

      2. Si tu instancia ejecuta el agente invitado de Google, actualiza el entorno invitado.

      Instalar o actualizar el entorno de invitado garantiza que tengas la versión más reciente del agente de invitado de Google. Para confirmar la versión, sigue los pasos que se indican en Cómo validar el entorno invitado.

3. Configura el agente invitado de Google para administrar las NIC dinámicas:

   1. Abre o crea el archivo de configuración del entorno invitado.

      edit /etc/default/instance_configs.cfg
      

   2. Agrega lo siguiente al archivo de configuración y, luego, guarda los cambios y sal del editor.

      [NetworkInterfaces]
      vlan_setup_enabled = true
      manage_primary_nic = true
      

      Para obtener información sobre estos parámetros de configuración, consulta lo siguiente:

      • vlan_setup_enabled = true: Configura el agente invitado de Google para instalar y administrar NIC dinámicas.
      • manage_primary_nic = true: Es un parámetro de configuración adicional necesario para que el agente invitado de Google administre las NIC dinámicas creadas en nic0.

      Para obtener más información sobre cómo editar el archivo de configuración del agente invitado, consulta Configuración en la documentación del agente invitado de Google.

   3. Ejecuta el siguiente comando para reiniciar el agente invitado. Como alternativa, puedes reiniciar la instancia.

      sudo systemctl restart google-guest-agent.service
      

4. Haz una lista de las interfaces de red de tu instancia para ver que el agente de invitado de Google instaló tus NIC dinámicas.

   Por ejemplo, el siguiente comando muestra un nombre como a-gcp.ens4.11 para una NIC dinámica con un ID de VLAN de 11 creado como secundario de la interfaz ens4.

   sudo ip -d addr
   

Configura el SO invitado de forma manual

Para configurar NICs dinámicas en el SO invitado de una instancia de forma manual, sigue estos pasos:

1. Conéctate a la instancia mediante SSH.

2. Si la instancia ejecuta el agente invitado de Google, inhabilita la administración automática de las NIC dinámicas. Puedes determinar si la instancia ejecuta el agente invitado de Google con el comando adecuado que se enumera en Paquetes instalados para el entorno invitado.

   Para inhabilitar la administración automática de las NIC dinámicas, haz lo siguiente:

   1. Abre o crea el archivo de configuración del entorno invitado.

        edit /etc/default/instance_configs.cfg
        

   2. Agrega lo siguiente al archivo de configuración y, luego, guarda los cambios y sal del editor.

      [NetworkInterfaces]
      vlan_setup_enabled = false
      manage_primary_nic = false
      

      Para obtener más información sobre cómo editar el archivo de configuración del agente invitado, consulta Configuración en la documentación del agente invitado de Google.

   3. Ejecuta el siguiente comando para reiniciar el agente invitado. Como alternativa, puedes reiniciar la instancia.

      sudo systemctl restart google-guest-agent.service
      

3. Para cada NIC dinámica que creaste, haz lo siguiente:

   1. Obtén la dirección MAC de la vNIC superior. Para encontrar la dirección MAC, ejecuta el siguiente comando para consultar el servidor de metadatos:

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

      Reemplaza VNIC_NUMBER por el número de la vNIC superior. Por ejemplo, 0 para nic0 o 1 para nic1.

   2. Configura una subinterfaz en el SO invitado de la instancia. Por ejemplo, en una VM de Debian, ejecuta los siguientes 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
      

      Reemplaza lo siguiente:

      • VNIC_NAME: El nombre de la vNIC superior que asignó el sistema operativo, como eth1 o ens4
      • IP_ADDRESS: la dirección IP de la NIC dinámica que creaste
      • VLAN_ID: El ID de VLAN que asignaste a la NIC dinámica
      • MAC_ADDRESS: La dirección MAC que obtuviste en el paso anterior