Router erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Google Distributed Cloud Connected-Routerressourcen in einer Distributed Cloud-Zone erstellen und verwalten.

Diese Funktion ist nur auf Distributed Cloud Connected-Racks verfügbar. Distributed Cloud Connected-Server unterstützen keine Routerressourcen.

Weitere Informationen zu Distributed Cloud-Routern finden Sie unter Funktionsweise von Distributed Cloud Connected.

Beachten Sie Folgendes:

  • Sie können einen Router pro Distributed Cloud-Netzwerk erstellen.

  • Wir empfehlen, einen Router und den entsprechenden Interconnect-Anhang gleichzeitig zu erstellen. Weitere Informationen zum Erstellen eines Interconnect-Anhangs finden Sie unter Interconnect-Anhang erstellen.

Router erstellen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Router zu erstellen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers create aus:

gcloud edge-cloud networking routers create ROUTER_NAME \
    --network=NETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME \
    --asn=ASN

Ersetzen Sie Folgendes:

  • ROUTER_NAME: ein beschreibender Name, der diesen Router eindeutig identifiziert.
  • NETWORK_NAME: der Name des Netzwerks, das von diesem Router bedient wird.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • ASN: die Nummer des autonomen Systems (Autonomous System Number, ASN) für diesen Router. Sie können einen Wert mit zwei oder vier Byte angeben. Unterstützt öffentliche und private ASN-Werte.

API

Senden Sie eine POST-Anfrage an die Methode projects.locations.zones.routers.create:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?routerId=ROUTER_ID
{
 "labels": { LABELS,
  },
 "network": { NETWORK_NAME,
  },
 "asn": { ASN,
  },      
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • ROUTER_ID: eine ID, die diesen Router eindeutig identifiziert.
  • LABELS: eine Liste von Labels, die auf diese Routerressource angewendet werden sollen.
  • NETWORK_NAME: der Name des Netzwerks, das von diesem Router bedient wird.
  • ASN: die Nummer des autonomen Systems (Autonomous System Number, ASN) für diesen Router. Sie können einen Wert mit zwei oder vier Byte angeben. Unterstützt öffentliche und private ASN-Werte.

BGP-Peering-Sitzung auf einem Router einrichten

Mit einem Router können Sie die folgenden Arten von BGP-Peering-Sitzungen (Border Gateway Protocol) einrichten:

Eine BGP-Peering-Sitzung wird eingerichtet, indem Sie dem Router eine Schnittstelle für die Distributed Cloud-Netzwerkkomponente hinzufügen, die dem Typ der Peering-Sitzung entspricht.

Northbound-Peering-Sitzung einrichten

Führen Sie die Schritte in diesem Abschnitt aus, um eine Northbound-Peering-Sitzung auf einem Router mit einem Interconnect-Anhang einzurichten. Der Interconnect-Zielanhang muss mit dem Zielrouter verknüpft sein.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers add-interface aus:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --interconnect-attachment=ATTACHMENT_NAME \
    --ip-address=INTERCONNECT_ADDRESS \
    --ip-mask-length=IP_MASK_LENGTH \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • INTERFACE_NAME: ein beschreibender Name für diese Schnittstelle.
  • ATTACHMENT_NAME: der Name des Interconnect-Zielanhangs im Zielrouter.
  • INTERCONNECT_ADDRESS: die IPv4-Adresse des Interconnect, auf dem der Interconnect-Zielanhang konfiguriert ist.
  • IP_MASK_LENGTH: die Länge der Maske für die angegebene Interconnect-IP-Adresse.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

Southbound-Peering-Sitzung einrichten

Führen Sie die Schritte in diesem Abschnitt aus, um eine Southbound-Peering-Sitzung auf einem Router mit einem Subnetzwerk einzurichten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers add-interface aus:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --subnet=SUBNETWORK_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • INTERFACE_NAME: ein beschreibender Name für diese Schnittstelle.
  • SUBNETWORK_NAME: der Name des Zielsubnetzwerks.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

Loopback-Peering-Sitzung einrichten

Führen Sie die Schritte in diesem Abschnitt aus, um eine Loopback-Peering-Sitzung auf einem Router mit einem Netzwerk einzurichten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers add-interface aus:

gcloud edge-cloud networking routers add-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --loopback-ip-addresses=LOOPBACK_ADDRESSES \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • INTERFACE_NAME: ein beschreibender Name für diese Schnittstelle.
  • LOOPBACK_ADDRESSES: die kommagetrennten eingehenden und ausgehenden IPv4-Adressen für die Loopback-Schnittstelle.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

BGP-Peering-Sitzung beenden

Wenn Sie eine BGP-Peering-Sitzung zwischen einem Router und einem Interconnect-Anhang, einem Subnetzwerk oder einem Netzwerk beenden möchten, müssen Sie die Schnittstelle für diese Netzwerkkomponente aus dem Zielrouter löschen. Führen Sie die Schritte in diesem Abschnitt aus, um die Schnittstelle zu löschen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers remove-interface aus:

gcloud edge-cloud networking routers remove-interface ROUTER_NAME \
    --interface-name=INTERFACE_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • INTERFACE_NAME: ein beschreibender Name für diese Schnittstelle.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

Peers in einer BGP-Peering-Sitzung konfigurieren

Sie können BGP-Peers in einer BGP-Peering-Sitzung hinzufügen und entfernen, die zwischen einem Router und einem Interconnect-Anhang, einem Subnetzwerk oder einem Netzwerk eingerichtet wurde. Wenn Sie einer BGP-Peering-Sitzung einen Peer hinzufügen, wird die bidirektionale Weiterleitungserkennung (Bidirectional Forwarding Detection, BFD) automatisch auf dem Zielrouter mit einem Intervall von 100 ms, einem minimalen Empfangsfenster von 100 ms und einem Multiplikator von 3 aktiviert.

Nachdem Sie der BGP-Peering-Zielsitzung einen Peer hinzugefügt haben, können Sie die Peer-IP-Adresse dem Pod zuweisen, auf dem Ihre Arbeitslast ausgeführt wird. Informationen zum Ermitteln der Peer-IP Adresse finden Sie unter Informationen zu einem Router abrufen.

Einer BGP-Peering-Sitzung einen Peer hinzufügen

Führen Sie die Schritte in diesem Abschnitt aus, um einer BGP-Peering-Sitzung einen Peer hinzuzufügen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers add-bgp-peer aus:

gcloud edge-cloud networking routers add-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --peer-asn=PEER_ASN \
    --peer-ipv4-range=PEER_IP_RANGE \
    --interface=INTERFACE_NAME \                                                       \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • PEER_NAME: ein beschreibender Name für diesen Peer.
  • PEER_ASN: die Nummer des autonomen Systems (Autonomous System Number, ASN) für diesen Peer. Sie können einen Wert mit zwei oder vier Byte angeben. Unterstützt öffentliche und private ASN-Werte.
  • PEER_IP_RANGE: der IPv4-CIDR-Bereich für diesen Peer. Dieser Adressbereich muss sich im selben Subnetzwerk wie die IP-Adresse oder der Adressbereich für den zugehörigen Interconnect-Anhang, das Subnetzwerk oder das Netzwerk befinden.
  • INTERFACE_NAME: der Name der Schnittstelle, die der BGP-Zielsitzung entspricht.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

Peer aus einer BGP-Peering-Sitzung entfernen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Peer aus einer BGP-Peering-Sitzung zu entfernen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers remove-bgp-peer aus:

gcloud edge-cloud networking routers remove-bgp-peer ROUTER_NAME \
    --peer-name=PEER_NAME> \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • PEER_NAME: der Name des Zielpeers.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

Router auflisten

Führen Sie die Schritte in diesem Abschnitt aus, um die in einer Distributed Cloud Connected-Zone bereitgestellten Router aufzulisten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkbetrachter“ (roles/edgenetwork.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers list aus:

gcloud edge-cloud networking routers list \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.zones.routers.list:

 GET /v1/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • FILTER: ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.
  • PAGE_SIZE: die Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.
  • SORT_BY: eine durch Kommas getrennte Liste von Feldnamen, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Für eine absteigende Sortierreihenfolge stellen Sie dem gewünschten Feld ~ voran.
  • PAGE_TOKEN: ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken enthalten ist. Senden Sie dieses Token, um eine Seite mit Ergebnissen zu erhalten.

Informationen zu einem Router abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um Informationen zu einem Distributed Cloud-Router abzurufen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkbetrachter“ (roles/edgenetwork.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers describe aus:

gcloud edge-cloud networking routers describe ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.zones.routers.get:

GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • ROUTER_ID: die ID des Zielrouters.

Dieser Vorgang gibt detaillierte Informationen zur Ressource zurück, einschließlich des Bereitstellungsstatus:

  • PENDING: Die Bereitstellung der Ressource hat noch nicht begonnen und sie wurde noch nicht in der gesamten Zone weitergegeben.
  • PROVISIONING: Die Ressource wird bereitgestellt. Sie müssen warten, bis sie in der gesamten Zone weitergegeben wurde.
  • RUNNING: Die Ressource wurde erfolgreich bereitgestellt und in der gesamten Zone weitergegeben. Sie kann verwendet werden.
  • FAILED: Die Bereitstellung der Ressource war nicht erfolgreich. Die Ressource wurde nicht in der gesamten Zone weitergegeben.

Betriebsstatus eines Routers prüfen

Führen Sie die Schritte in diesem Abschnitt aus, um den Betriebsstatus eines Distributed Cloud-Routers zu prüfen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkbetrachter“ (roles/edgenetwork.viewer) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers get-status aus:

gcloud edge-cloud networking routers get-status ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine GET-Anfrage an die Methode projects.locations.zones.routers.diagnose:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID:diagnose

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • ROUTER_ID: die ID des Zielrouters.

Router löschen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Router zu löschen.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge-Netzwerkadministrator“ (roles/edgenetwork.admin) in Ihrem Google Cloud Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud networking routers delete aus:

gcloud edge-cloud networking routers delete ROUTER_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Ersetzen Sie Folgendes:

  • ROUTER_NAME: der Name des Zielrouters.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.

API

Senden Sie eine DELETE-Anfrage an die Methode projects.locations.zones.routers.delete:

 DELETE /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/routers/ROUTER_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Ziel Google Cloud projekts.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: der Name der Distributed Cloud Connected-Zielzone.
  • ROUTER_ID: die ID des Zielrouters.

Nächste Schritte