Dynamische NICs zu einer Instanz hinzufügen

Informationen zum Erstellen neuer Instanzen finden Sie unter VMs mit mehreren Netzwerkschnittstellen erstellen.

Hinweise

Bevor Sie einer Instanz dynamische NICs hinzufügen, müssen Sie Folgendes tun:

• Machen Sie sich mit den Eigenschaften und Einschränkungen von dynamischen NICs vertraut, die in der Übersicht zu mehreren Netzwerkschnittstellen beschrieben werden.
• Sehen Sie sich bei Bedarf die vorhandenen Netzwerkschnittstellen Ihrer Instanz an. Folgen Sie dazu der Anleitung unter Netzwerkschnittstellen für eine Instanz ansehen.

Dynamic NIC hinzufügen

In diesem Abschnitt wird beschrieben, wie Sie einer Instanz eine dynamische NIC hinzufügen.

Wenn Sie eine dynamische NIC hinzufügen, kann es zu einer Übertragungsverzögerung kommen. Diese Verzögerung dauert in der Regel nur wenige Sekunden, kann jedoch in seltenen Fällen auch bis zu einer Minute betragen.

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

Gastbetriebssystem für dynamische NICs konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie die zusätzliche Gastbetriebssystemkonfiguration abschließen, die erforderlich ist, wenn Sie einer neuen oder vorhandenen Instanz dynamische NICs hinzufügen.

Wählen Sie eine der folgenden Konfigurationsoptionen aus:

Automatische Verwaltung dynamischer NICs konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie die automatische Verwaltung dynamischer NICs mit dem Google-Gast-Agent konfigurieren.

Sie müssen diese Schritte nur einmal pro Instanz ausführen. Wenn Sie einer Instanz, für die Sie diese Schritte bereits ausgeführt haben, eine dynamische NIC hinzugefügt haben, müssen Sie sie nicht wiederholen.

So konfigurieren Sie die automatische Verwaltung dynamischer NICs:

1. Stellen Sie eine SSH-Verbindung zur Instanz her.

2. Prüfen Sie, ob auf der Instanz der Google-Gast-Agent in Version 20250204.02 oder höher ausgeführt wird:

   1. Wenn Sie feststellen möchten, ob auf der Instanz der Google-Gast-Agent ausgeführt wird, führen Sie den entsprechenden Befehl aus, der unter Installierte Pakete für die Gastumgebung aufgeführt ist.

      1. Wenn auf Ihrer Instanz nicht der Google-Gast-Agent ausgeführt wird, installieren Sie die Gastumgebung.

      2. Wenn auf Ihrer Instanz der Google-Gast-Agent ausgeführt wird, aktualisieren Sie die Gastumgebung.

      Durch die Installation oder Aktualisierung der Gastumgebung wird sichergestellt, dass Sie die neueste Version des Google-Gast-Agents haben. Sie können die Version bestätigen, indem Sie die Schritte unter Gastumgebung validieren ausführen.

3. Konfigurieren Sie den Google-Gast-Agenten so, dass er dynamische NICs verwaltet:

   1. Öffnen oder erstellen Sie die Konfigurationsdatei für die Gastumgebung:

      edit /etc/default/instance_configs.cfg
      

   2. Fügen Sie der Konfigurationsdatei Folgendes hinzu, speichern Sie die Änderungen und beenden Sie den Editor.

      [NetworkInterfaces]
      vlan_setup_enabled = true
      manage_primary_nic = true
      

      Weitere Informationen zu diesen Einstellungen finden Sie unter den folgenden Links:

      • vlan_setup_enabled = true: Konfiguriert den Google-Gast-Agenten für die Installation und Verwaltung dynamischer NICs.
      • manage_primary_nic = true: Eine zusätzliche Einstellung, die erforderlich ist, damit der Google-Gast-Agent dynamische NICs verwalten kann, die unter nic0 erstellt wurden.

      Weitere Informationen zum Bearbeiten der Konfigurationsdatei des Gast-Agents finden Sie in der Dokumentation zum Google-Gast-Agent im Abschnitt Konfiguration.

   3. Starten Sie den Gast-Agent mit dem folgenden Befehl neu. Alternativ können Sie die Instanz neu starten.

      sudo systemctl restart google-guest-agent.service
      

4. Listen Sie die Netzwerkschnittstellen auf Ihrer Instanz auf, um zu sehen, dass der Google-Gast-Agent Ihre dynamischen NICs installiert hat.

   Mit dem folgenden Befehl wird beispielsweise ein Name wie a-gcp.ens4.11 für eine dynamische NIC mit der VLAN-ID 11 angezeigt, die als untergeordnetes Element der Schnittstelle ens4 erstellt wurde.

   sudo ip -d addr
   

Gastbetriebssystem manuell konfigurieren

So konfigurieren Sie dynamische NICs im Gastbetriebssystem einer Instanz manuell:

1. Stellen Sie eine SSH-Verbindung zur Instanz her.

2. Wenn auf der Instanz der Google-Gast-Agent ausgeführt wird, deaktivieren Sie die automatische Verwaltung dynamischer NICs. Sie können mit dem entsprechenden Befehl, der unter Installierte Pakete für die Gastumgebung aufgeführt ist, feststellen, ob auf der Instanz der Google-Gast-Agent ausgeführt wird.

   So deaktivieren Sie die automatische Verwaltung dynamischer NICs:

   1. Öffnen oder erstellen Sie die Konfigurationsdatei für die Gastumgebung:

        edit /etc/default/instance_configs.cfg
        

   2. Fügen Sie der Konfigurationsdatei Folgendes hinzu, speichern Sie die Änderungen und beenden Sie den Editor.

      [NetworkInterfaces]
      vlan_setup_enabled = false
      manage_primary_nic = false
      

      Weitere Informationen zum Bearbeiten der Konfigurationsdatei des Gast-Agents finden Sie in der Dokumentation zum Google-Gast-Agent im Abschnitt Konfiguration.

   3. Starten Sie den Gast-Agent mit dem folgenden Befehl neu. Alternativ können Sie die Instanz neu starten.

      sudo systemctl restart google-guest-agent.service
      

3. Führen Sie für jede dynamische NIC, die Sie erstellt haben, folgende Schritte aus:

   1. Rufen Sie die MAC-Adresse der übergeordneten vNIC ab. Rufen Sie die MAC-Adresse vom Metadatenserver ab, indem Sie den folgenden Befehl ausführen:

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

      Ersetzen Sie VNIC_NUMBER durch die Nummer der übergeordneten vNIC. Beispiel: 0 für nic0 oder 1 für nic1.

   2. Konfigurieren Sie ein untergeordnetes Interface im Gastbetriebssystem der Instanz. Führen Sie beispielsweise auf einer Debian-VM die folgenden Befehle aus:

      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
      

      Ersetzen Sie Folgendes:

      • VNIC_NAME: der Name der übergeordneten vNIC, die vom Betriebssystem zugewiesen wurde, z. B. eth1 oder ens4
      • IP_ADDRESS: die IP-Adresse der dynamischen NIC, die Sie erstellt haben
      • VLAN_ID: Die VLAN-ID, die Sie der dynamischen NIC zugewiesen haben
      • MAC_ADDRESS: die MAC-Adresse, die Sie im vorherigen Schritt erhalten haben