Dynamische NICs zu einer Instanz hinzufügen

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

Hinweise

Führen Sie vor dem Hinzufügen dynamischer NICs zu einer Instanz die folgenden Schritte aus:

• Machen Sie sich mit den Eigenschaften und Einschränkungen von dynamischen NICs vertraut, wie in der Übersicht zu mehreren Netzwerkschnittstellen beschrieben.
• Wenn Sie die vorhandenen Netzwerkschnittstellen Ihrer Instanz ansehen möchten, folgen Sie der Anleitung unter Netzwerkschnittstellen für eine Instanz ansehen.

Dynamisches 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 Konfiguration des Gastbetriebssystems vornehmen, 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-Gastagenten 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 der Google-Gast-Agent nicht ausgeführt wird, installieren Sie die Gastumgebung.

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

      Wenn Sie die Gastumgebung installieren oder aktualisieren, haben Sie die neueste Version des Google-Gast-Agents. Sie können die Version bestätigen, indem Sie die Schritte unter Gastumgebung prüfen ausführen.

3. Konfigurieren Sie den Google-Gast-Agenten für die 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 den folgenden Abschnitt 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-Gastagenten zum Installieren und Verwalten dynamischer NICs
      • manage_primary_nic = true: Eine zusätzliche Einstellung, die erforderlich ist, damit der Google-Gastagent 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 unter Konfiguration.

   3. Starten Sie den Gast-Agenten neu, indem Sie den folgenden Befehl ausführen. Alternativ können Sie die Instanz neu starten.

      sudo systemctl restart google-guest-agent.service
      

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

   Im 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-Gastagent ausgeführt wird, deaktivieren Sie die automatische Verwaltung dynamischer NICs. Sie können mit dem entsprechenden Befehl unter Installierte Pakete für die Gastumgebung 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 den folgenden Abschnitt 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 unter Konfiguration.

   3. Starten Sie den Gast-Agenten neu, indem Sie den folgenden Befehl ausführen. Alternativ können Sie die Instanz neu starten.

      sudo systemctl restart google-guest-agent.service
      

3. Führen Sie für jede von Ihnen erstellte dynamische NIC die folgenden Schritte aus:

   1. Rufen Sie die MAC-Adresse der übergeordneten vNIC ab. Führen Sie den folgenden Befehl aus, um die MAC-Adresse zu ermitteln:

      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 eine Unterschnittstelle 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, der vom Betriebssystem zugewiesen wird, z. B. eth1 oder ens4.
      • IP_ADDRESS: die IP-Adresse der von Ihnen erstellten dynamischen NIC
      • VLAN_ID: die VLAN-ID, die Sie der dynamischen NIC zugewiesen haben
      • MAC_ADDRESS: die MAC-Adresse, die Sie im vorherigen Schritt erhalten haben