Agrega interfaces de red dinámicas a una instancia

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

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:

Agrega una NIC dinámica

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

Cuando agregas 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.

Agrega una NIC dinámica a una instancia

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

Console

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

    Ir a Instancias de VM

  2. Haz clic en el nombre de la instancia para la que deseas agregar 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, haz clic en Agregar una interfaz de red dinámica y haz lo siguiente:

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

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

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

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

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

      • IPv4 (pila única)
      • IPv4 e IPv6 (pila doble)
      • IPv6 (pila única)

    6. Para las NIC 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 dirección IPv4 efímera nueva
        • Una dirección IPv4 reservada estática interna de la lista
        • Reservar dirección IPv4 interna estática para reservar y asignar una dirección IPv4 interna estática nueva

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

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

      3. De manera opcional, puedes asignar uno o más rangos de alias de IP a la interfaz de red. Para asignar un rango de IP de alias, haz lo siguiente:

        1. En Rangos de IP de alias, haz clic en Agregar rango de IP.
        2. En Rango de subred, selecciona un rango de direcciones IPv4 principal de subred o un rango de direcciones IPv4 secundario de subred para usar.
        3. En Rango de IP de alias, ingresa un rango de IP en la notación CIDR. Este rango debe ser un rango no utilizado del rango de IP de la subred que seleccionaste.

        Para obtener más información sobre cómo asignar rangos de IP de alias a interfaces de red de VM, consulta Configura rangos de IP de alias.

    7. Para las NIC dinámicas con direcciones IPv6, configura un rango de direcciones IPv6 internas o externas, según el tipo de acceso de la subred conectada. En Dirección IPv6 interna principal o Dirección IPv6 externa, selecciona una de las siguientes opciones:

      • Efímera (automática) para asignar automáticamente un nuevo rango de direcciones IPv6 efímeras
      • Efímera (personalizada) para especificar manualmente un nuevo rango de direcciones IPv6 efímeras
      • Un rango 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 rango de direcciones IPv6 estáticas

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

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

gcloud

Para agregar una NIC dinámica a una instancia existente, 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

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de la instancia a la que se agregará la NIC dinámica.
  • ZONE: Es la zona de la instancia.
  • VLAN_ID: ID de VLAN de la NIC dinámica
  • PARENT_VNIC_NAME: Es el nombre de la vNIC principal, como nic0.
  • NETWORK: Es la red a la que se adjunta la NIC dinámica.
  • SUBNET: Es la subred a la que se adjunta la NIC dinámica.

Como alternativa, puedes agregar una NIC dinámica a una instancia cuando actualices las propiedades de la instancia. Para obtener más información, consulta Actualiza las propiedades de las instancias.

API

Para agregar una NIC dinámica a una instancia existente, 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"
}

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto que contiene la instancia
  • ZONE: la zona que contiene la instancia
  • INSTANCE_NAME: Es el nombre de la instancia a la que se agregará una NIC 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: Es el nombre de la vNIC principal, como nic0.
  • VLAN_ID: ID de VLAN de la NIC dinámica

Como alternativa, puedes agregar una NIC dinámica a una instancia cuando actualices las propiedades de la instancia. Para obtener más información, consulta Actualiza las propiedades de las instancias.

Agrega una NIC dinámica a instancias en un MIG

En esta sección, se describe cómo agregar una NIC dinámica a las instancias de un MIG creando una plantilla de instancias nueva y aplicando la configuración al MIG. No se admite la actualización de una plantilla de instancias existente.

Para obtener más información sobre cómo crear plantillas de instancias, consulta Crea plantillas de instancias. Para ver las plantillas de instancias existentes, consulta Obtén, enumera y borra plantillas de instancias.

Console

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

    Ir a Plantillas de instancia

  2. Haz clic en la plantilla de instancias que deseas copiar y actualizar.

  3. Haz clic en Crear una similar.

  4. Expande la sección Opciones avanzadas y, luego, la sección Herramientas de redes.

  5. En la sección Interfaces de red dinámicas, haz clic en Agregar una interfaz de red dinámica y haz lo siguiente:

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

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

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

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

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

      • IPv4 (pila única)
      • IPv4 e IPv6 (pila doble)
      • IPv6 (pila única)

    6. Para las NIC 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 dirección IPv4 efímera nueva
        • Una dirección IPv4 reservada estática interna de la lista
        • Reservar dirección IPv4 interna estática para reservar y asignar una dirección IPv4 interna estática nueva

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

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

      3. De manera opcional, puedes asignar uno o más rangos de alias de IP a la interfaz de red. Para asignar un rango de IP de alias, haz lo siguiente:

        1. En Rangos de IP de alias, haz clic en Agregar rango de IP.
        2. En Rango de subred, selecciona un rango de direcciones IPv4 principal de subred o un rango de direcciones IPv4 secundario de subred para usar.
        3. En Rango de IP de alias, ingresa un rango de IP en la notación CIDR. Este rango debe ser un rango no utilizado del rango de IP de la subred que seleccionaste.

        Para obtener más información sobre cómo asignar rangos de IP de alias a interfaces de red de VM, consulta Configura rangos de IP de alias.

    7. Para las NIC dinámicas con direcciones IPv6, configura un rango de direcciones IPv6 internas o externas, según el tipo de acceso de la subred conectada. En Dirección IPv6 interna principal o Dirección IPv6 externa, selecciona una de las siguientes opciones:

      • Efímera (automática) para asignar automáticamente un nuevo rango de direcciones IPv6 efímeras
      • Efímera (personalizada) para especificar manualmente un nuevo rango de direcciones IPv6 efímeras
      • Un rango 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 rango de direcciones IPv6 estáticas

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

  6. Para crear la plantilla de instancias, haz clic en Create.

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

    Si deseas actualizar las instancias sin reiniciarlas ni volver a crearlas, configura la acción mínima como REFRESH. Para obtener más información, consulta lo siguiente:

gcloud

  1. Para crear una plantilla de instancias nueva que agregue 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 instancias existente y agrega una interfaz de red nueva que especifique la clave vlan para crear una NIC dinámica.

    En el siguiente ejemplo, se agrega una NIC dinámica en nic0. Puedes especificar interfaces y propiedades de red adicionales según sea necesario. Para obtener más ejemplos de cómo crear instancias con varias interfaces de red, consulta Crea 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

    Reemplaza lo siguiente:

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

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

    Si deseas actualizar las instancias sin reiniciarlas ni volver a crearlas, configura la acción mínima como REFRESH. Para obtener más información, consulta lo siguiente:

API

  1. Para crear una plantilla de instancias nueva que agregue una NIC dinámica, usa el método instanceTemplates.insert para crear una plantilla de instancias global o el método regionInstanceTemplates.insert para crear una plantilla de instancias regional.

    En el campo networkInterfaces, especifica cada interfaz de red de tu plantilla de instancias existente y agrega una interfaz de red nueva que incluya el campo vlan para crear una NIC dinámica.

    En el siguiente ejemplo, se agrega una NIC dinámica en nic0. Puedes especificar interfaces y propiedades de red adicionales según sea necesario. Para obtener más ejemplos de cómo crear instancias con varias interfaces de red, consulta Crea 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...
 }

    Reemplaza lo siguiente:

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

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

    Si deseas actualizar las instancias sin reiniciarlas ni volver a crearlas, configura la acción mínima como REFRESH. Para obtener más información, consulta lo siguiente:

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:

Opción de configuración Descripción
Configura la administración automática de NIC dinámicas (recomendado)

Usar el agente invitado para la administración automática de NIC dinámicas

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

Si configuras la administración automática de NIC dinámicas, usa la versión 20251115.00 o posterior del agente invitado. Si bien la compatibilidad con esta funcionalidad se introdujo en la versión 20250204.02 del agente invitado, existe un problema conocido con las versiones 20250901.00 a 20251108.00 del agente invitado en las que las NIC dinámicas no se instalan ni administran automáticamente.
Configura el SO invitado de forma manual

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

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

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

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

Solo necesitas 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 NIC dinámicas, haz lo siguiente:

  1. Conéctate a la instancia con SSH.

  2. Asegúrate de que la instancia ejecute la versión 20251115.00 o posterior del agente invitado:

    1. Para determinar si la instancia ejecuta el agente invitado, ejecuta el comando adecuado que se enumera 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.

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

  3. Configura el agente invitado 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, 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 para instalar y administrar NIC dinámicas.
      • manage_primary_nic = true: Es un parámetro de configuración adicional que requiere el agente invitado para administrar 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.

    3. Reinicia el agente invitado con el siguiente comando. Como alternativa, puedes reiniciar la instancia.

      sudo systemctl restart google-guest-agent.service

  4. Enumera las interfaces de red en tu instancia para ver que el agente invitado 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 hijo de la interfaz ens4.

    sudo ip -d addr

Configura el SO invitado de forma manual

Para configurar NIC dinámicas en el SO invitado de una instancia de forma manual, haz lo siguiente:

  1. Conéctate a la instancia con SSH.

  2. Si la instancia ejecuta el agente invitado, inhabilita la administración automática de las NIC dinámicas. Puedes determinar si la instancia ejecuta el agente invitado 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, 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.

    3. Reinicia el agente invitado con el siguiente comando. 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 NIC dinámica. Para encontrar la dirección MAC, ejecuta el siguiente comando para consultar el servidor de metadatos:

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

      Reemplaza 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 para nic0.2 o 1/4 para nic1.4.

    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 principal asignada por el sistema operativo, como eth1 o ens4
      • IP_ADDRESS: La dirección IP de la NIC dinámica que creaste
      • VLAN_ID: ID de VLAN que asignaste a la NIC dinámica
      • MAC_ADDRESS: La dirección MAC que obtuviste en el paso anterior

¿Qué sigue?