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 für mit Distributed Cloud verbundene Racks verfügbar. Verbundene Server von Distributed Cloud 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 zugehörigen 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 Network Admin“ (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 aussagekräftiger 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 Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.
  • ASN: Die ASN (Autonomous System Number) für diesen Router. Sie können einen Zwei-Byte- oder einen Vier-Byte-Wert angeben. Unterstützt öffentliche und private ASN-Werte.

API

Stellen 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 Zielprojekts Google Cloud .
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.
  • ROUTER_ID: Eine ID, die diesen Router eindeutig identifiziert.
  • LABELS: Eine Liste der Labels, die auf diese Routerressource angewendet werden sollen.
  • NETWORK_NAME: Der Name des Netzwerks, das von diesem Router bedient wird.
  • ASN: Die ASN (Autonomous System Number) für diesen Router. Sie können einen Zwei-Byte- oder einen Vier-Byte-Wert 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 dem Router eine Schnittstelle für die Distributed Cloud-Netzwerkkomponente hinzugefügt wird, 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-Attachment einzurichten. Das Ziel-Interconnect-Attachment muss dem Zielrouter zugeordnet sein.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Admin“ (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 aussagekräftiger Name für diese Schnittstelle.
  • ATTACHMENT_NAME: der Name des Ziel-Interconnect-Anhangs im Zielrouter.
  • INTERCONNECT_ADDRESS: die IPv4-Adresse der Interconnect-Verbindung, auf der die Ziel-Interconnect-Verbindung 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 Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

Southbound-Peering-Sitzung einrichten

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

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Admin“ (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 aussagekräftiger Name für diese Schnittstelle.
  • SUBNETWORK_NAME: der Name des Zielsubnetzes.
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

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 Network Admin“ (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 aussagekräftiger Name für diese Schnittstelle.
  • LOOPBACK_ADDRESSES: Die eingehenden und ausgehenden IPv4-Adressen für die Loopback-Schnittstelle, durch Kommas getrennt.
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

BGP-Peering-Sitzung beenden

Wenn Sie eine BGP-Peering-Sitzung zwischen einem Router und einem Interconnect-Attachment, 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 Network Admin“ (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 aussagekräftiger Name für diese Schnittstelle.
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

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 Subnetz oder einem Netzwerk eingerichtet ist. Wenn Sie einer BGP-Peering-Sitzung einen Peer hinzufügen, wird Bidirectional Forwarding Detection (BFD) automatisch auf dem Zielrouter mit einem Intervall von 100 ms, einem Mindestempfangsfenster von 100 ms und einem Multiplikator von 3 aktiviert.

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

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 Network Admin“ (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 aussagekräftiger Name für diesen Peer.
  • PEER_ASN: die Nummer des autonomen Systems (Autonomous System Number, ASN) für diesen Peer. Sie können einen Zwei-Byte- oder einen Vier-Byte-Wert 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 Subnetz wie die IP-Adresse oder der Adressbereich für den zugehörigen Interconnect-Anhang, das Subnetz oder das Netzwerk befinden.
  • INTERFACE_NAME: der Name der Schnittstelle, die der Ziel-BGP-Sitzung entspricht.
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

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 Network Admin“ (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 Ziel-Peers.
  • REGION: die Google Cloud Region, zu der die Distributed Cloud Connected-Zielzone gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

Router auflisten

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

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Viewer“ (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 Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

API

Stellen 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 Zielprojekts Google Cloud .
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.
  • 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. Wenn Sie eine absteigende Sortierreihenfolge verwenden möchten, stellen Sie dem gewünschten Feld ~ voran.
  • PAGE_TOKEN: Ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken in der Antwort empfangen wurde. Senden Sie dieses Token, um eine Seite mit Ergebnissen zu erhalten.

Informationen zu einem Router abrufen

Wenn Sie Informationen zu einem Distributed Cloud-Router abrufen möchten, führen Sie die Schritte in diesem Abschnitt aus.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Network Viewer“ (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 Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

API

Stellen 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 Zielprojekts Google Cloud .
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.
  • 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 verfügbar ist.
  • RUNNING: Die Ressource wurde erfolgreich bereitgestellt und in der gesamten Zone propagiert. 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 Network Viewer“ (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 Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

API

Stellen 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 Zielprojekts Google Cloud .
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.
  • 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 Network Admin“ (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 Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.

API

Stellen 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 Zielprojekts Google Cloud .
  • REGION: Die Google Cloud Region, zu der die Zielzone für Distributed Cloud Connected gehört.
  • ZONE_NAME: Der Name der Zielzone, die mit Distributed Cloud verbunden ist.
  • ROUTER_ID: die ID des Zielrouters.

Nächste Schritte