Ajouter des interfaces réseau dynamiques à une instance

Cette page explique comment ajouter une interface réseau dynamique à une instance Compute Engine existante.

Pour savoir comment créer des instances, consultez Créer des VM avec plusieurs interfaces réseau.

Avant de commencer

Avant d'ajouter des cartes d'interface réseau dynamiques à une instance, procédez comme suit :

Ajouter une interface réseau dynamique

Les sections suivantes décrivent comment ajouter une carte d'interface réseau dynamique à une instance individuelle ou à des instances faisant partie d'un groupe d'instances géré (MIG).

Lorsque vous ajoutez une carte d'interface réseau dynamique, vous pouvez observer un délai de propagation. Ce délai est généralement de quelques secondes, mais dans de rares cas, il peut aller jusqu'à une minute.

Ajouter une carte d'interface réseau dynamique à une instance

Cette section explique comment ajouter une carte d'interface réseau dynamique à une instance.

Console

  1. Dans la console Google Cloud , accédez à la page Instances de VM.

    Accéder à la page Instances de VM

  2. Cliquez sur le nom de l'instance à laquelle vous souhaitez ajouter une carte d'interface réseau dynamique.

  3. Sur la page "Détails de l'instance", cliquez sur Modifier.

  4. Dans la section Interfaces réseau dynamiques, cliquez sur Ajouter une interface réseau dynamique, puis procédez comme suit :

    1. Dans le champ Type d'interface, sélectionnez VPC.

    2. Dans le champ Interface réseau parente, sélectionnez la carte d'interface réseau virtuelle parente pour laquelle créer la carte d'interface réseau dynamique.

    3. Dans le champ ID de VLAN, saisissez l'ID de VLAN de l'interface réseau dynamique.

    4. Dans les champs Réseau et Sous-réseau, sélectionnez le réseau et le sous-réseau que vous souhaitez utiliser.

    5. Sélectionnez l'une des options suivantes pour le type de pile d'adresses IP de la carte d'interface réseau dynamique :

      • IPv4 (pile unique)
      • IPv4 et IPv6 (double pile)
      • IPv6 (pile unique)

    6. Pour les cartes d'interface réseau dynamiques avec des adresses IPv4, procédez comme suit :

      1. Dans le champ Adresse IPv4 interne principale, sélectionnez l'une des options suivantes :

        • Éphémère (automatique) pour attribuer automatiquement une nouvelle adresse IPv4 éphémère
        • Éphémère (personnalisée) pour spécifier manuellement une nouvelle adresse IPv4 éphémère
        • Une adresse IPv4 interne statique réservée de la liste
        • Réserver une adresse IPv4 interne statique pour réserver et attribuer une nouvelle adresse IPv4 interne statique

      2. Dans le champ Adresse IPv4 externe, sélectionnez l'une des options suivantes :

        • Éphémère pour attribuer une nouvelle adresse IPv4 éphémère
        • Aucune pour ne pas attribuer d'adresse IPv4 externe
        • Une adresse IPv4 statique réservée dans la liste
        • Réserver une adresse IP externe statique pour réserver et attribuer une nouvelle adresse IP externe statique

      3. Vous pouvez éventuellement attribuer une ou plusieurs plages d'adresses IP d'alias à l'interface réseau. Pour attribuer une plage d'adresses IP d'alias, procédez comme suit :

        1. Dans Plages d'adresses IP d'alias, cliquez sur Ajouter une plage d'adresses IP.
        2. Dans Plage de sous-réseaux, sélectionnez une plage d'adresses IPv4 principale ou secondaire à utiliser.
        3. Pour Plage d'adresses IP d'alias, saisissez une plage d'adresses IP au format CIDR. Il doit s'agir d'une plage non utilisée de la plage d'adresses IP du sous-réseau que vous avez sélectionné.

        Pour en savoir plus sur l'attribution de plages d'adresses IP d'alias aux interfaces réseau de VM, consultez Configurer des plages d'adresses IP d'alias.

    7. Pour les cartes d'interface réseau dynamiques avec des adresses IPv6, configurez une plage d'adresses IPv6 interne ou externe, selon le type d'accès du sous-réseau connecté. Pour l'adresse IPv6 interne principale ou l'adresse IPv6 externe, sélectionnez l'une des options suivantes :

      • Éphémère (automatique) pour attribuer automatiquement une nouvelle plage d'adresses IPv6 éphémères
      • Éphémère (personnalisée) pour spécifier manuellement une nouvelle plage d'adresses IPv6 éphémères
      • Une plage d'adresses IPv6 statiques réservées dans la liste
      • Réserver une adresse IPv6 interne statique ou Réserver une adresse IPv6 externe statique pour réserver et attribuer une nouvelle plage d'adresses IPv6 statiques

    8. Pour terminer la modification des propriétés de la carte d'interface réseau dynamique, cliquez sur OK.

  5. Pour enregistrer votre configuration, cliquez sur Enregistrer.

gcloud

Pour ajouter une carte d'interface réseau dynamique à une instance existante, utilisez la commande 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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance à laquelle ajouter l'interface réseau dynamique
  • ZONE : zone de l'instance
  • VLAN_ID : ID de VLAN de la carte d'interface réseau dynamique.
  • PARENT_VNIC_NAME : nom de la carte d'interface réseau virtuelle parente, par exemple nic0
  • NETWORK : réseau auquel l'interface réseau dynamique est associée.
  • SUBNET : sous-réseau auquel la carte d'interface réseau dynamique est associée

Vous pouvez également ajouter une carte d'interface réseau dynamique à une instance lorsque vous mettez à jour ses propriétés. Pour en savoir plus, consultez la section Mettre à jour les propriétés d'une instance.

API

Pour ajouter une carte d'interface réseau dynamique à une instance existante, utilisez la méthode 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"
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant l'instance
  • ZONE : zone dans laquelle se trouve l'instance.
  • INSTANCE_NAME : nom de l'instance à laquelle ajouter une carte d'interface réseau dynamique
  • REGION : région qui contient l'instance
  • SUBNET : sous-réseau auquel la carte d'interface réseau dynamique est associée
  • PARENT_VNIC_NAME : nom de la carte d'interface réseau virtuelle parente, par exemple nic0
  • VLAN_ID : ID de VLAN de la carte d'interface réseau dynamique.

Vous pouvez également ajouter une carte d'interface réseau dynamique à une instance lorsque vous mettez à jour ses propriétés. Pour en savoir plus, consultez la section Mettre à jour les propriétés d'une instance.

Ajouter une carte d'interface réseau dynamique à des instances dans un MIG

Cette section explique comment ajouter une carte d'interface réseau dynamique à des instances dans un MIG en créant un modèle d'instance et en appliquant la configuration au MIG. Il n'est pas possible de mettre à jour un modèle d'instance existant.

Pour en savoir plus sur la création de modèles d'instances, consultez la section Création de modèles d'instances. Pour afficher les modèles d'instance existants, consultez Obtenir, répertorier et supprimer des modèles d'instance.

Console

  1. Accédez à la page Modèles d'instance.

    Accéder à la page Modèles d'instances

  2. Cliquez sur le modèle d'instance que vous souhaitez copier et mettre à jour.

  3. Cliquez sur Créer une instance similaire.

  4. Développez la section Options avancées, puis la section Mise en réseau.

  5. Dans la section Interfaces réseau dynamiques, cliquez sur Ajouter une interface réseau dynamique, puis procédez comme suit :

    1. Dans le champ Type d'interface, sélectionnez VPC.

    2. Dans le champ Interface réseau parente, sélectionnez la carte d'interface réseau virtuelle parente pour laquelle créer la carte d'interface réseau dynamique.

    3. Dans le champ ID de VLAN, saisissez l'ID de VLAN de l'interface réseau dynamique.

    4. Dans les champs Réseau et Sous-réseau, sélectionnez le réseau et le sous-réseau que vous souhaitez utiliser.

    5. Sélectionnez l'une des options suivantes pour le type de pile d'adresses IP de la carte d'interface réseau dynamique :

      • IPv4 (pile unique)
      • IPv4 et IPv6 (double pile)
      • IPv6 (pile unique)

    6. Pour les cartes d'interface réseau dynamiques avec des adresses IPv4, procédez comme suit :

      1. Dans le champ Adresse IPv4 interne principale, sélectionnez l'une des options suivantes :

        • Éphémère (automatique) pour attribuer automatiquement une nouvelle adresse IPv4 éphémère
        • Éphémère (personnalisée) pour spécifier manuellement une nouvelle adresse IPv4 éphémère
        • Une adresse IPv4 interne statique réservée de la liste
        • Réserver une adresse IPv4 interne statique pour réserver et attribuer une nouvelle adresse IPv4 interne statique

      2. Dans le champ Adresse IPv4 externe, sélectionnez l'une des options suivantes :

        • Éphémère pour attribuer une nouvelle adresse IPv4 éphémère
        • Aucune pour ne pas attribuer d'adresse IPv4 externe
        • Une adresse IPv4 statique réservée dans la liste
        • Réserver une adresse IP externe statique pour réserver et attribuer une nouvelle adresse IP externe statique

      3. Vous pouvez éventuellement attribuer une ou plusieurs plages d'adresses IP d'alias à l'interface réseau. Pour attribuer une plage d'adresses IP d'alias, procédez comme suit :

        1. Dans Plages d'adresses IP d'alias, cliquez sur Ajouter une plage d'adresses IP.
        2. Dans Plage de sous-réseaux, sélectionnez une plage d'adresses IPv4 principale ou secondaire à utiliser.
        3. Pour Plage d'adresses IP d'alias, saisissez une plage d'adresses IP au format CIDR. Il doit s'agir d'une plage non utilisée de la plage d'adresses IP du sous-réseau que vous avez sélectionné.

        Pour en savoir plus sur l'attribution de plages d'adresses IP d'alias aux interfaces réseau de VM, consultez Configurer des plages d'adresses IP d'alias.

    7. Pour les cartes d'interface réseau dynamiques avec des adresses IPv6, configurez une plage d'adresses IPv6 interne ou externe, selon le type d'accès du sous-réseau connecté. Pour l'adresse IPv6 interne principale ou l'adresse IPv6 externe, sélectionnez l'une des options suivantes :

      • Éphémère (automatique) pour attribuer automatiquement une nouvelle plage d'adresses IPv6 éphémères
      • Éphémère (personnalisée) pour spécifier manuellement une nouvelle plage d'adresses IPv6 éphémères
      • Une plage d'adresses IPv6 statiques réservées dans la liste
      • Réserver une adresse IPv6 interne statique ou Réserver une adresse IPv6 externe statique pour réserver et attribuer une nouvelle plage d'adresses IPv6 statiques

    8. Pour terminer la modification des propriétés de la carte d'interface réseau dynamique, cliquez sur OK.

  6. Cliquez sur Create (Créer) pour créer le modèle d'instance.

  7. Suivez la procédure pour appliquer de nouvelles configurations de VM dans un MIG.

    Si vous souhaitez mettre à jour les instances sans les redémarrer ni les recréer, définissez l'action minimale sur REFRESH. Pour en savoir plus, consultez les ressources suivantes :

gcloud

  1. Pour créer un modèle d'instance qui ajoute une carte d'interface réseau dynamique, utilisez la commande gcloud compute instance-templates create.

    Pour chaque interface réseau de votre modèle d'instance existant, incluez l'option --network-interface et ajoutez une interface réseau qui spécifie la clé vlan pour créer une carte d'interface réseau dynamique.

    L'exemple suivant ajoute une carte d'interface réseau dynamique sous nic0. Vous pouvez spécifier des interfaces et des propriétés réseau supplémentaires si nécessaire. Pour obtenir d'autres exemples de création d'instances avec plusieurs interfaces réseau, consultez Créer des VM avec plusieurs interfaces réseau.

    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

    Remplacez les éléments suivants :

    • INSTANCE_TEMPLATE_NAME : nom du nouveau modèle d'instance.
    • NETWORK_A, NETWORK_B : réseau auquel l'interface est associée.
    • SUBNET_A, SUBNET_B : sous-réseau auquel l'interface est associée.
    • VLAN_ID : ID de VLAN. Si vous spécifiez un ID de VLAN, l'interface réseau est configurée en tant qu'interface réseau dynamique. Vous devez placer une interface réseau dynamique après sa carte d'interface réseau virtuelle parente dans la commande.

  2. Suivez la procédure pour appliquer de nouvelles configurations de VM dans un MIG.

    Si vous souhaitez mettre à jour les instances sans les redémarrer ni les recréer, définissez l'action minimale sur REFRESH. Pour en savoir plus, consultez les ressources suivantes :

API

  1. Pour créer un modèle d'instance qui ajoute une carte d'interface réseau dynamique, utilisez la méthode instanceTemplates.insert pour créer un modèle d'instance global ou la méthode regionInstanceTemplates.insert pour créer un modèle d'instance régional.

    Dans le champ networkInterfaces, spécifiez chaque interface réseau de votre modèle d'instance existant et ajoutez une interface réseau qui inclut le champ vlan pour créer une interface réseau dynamique.

    L'exemple suivant ajoute une carte d'interface réseau dynamique sous nic0. Vous pouvez spécifier des interfaces et des propriétés réseau supplémentaires si nécessaire. Pour obtenir d'autres exemples de création d'instances avec plusieurs interfaces réseau, consultez Créer des VM avec plusieurs interfaces réseau.

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

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet contenant le modèle d'instance.
    • REGION : région qui contient les instances.
    • SUBNET_A, SUBNET_B : sous-réseaux où se trouve chaque interface réseau.
    • VLAN_ID : ID de VLAN. Si vous spécifiez un ID de VLAN, l'interface réseau est configurée en tant qu'interface réseau dynamique. Vous devez placer une carte d'interface réseau dynamique après sa carte d'interface réseau virtuelle parente dans la requête.

  2. Suivez la procédure pour appliquer de nouvelles configurations de VM dans un MIG.

    Si vous souhaitez mettre à jour les instances sans les redémarrer ni les recréer, définissez l'action minimale sur REFRESH. Pour en savoir plus, consultez les ressources suivantes :

Configurer l'OS invité pour les cartes d'interface réseau dynamiques

Cette section explique comment effectuer la configuration supplémentaire de l'OS invité requise lorsque vous ajoutez des cartes d'interface réseau dynamiques à une instance nouvelle ou existante.

Choisissez l'une des options de configuration suivantes :

Option de configuration Description
Configurer la gestion automatique des cartes d'interface réseau dynamiques (recommandé)

Utilisez l'agent invité pour la gestion automatique des cartes d'interface réseau dynamiques.

L'environnement invité inclut l'agent invité, qui automatise l'installation et la gestion des interfaces VLAN dans l'espace de noms racine sur les distributions Linux des images d'OS Google Cloud .

Si vous configurez la gestion automatique des cartes d'interface réseau dynamiques, utilisez la version 20251115.00 ou ultérieure de l'agent invité. Bien que la prise en charge de cette fonctionnalité ait été introduite dans la version 20250204.02 de l'agent invité, un problème connu existe avec les versions 20250901.00 à 20251108.00 de l'agent invité, dans lesquelles les cartes d'interface réseau dynamiques ne sont pas installées ni gérées automatiquement.
Configurer manuellement l'OS invité

Exécutez des commandes dans l'OS invité pour installer les cartes d'interface réseau dynamiques.

Si vous utilisez cette option, votre configuration ne persiste pas automatiquement après le redémarrage de l'instance. Pour que les configurations persistent après un redémarrage, utilisez la méthode recommandée pour configurer des interfaces réseau persistantes pour votre distribution Linux. Par exemple, consultez NetworkConfiguration pour Debian et interfaces pour Ubuntu.

Configurer la gestion automatique des cartes d'interface réseau dynamiques

Cette section explique comment configurer la gestion automatique des cartes d'interface réseau dynamiques à l'aide de l'agent invité.

Vous n'avez besoin de suivre ces étapes qu'une seule fois par instance. Si vous avez ajouté une carte d'interface réseau dynamique à une instance pour laquelle vous avez déjà effectué ces étapes, vous n'avez pas besoin de les répéter.

Pour configurer la gestion automatique des cartes d'interface réseau dynamiques :

  1. Connectez-vous à l'instance à l'aide de SSH.

  2. Assurez-vous que l'instance exécute l'agent invité version 20251115.00 ou ultérieure :

    1. Pour déterminer si l'instance exécute l'agent invité, exécutez la commande appropriée listée dans Packages installés dans l'environnement invité.

      1. Si votre instance n'exécute pas l'agent invité, installez l'environnement invité.

      2. Si votre instance exécute l'agent invité, mettez à jour l'environnement invité.

      L'installation ou la mise à jour de l'environnement invité vous permet de disposer de la dernière version de l'agent invité. Pour confirmer la version, suivez les étapes de la section Valider l'environnement invité.

  3. Configurez l'agent invité pour gérer les cartes d'interface réseau dynamiques :

    1. Ouvrez ou créez le fichier de configuration de votre environnement invité.

      edit /etc/default/instance_configs.cfg

    2. Ajoutez les éléments suivants au fichier de configuration, puis enregistrez vos modifications et quittez l'éditeur.

      [NetworkInterfaces]
vlan_setup_enabled = true
manage_primary_nic = true

      Pour en savoir plus sur ces paramètres, consultez les articles suivants :

      • vlan_setup_enabled = true : configure l'agent invité pour qu'il installe et gère les cartes d'interface réseau dynamiques.
      • manage_primary_nic = true : paramètre supplémentaire requis pour que l'agent invité gère les cartes d'interface réseau dynamiques créées sous nic0

      Pour en savoir plus sur la modification du fichier de configuration de l'agent invité, consultez la section Configuration de la documentation de l'agent invité.

    3. Redémarrez l'agent invité en exécutant la commande suivante. Vous pouvez également redémarrer l'instance.

      sudo systemctl restart google-guest-agent.service

  4. Listez les interfaces réseau de votre instance pour vérifier que l'agent invité a installé vos NIC dynamiques.

    Par exemple, la commande suivante affiche un nom tel que a-gcp.ens4.11 pour une carte d'interface réseau dynamique avec un ID de VLAN de 11 créé en tant qu'enfant de l'interface ens4.

    sudo ip -d addr

Configurer manuellement l'OS invité

Pour configurer manuellement les cartes d'interface réseau dynamiques dans l'OS invité d'une instance :

  1. Connectez-vous à l'instance à l'aide de SSH.

  2. Si l'instance exécute l'agent invité, désactivez la gestion automatique des cartes d'interface réseau dynamiques. Vous pouvez déterminer si l'instance exécute l'agent invité à l'aide de la commande appropriée listée dans Packages installés dans l'environnement invité.

    Pour désactiver la gestion automatique des cartes d'interface réseau dynamiques :

    1. Ouvrez ou créez le fichier de configuration de votre environnement invité.

        edit /etc/default/instance_configs.cfg

    2. Ajoutez les éléments suivants au fichier de configuration, puis enregistrez vos modifications et quittez l'éditeur.

      [NetworkInterfaces]
vlan_setup_enabled = false
manage_primary_nic = false

      Pour en savoir plus sur la modification du fichier de configuration de l'agent invité, consultez la section Configuration de la documentation de l'agent invité.

    3. Redémarrez l'agent invité en exécutant la commande suivante. Vous pouvez également redémarrer l'instance.

      sudo systemctl restart google-guest-agent.service

  3. Pour chaque carte d'interface réseau dynamique que vous avez créée, procédez comme suit :

    1. Obtenez l'adresse MAC de la carte d'interface réseau dynamique. Pour trouver l'adresse MAC, interrogez le serveur de métadonnées en exécutant la commande suivante :

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

      Remplacez VNIC_NUMBER/VLAN_ID par le numéro de la carte d'interface réseau virtuelle parente et l'ID de VLAN de l'interface réseau dynamique. Par exemple, 0/2 pour nic0.2 ou 1/4 pour nic1.4.

    2. Configurez une sous-interface dans l'OS invité de l'instance. Par exemple, sur une VM Debian, exécutez les commandes suivantes :

      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

      Remplacez les éléments suivants :

      • VNIC_NAME : nom de la vNIC parente attribué par le système d'exploitation, tel que eth1 ou ens4
      • IP_ADDRESS : adresse IP de la carte d'interface réseau dynamique que vous avez créée
      • VLAN_ID : ID de VLAN que vous avez attribué à la carte d'interface réseau dynamique.
      • MAC_ADDRESS : adresse MAC que vous avez obtenue à l'étape précédente

Étapes suivantes