Esta página se ha traducido con Cloud Translation API.

Añadir NICs 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 VM.

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:

Familiarízate con las propiedades y las limitaciones de las NICs dinámicas, tal como se describe en la sección Varias interfaces de red.
Si es necesario, consulta las interfaces de red de tu instancia siguiendo las instrucciones de Ver las interfaces de red de una instancia.

Añadir una interfaz de red dinámica

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

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.

gcloud

Para añadir una NIC dinámica a una instancia, usa el comando gcloud beta compute instances network-interfaces add.

gcloud beta 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.

Para añadir NICs dinámicas a un grupo de instancias gestionado (MIG), consulta el comando gcloud beta compute instance-groups managed set-instance-template.

API

Para añadir una NIC dinámica a una instancia, usa el método instances.addNetworkInterface.

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

Haz los cambios siguientes:

PROJECT_ID: ID del proyecto que contiene la instancia
ZONE: la zona que contiene la instancia
INSTANCE_NAME: 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.

Para añadir NICs dinámicas a un grupo de instancias gestionado (MIG), consulta el método instanceGroupManagers.setInstanceTemplate.

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 de Google para gestionar automáticamente las NICs dinámicas. El entorno invitado incluye el agente invitado de Google, 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 . Esta función está disponible en la versión 20250204.02 y posteriores del agente invitado de Google.
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 y interfaces en Ubuntu.

Opción de configuración

Descripción

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

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

El entorno invitado incluye el agente invitado de Google, 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 . Esta función está disponible en la versión 20250204.02 y posteriores del agente invitado de Google.

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 y 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 de Google.

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

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

Conéctate a la instancia mediante SSH.
Asegúrate de que la instancia esté ejecutando el agente invitado de Google con la versión 20250204.02 o una posterior:
1. Para determinar si la instancia está ejecutando el agente invitado de Google, ejecuta el comando adecuado que se indica en Paquetes instalados para el entorno invitado.
  1. Si tu instancia no ejecuta el agente invitado de Google, instala el entorno invitado.
  2. Si tu instancia ejecuta el agente invitado de Google, actualiza el entorno de invitado.
  Al instalar o actualizar el entorno de invitado, te aseguras de tener la versión más reciente del agente de invitado de Google. Para confirmar la versión, sigue los pasos que se indican en Validar el entorno de invitado.
Configura el agente invitado de Google 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 de Google para instalar y gestionar NICs dinámicas.
  - manage_primary_nic = true: un ajuste adicional necesario para que el agente invitado de Google 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 de Google.
3. Reinicia el agente invitado ejecutando el siguiente comando. También puedes reiniciar la instancia.
```
sudo systemctl restart google-guest-agent.service
```
Lista las interfaces de red de tu instancia para ver que el agente invitado de Google 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:

Conéctate a la instancia mediante SSH.
Si la instancia ejecuta el agente invitado de Google, inhabilita la gestión automática de NICs dinámicas. Para determinar si la instancia está ejecutando el agente invitado de Google, 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 de Google.
3. Reinicia el agente invitado ejecutando el siguiente comando. También puedes reiniciar la instancia.
```
sudo systemctl restart google-guest-agent.service
```
Sigue estos pasos con cada NIC dinámico que hayas creado:
1. Obtén la dirección MAC de la vNIC principal. Para encontrar la dirección MAC, consulta el servidor de metadatos ejecutando el siguiente comando:
```
curl http://metadata.google.internal/computeMetadata/v1/instance/network-interfaces/VNIC_NUMBER/mac -H "Metadata-Flavor: Google"
```
  Sustituye VNIC_NUMBER por el número de la vNIC principal. Por ejemplo, 0 para nic0 o 1 para nic1.
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