Añadir interfaces de red dinámicas a una instancia

En esta página se describe cómo añadir una interfaz de red dinámica (NIC) a una instancia de Compute Engine.

Para obtener información sobre cómo crear instancias, consulta Crear VMs con varias interfaces de red.

Antes de empezar

Antes de añadir NICs dinámicas a una instancia, haz lo siguiente:

Añadir una interfaz de red dinámica

En las siguientes secciones se describe cómo añadir una NIC dinámica a una instancia individual o a instancias que forman parte de un grupo de instancias gestionado (MIG).

Cuando añades una NIC dinámica, puede que observes un retraso en la propagación. Este retraso suele ser de unos segundos, pero en casos excepcionales puede ser de hasta un minuto.

Añadir una interfaz de red dinámica a una instancia

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

Consola

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a instancias de VM

  2. Haga clic en el nombre de la instancia a la que quiera añadir una NIC dinámica.

  3. En la página de detalles de la instancia, haz clic en Editar.

  4. En la sección Interfaces de red dinámicas, haga clic en Añadir una interfaz de red dinámica y siga estos pasos:

    1. En el campo Tipo de interfaz, selecciona VPC.

    2. En el campo Interfaz de red principal, selecciona la vNIC principal para la que quieras crear la NIC dinámica.

    3. En el campo ID de VLAN, introduce el ID de VLAN de la NIC dinámica.

    4. En Red y Subred, selecciona la red y la subred que quieras usar.

    5. Selecciona una de las siguientes opciones para el tipo de pila de IP de la NIC dinámica:

      • IPv4 (single-stack)
      • IPv4 e IPv6 (pila dual)
      • IPv6 (pila única)

    6. En el caso de las NICs dinámicas con direcciones IPv4, haz lo siguiente:

      1. En Dirección IPv4 interna principal, selecciona una de las siguientes opciones:

        • Efímera (automática) para asignar automáticamente una nueva dirección IPv4 efímera
        • Efímera (personalizada) para especificar manualmente una nueva dirección IPv4 efímera
        • Una dirección IPv4 interna estática reservada de la lista
        • Reservar dirección IPv4 interna estática para reservar y asignar una nueva dirección IPv4 interna estática

      2. En Dirección IPv4 externa, seleccione una de las siguientes opciones:

        • Efímera para asignar una nueva dirección IPv4 efímera
        • Ninguna para no asignar una dirección IPv4 externa
        • Una dirección IPv4 estática reservada de la lista
        • Reservar dirección IP externa estática para reservar y asignar una nueva dirección IPv4 externa estática

      3. También puedes asignar uno o varios intervalos de IPs alias a la interfaz de red. Para asignar un intervalo de IPs de alias, sigue estos pasos:

        1. En Intervalos de IP de alias, haz clic en Añadir intervalo de IPs.
        2. En Intervalo de subred, selecciona un intervalo de direcciones IPv4 principal o secundario de la subred que quieras usar.
        3. En Intervalo de IP de alias, introduce un intervalo de IP en notación CIDR. Este intervalo debe ser un intervalo sin usar del intervalo de IPs de la subred que hayas seleccionado.

        Para obtener más información sobre cómo asignar intervalos de IP de alias a interfaces de red de VMs, consulta Configurar intervalos de IP de alias.

    7. En el caso de las NICs dinámicas con direcciones IPv6, configura un intervalo de direcciones IPv6 interno o externo, en función del tipo de acceso de la subred conectada. En Dirección IPv6 interna principal o Dirección IPv6 externa, elija una de las siguientes opciones:

      • Efímera (automática) para asignar automáticamente un nuevo intervalo de direcciones IPv6 efímeras.
      • Efímera (personalizada) para especificar manualmente un nuevo intervalo de direcciones IPv6 efímeras
      • Un intervalo de direcciones IPv6 estáticas reservadas de la lista
      • Reservar dirección IPv6 interna estática o Reservar dirección IPv6 externa estática para reservar y asignar un nuevo intervalo de direcciones IPv6 estáticas

    8. Para terminar de editar las propiedades de la NIC dinámica, haga clic en Hecho.

  5. Para guardar la configuración, haz clic en Guardar.

gcloud

Para añadir una NIC dinámica a una instancia, usa el 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

Haz los cambios siguientes:

  • INSTANCE_NAME: el nombre de la instancia a la que se va a añadir la interfaz de red dinámica
  • ZONE: la zona de la instancia
  • VLAN_ID: el ID de VLAN de la interfaz de red dinámica
  • PARENT_VNIC_NAME: el nombre de la vNIC principal, como nic0
  • NETWORK: la red a la que se conecta la interfaz de red dinámica
  • SUBNET: la subred a la que se conecta la interfaz de red dinámica

También puede añadir una NIC dinámica a una instancia al actualizar las propiedades de la instancia. Para obtener más información, consulta Actualizar las propiedades de una instancia.

API

Para añadir una NIC dinámica a una instancia, usa el 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"
}

Haz los cambios siguientes:

  • PROJECT_ID: ID del proyecto que contiene la instancia
  • ZONE: la zona que contiene la instancia
  • INSTANCE_NAME: el nombre de la instancia a la que se va a añadir una interfaz de red dinámica
  • REGION: la región que contiene la instancia
  • SUBNET: la subred a la que se adjunta la NIC dinámica
  • PARENT_VNIC_NAME: el nombre de la vNIC principal, como nic0
  • VLAN_ID: el ID de VLAN de la interfaz de red dinámica

También puede añadir una NIC dinámica a una instancia al actualizar las propiedades de la instancia. Para obtener más información, consulta Actualizar las propiedades de una instancia.

Añadir una NIC dinámica a instancias de un MIG

En esta sección se describe cómo añadir una NIC dinámica a las instancias de un MIG creando una plantilla de instancia y aplicando la configuración al MIG. No se pueden actualizar las plantillas de instancia.

Para obtener más información sobre cómo crear plantillas de instancia, consulta el artículo Crear plantillas de instancia. Para ver las plantillas de instancia, consulta Obtener, mostrar y eliminar plantillas de instancia.

Consola

  1. Ve a la página Plantillas de instancias.

    Ir a Plantillas de instancia

  2. Haz clic en la plantilla de instancia que quieras copiar y actualizar.

  3. Haz clic en Crear similar.

  4. Despliega la sección Opciones avanzadas y, a continuación, la sección Redes.

  5. En la sección Interfaces de red dinámicas, haga clic en Añadir una interfaz de red dinámica y siga estos pasos:

    1. En el campo Tipo de interfaz, selecciona VPC.

    2. En el campo Interfaz de red principal, selecciona la vNIC principal para la que quieras crear la NIC dinámica.

    3. En el campo ID de VLAN, introduce el ID de VLAN de la NIC dinámica.

    4. En Red y Subred, selecciona la red y la subred que quieras usar.

    5. Selecciona una de las siguientes opciones para el tipo de pila de IP de la NIC dinámica:

      • IPv4 (single-stack)
      • IPv4 e IPv6 (pila dual)
      • IPv6 (pila única)

    6. En el caso de las NICs dinámicas con direcciones IPv4, haz lo siguiente:

      1. En Dirección IPv4 interna principal, selecciona una de las siguientes opciones:

        • Efímera (automática) para asignar automáticamente una nueva dirección IPv4 efímera
        • Efímera (personalizada) para especificar manualmente una nueva dirección IPv4 efímera
        • Una dirección IPv4 interna estática reservada de la lista
        • Reservar dirección IPv4 interna estática para reservar y asignar una nueva dirección IPv4 interna estática

      2. En Dirección IPv4 externa, seleccione una de las siguientes opciones:

        • Efímera para asignar una nueva dirección IPv4 efímera
        • Ninguna para no asignar una dirección IPv4 externa
        • Una dirección IPv4 estática reservada de la lista
        • Reservar dirección IP externa estática para reservar y asignar una nueva dirección IPv4 externa estática

      3. También puedes asignar uno o varios intervalos de IPs alias a la interfaz de red. Para asignar un intervalo de IPs de alias, sigue estos pasos:

        1. En Intervalos de IP de alias, haz clic en Añadir intervalo de IPs.
        2. En Intervalo de subred, selecciona un intervalo de direcciones IPv4 principal o secundario de la subred que quieras usar.
        3. En Intervalo de IP de alias, introduce un intervalo de IP en notación CIDR. Este intervalo debe ser un intervalo sin usar del intervalo de IPs de la subred que hayas seleccionado.

        Para obtener más información sobre cómo asignar intervalos de IP de alias a interfaces de red de VMs, consulta Configurar intervalos de IP de alias.

    7. En el caso de las NICs dinámicas con direcciones IPv6, configura un intervalo de direcciones IPv6 interno o externo, en función del tipo de acceso de la subred conectada. En Dirección IPv6 interna principal o Dirección IPv6 externa, elija una de las siguientes opciones:

      • Efímera (automática) para asignar automáticamente un nuevo intervalo de direcciones IPv6 efímeras.
      • Efímera (personalizada) para especificar manualmente un nuevo intervalo de direcciones IPv6 efímeras
      • Un intervalo de direcciones IPv6 estáticas reservadas de la lista
      • Reservar dirección IPv6 interna estática o Reservar dirección IPv6 externa estática para reservar y asignar un nuevo intervalo de direcciones IPv6 estáticas

    8. Para terminar de editar las propiedades de la NIC dinámica, haga clic en Hecho.

  6. Para crear la plantilla de instancia, haga clic en Crear.

  7. Sigue los pasos para aplicar nuevas configuraciones de VM en un MIG.

    Si quieres actualizar las instancias sin reiniciarlas ni volver a crearlas, define la acción mínima como REFRESH. Para obtener más información, consulta las siguientes secciones:

gcloud

  1. Para crear una plantilla de instancia que añada una NIC dinámica, usa el comando gcloud compute instance-templates create.

    Incluye la marca --network-interface para cada interfaz de red de tu plantilla de instancia y añade una interfaz de red que especifique la clave vlan para crear una NIC dinámica.

    En el siguiente ejemplo se añade una NIC dinámica en nic0. Puedes especificar interfaces de red y propiedades adicionales según sea necesario. Para ver más ejemplos de cómo crear instancias con varias interfaces de red, consulta Crear VMs con varias interfaces de red.

    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

    Haz los cambios siguientes:

    • INSTANCE_TEMPLATE_NAME: nombre de la nueva plantilla de instancia.
    • NETWORK_A, NETWORK_B: la red a la que se conecta la interfaz.
    • SUBNET_A, SUBNET_B: la subred a la que se adjunta la interfaz.
    • VLAN_ID: un ID de VLAN. Si especifica un ID de VLAN, la interfaz de red se configurará como NIC dinámica. Debes colocar una NIC dinámica después de su NIC virtual principal en el comando.

  2. Sigue los pasos para aplicar nuevas configuraciones de VM en un MIG.

    Si quieres actualizar las instancias sin reiniciarlas ni volver a crearlas, define la acción mínima como REFRESH. Para obtener más información, consulta las siguientes secciones:

API

  1. Para crear una plantilla de instancia que añada una NIC dinámica, utilice el método instanceTemplates.insert para crear una plantilla de instancia global o el método regionInstanceTemplates.insert para crear una plantilla de instancia regional.

    En el campo networkInterfaces, especifica cada interfaz de red de tu plantilla de instancia y añade una nueva interfaz de red que incluya el campo vlan para crear una NIC dinámica.

    En el siguiente ejemplo se añade una NIC dinámica en nic0. Puedes especificar interfaces de red y propiedades adicionales según sea necesario. Para ver más ejemplos de cómo crear instancias con varias interfaces de red, consulta Crear VMs con varias interfaces de red.

    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...
 }

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto que contiene la plantilla de instancia.
    • REGION: la región que contiene las instancias.
    • SUBNET_A, SUBNET_B: las subredes en las que se encuentra cada interfaz de red.
    • VLAN_ID: un ID de VLAN. Si especifica un ID de VLAN, la interfaz de red se configurará como NIC dinámica. Debes colocar una NIC dinámica después de su NIC virtual principal en la solicitud.

  2. Sigue los pasos para aplicar nuevas configuraciones de VM en un MIG.

    Si quieres actualizar las instancias sin reiniciarlas ni volver a crearlas, define la acción mínima como REFRESH. Para obtener más información, consulta las siguientes secciones:

Configurar el SO invitado para NICs dinámicas

En esta sección se describe cómo completar la configuración adicional del SO invitado que se requiere cuando se añaden NICs dinámicas a una instancia nueva o ya creada.

Elige una de las siguientes opciones de configuración:

Opción de configuración Descripción
Configurar la gestión automática de NICs dinámicas (recomendado)

Usa el agente invitado para gestionar automáticamente las NICs dinámicas.

El entorno invitado incluye el agente invitado, que automatiza la instalación y la gestión de interfaces VLAN en el espacio de nombres raíz de las distribuciones de Linux de las imágenes del SO Google Cloud .

Si configuras la gestión automática de NICs dinámicas, usa la versión 20251115.00 o una posterior del agente invitado. Aunque se introdujo la compatibilidad con esta función en la versión 20250204.02 del agente invitado, hay un problema conocido con las versiones 20250901.00 a 20251108.00 del agente invitado, en las que las NICs dinámicas no se instalan ni se gestionan automáticamente.
Configurar el SO invitado manualmente

Ejecuta comandos en el SO invitado para instalar las NICs dinámicas.

Si usas esta opción, la configuración no se conservará automáticamente después de reiniciar la instancia. Para que las configuraciones se conserven después de reiniciar, usa el método recomendado para configurar interfaces de red persistentes en tu distribución de Linux. Por ejemplo, consulta NetworkConfiguration en Debian e interfaces en Ubuntu.

Configurar la gestión automática de NICs dinámicas

En esta sección se describe cómo configurar la gestión automática de NICs dinámicas mediante el agente invitado.

Solo tiene que completar estos pasos una vez por instancia. Si has añadido una NIC dinámica a una instancia para la que ya has completado estos pasos, no es necesario que los repitas.

Para configurar la gestión automática de NICs dinámicas, siga estos pasos:

  1. Conéctate a la instancia mediante SSH.

  2. Asegúrate de que la instancia esté ejecutando la versión 20251115.00 del agente invitado o una posterior:

    1. Para determinar si la instancia está ejecutando el agente invitado, ejecuta el comando adecuado que se indica en Paquetes instalados para el entorno invitado.

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

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

      Al instalar o actualizar el entorno de invitado, te aseguras de tener la versión más reciente del agente invitado. Para confirmar la versión, sigue los pasos que se indican en Validar el entorno de invitado.

  3. Configura el agente invitado para gestionar las NICs dinámicas:

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

      edit /etc/default/instance_configs.cfg

    2. Añade lo siguiente al archivo de configuración, guarda los cambios y cierra el editor.

      [NetworkInterfaces]
vlan_setup_enabled = true
manage_primary_nic = true

      Para obtener información sobre estos ajustes, consulta lo siguiente:

      • vlan_setup_enabled = true: configura el agente invitado para instalar y gestionar NICs dinámicas.
      • manage_primary_nic = true: un ajuste adicional necesario para que el agente invitado gestione las NICs dinámicas creadas en nic0

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

    3. Reinicia el agente invitado ejecutando el siguiente comando. También puedes reiniciar la instancia.

      sudo systemctl restart google-guest-agent.service

  4. Lista las interfaces de red de tu instancia para comprobar que el agente invitado ha instalado tus NICs 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 creada como elemento secundario de la interfaz ens4.

    sudo ip -d addr

Configurar el SO invitado manualmente

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

  1. Conéctate a la instancia mediante SSH.

  2. Si la instancia ejecuta el agente invitado, inhabilita la gestión automática de NICs dinámicas. Para determinar si la instancia está ejecutando el agente invitado, usa el comando adecuado que se indica en Paquetes instalados para el entorno invitado.

    Para inhabilitar la gestión automática de NICs dinámicas, sigue estos pasos:

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

        edit /etc/default/instance_configs.cfg

    2. Añade lo siguiente al archivo de configuración, guarda los cambios y cierra el 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 la sección Configuración de la documentación del agente invitado.

    3. Reinicia el agente invitado ejecutando el siguiente comando. También puedes reiniciar la instancia.

      sudo systemctl restart google-guest-agent.service

  3. Sigue estos pasos con cada NIC dinámico que hayas creado:

    1. Obtén la dirección MAC de la NIC dinámica. Para encontrar la dirección MAC, consulta el servidor de metadatos ejecutando el siguiente comando:

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

      Sustituye VNIC_NUMBER/VLAN_ID por el número de la vNIC principal y el ID de VLAN de la NIC dinámica. Por ejemplo, 0/2 por nic0.2 o 1/4 por nic1.4.

    2. Configura una subinterfaz en el SO invitado de la instancia. Por ejemplo, en una máquina virtual 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

      Haz los cambios siguientes:

      • VNIC_NAME: el nombre de la vNIC principal asignado por el sistema operativo, como eth1 o ens4
      • IP_ADDRESS: la dirección IP de la NIC dinámica que has creado
      • VLAN_ID: el ID de VLAN que has asignado a la NIC dinámica
      • MAC_ADDRESS: la dirección MAC que has obtenido en el paso anterior

Siguientes pasos