Benutzerdefinierte IP-Bereiche bewerben

Sie können vorhandene Cloud Router oder BGP-Sitzungen auf einem Cloud Router aktualisieren, um andere IP-Bereiche als die Subnetz-IP-Adressbereiche Ihres VPC-Netzwerks (Virtual Private Cloud) zu bewerben. Beispielsweise können Sie externe IP-Adressen, beliebige interne IP-Adressen oder interne IP-Adressen aus IP-Adressbereichen von Subnetzen in Peer-VPC-Netzwerken bewerben, die über VPC Network Peering verbunden sind.

Informationen zum Festlegen von Advertisements beim Erstellen eines Cloud Routers oder beim Konfigurieren einer BGP-Sitzung finden Sie unter Cloud Router erstellen oder BGP-Sitzungen erstellen.

Advertisements auf einem Cloud Router angeben

So geben Sie Advertisements auf einem vorhandenen Cloud Router an:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Routers.

    Zu Cloud Routers

  2. Wählen Sie den zu aktualisierenden Cloud Router aus.

  3. Klicken Sie auf der Seite Routerdetails auf Bearbeiten.

  4. Wählen Sie im Bereich Beworbene Routen für Routen die Option Benutzerdefinierte Routen erstellen aus.

  5. Wählen Sie das Kästchen Alle für den Cloud Router sichtbaren Subnetze bewerben aus. Damit können Sie weiterhin die Subnetze bewerben, die für den Cloud Router zur Verfügung stehen. Wenn Sie diese Option aktivieren, entspricht dies dem Standardverhalten des Cloud Routers.

  6. Wählen Sie Benutzerdefinierte Route hinzufügen aus, um eine beworbene Route zu erstellen.

  7. Konfigurieren Sie das Route Advertisement:

    • Quelle: Wählen Sie Benutzerdefinierter IP-Bereich aus.
    • IP-Adressbereich: Verwenden Sie die CIDR-Schreibweise, um den benutzerdefinierten IP-Bereich anzugeben.
    • Beschreibung: Fügen Sie eine Beschreibung hinzu, damit Sie den Zweck dieses Route Advertisements erkennen können, und klicken Sie dann auf Fertig.
  8. Nachdem Sie die benutzerdefinierten Routen hinzugefügt haben, klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl update aus: Verwenden Sie das Flag --set-advertisement-ranges oder --add-advertisement-ranges, um die benutzerdefinierten IP-Bereiche anzugeben.

  1. Verwenden Sie das Flag --set-advertisement-ranges, um alle vorhandenen benutzerdefinierten Advertisements zu ersetzen:

    gcloud compute routers update ROUTER_NAME \
       --project=PROJECT_ID \
       --advertisement-mode custom \
       --set-advertisement-groups=ADVERTISED_GROUPS \
       --set-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ersetzen Sie Folgendes:

    • ROUTER_NAME: Der Name des Cloud Routers
    • PROJECT_ID: Das Projekt, das den Cloud Router enthält
    • ADVERTISED_GROUPS: Eine von Google definierte Gruppe, die Cloud Router dynamisch bewirbt

      Der einzige gültige Wert ist all_subnets, der Subnetze basierend auf dem dynamischen Routingmodus des VPC-Netzwerks bewirbt (ähnlich dem Standard-Advertising).

    • ADVERTISED_IP_RANGES: Der Inhalt des neuen Arrays der IP-Adressbereiche

    Im folgenden Beispiel wird der Cloud Router my-router so aktualisiert, dass er alle Subnetze und die benutzerdefinierten IP-Bereiche 1.2.3.4 und 6.7.0.0/16 bewirbt:

    gcloud compute routers update my-router \
       --advertisement-mode custom \
       --set-advertisement-groups all_subnets \
       --set-advertisement-ranges 1.2.3.4,6.7.0.0/16
    

    Das Flag --set-advertisement-groups akzeptiert von Google definierte Gruppen, die der Cloud Router dynamisch bewirbt. Sie können das Flag --set-advertisement-groups entfernen, um Subnetz-Advertising auszuschließen. Eine Liste aller Advertising-Gruppen finden Sie in der Google SDK-Dokumentation unter dem Flag set-advertisement-groups.

  2. Verwenden Sie das Flag --add-advertisement-ranges, bei dem der Advertising-Modus des Cloud Routers bereits auf custom eingestellt sein muss:

    gcloud compute routers update ROUTER_NAME \
       --add-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ersetzen Sie Folgendes:

    • ROUTER_NAME: Der Name des Cloud Routers
    • ADVERTISED_IP_RANGES: Der Inhalt des neuen Arrays der IP-Adressbereiche

    Im folgenden Beispiel wird die benutzerdefinierte IP-Adresse 1.2.3.5 den Advertisements des Cloud Routers hinzugefügt:

    gcloud compute routers update my-router \
       --add-advertisement-ranges 1.2.3.5
    

API

Verwenden Sie die Methode routers.patch, um die Felder bgp.advertisedGroups[] und bgp.advertisedIpRanges[] zu aktualisieren.

Die Felder bgp.advertisedGroups[] und bgp.advertisedIpRanges[] speichern Arrays von beworbenen Gruppen und IP-Adressbereichen. Wenn Sie ein PATCH auf diese Felder anwenden, überschreiben Sie die vorhandenen Arrays mit den neuen Arrays in Ihrer Anfrage.

  1. Senden Sie eine GET-Anfrage, um die aktuellen Arrays der beworbenen Gruppen und IP-Adressbereiche auf dem Router abzurufen. Weitere Informationen finden Sie unter BGP-Sitzungskonfiguration aufrufen.

  2. Senden Sie eine PATCH-Anfrage mit neuen Arrays beworbener Gruppen und beworbener IP-Adressbereiche. Verwenden Sie die Arrays aus der GET-Anfrage im vorherigen Schritt und fügen Sie alle Gruppen oder IP-Adressbereiche hinzu, die Sie auf dem Router haben möchten.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgp": {
        "advertisedGroups": [
        "ADVERTISED_GROUPS"
       ],
        "advertisedIpRanges": [
        ADVERTISED_IP_RANGES
       ]
     }
    }
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Das Projekt, das den Cloud Router enthält
    • REGION: Die Region, in der sich der Cloud Router befindet
    • ROUTER_NAME: Der Name des Cloud Routers
    • ADVERTISED_GROUPS: Eine von Google definierte Gruppe, die Cloud Router dynamisch bewirbt

      Der einzige gültige Wert ist ALL_SUBNETS, der Subnetze basierend auf dem dynamischen Routingmodus des VPC-Netzwerks bewirbt (ähnlich dem Standard-Advertising).

    • ADVERTISED_IP_RANGES: Der Inhalt des neuen Arrays der IP-Adressbereiche

    Das folgende Beispiel enthält zwei IP-Adressbereiche:

        {
          "range": "1.2.3.4",
          "description": "First example range"
        },
        {
          "range": "6.7.0.0/16",
          "description": "Second example range"
        }
    

Advertisements in einer BGP-Sitzung angeben

So geben Sie Advertisements für eine vorhandene BGP-Sitzung an:

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud Routers.

    Zu Cloud Routers

  2. Klicken Sie auf den Cloud Router, der die zu aktualisierende BGP-Sitzung enthält.

  3. Wählen Sie auf der Seite Routerdetails die zu aktualisierende BGP-Sitzung aus.

  4. Klicken Sie auf der Seite BGP-Sitzungsdetails auf Bearbeiten.

  5. Wählen Sie unter Routen die Option Benutzerdefinierte Routen erstellen aus.

  6. Wählen Sie das Kästchen Alle für den Cloud Router sichtbaren Subnetze bewerben aus. Damit können Sie weiterhin die Subnetze bewerben, die für den Cloud Router zur Verfügung stehen. Wenn Sie diese Option aktivieren, entspricht dies dem Standardverhalten des Cloud Routers.

  7. Wählen Sie Benutzerdefinierte Route hinzufügen aus, um eine beworbene Route zu erstellen.

  8. Konfigurieren Sie das Route Advertisement:

    • Quelle: Wählen Sie Benutzerdefinierter IP-Bereich aus.
    • IP-Adressbereich: Verwenden Sie die CIDR-Schreibweise, um den benutzerdefinierten IP-Bereich anzugeben.
    • Beschreibung: Fügen Sie eine Beschreibung hinzu, damit Sie den Zweck dieses Route Advertisements erkennen können, und klicken Sie dann auf Fertig.
  9. Nachdem Sie die benutzerdefinierten Routen hinzugefügt haben, klicken Sie auf Speichern.

gcloud

Führen Sie den Befehl update-bgp-peer aus: Verwenden Sie das Flag --set-advertisement-ranges oder --add-advertisement-ranges, um die benutzerdefinierten IP-Bereiche anzugeben.

  1. Verwenden Sie das Flag --set-advertisement-ranges, um alle vorhandenen benutzerdefinierten Advertisements zu ersetzen:

    gcloud compute routers update-bgp-peer ROUTER_NAME \
        --peer-name=PEER_NAME \
        --advertisement-mode custom \
        --set-advertisement-groups=ADVERTISED_GROUPS \
        --set-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ersetzen Sie Folgendes:

    • ROUTER_NAME: Der Name des Cloud Routers
    • PEER_NAME: Der Name Ihres BGP-Peers
    • ADVERTISED_GROUPS: Eine von Google definierte Gruppe, die Cloud Router dynamisch bewirbt

      Der einzige gültige Wert ist all_subnets, der Subnetze basierend auf dem dynamischen Routingmodus des VPC-Netzwerks bewirbt (ähnlich dem Standard-Advertising).

    • ADVERTISED_IP_RANGES: Der Inhalt des neuen Arrays der IP-Adressbereiche

    Im folgenden Beispiel wird die BGP-Sitzung my-bgp-session auf dem Cloud Router my-router aktualisiert, um alle Subnetze sowie die benutzerdefinierten IP-Bereiche 1.2.3.4 und 6.7.0.0/16 zu bewerben:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --advertisement-mode custom \
        --set-advertisement-groups all_subnets \
        --set-advertisement-ranges 1.2.3.4,6.7.0.0/16
    

    Das Flag --set-advertisement-groups akzeptiert von Google definierte Gruppen, die von der BGP-Sitzung dynamisch beworben werden. Sie können das Flag --add-advertisement-groups entfernen, um Subnetz-Advertising auszuschließen. Eine Liste aller Advertising-Gruppen finden Sie in der Google SDK-Dokumentation unter dem Flag set-advertisement-groups.

  2. Verwenden Sie das Flag --add-advertisement-ranges, bei dem der Advertising-Modus des Cloud Routers bereits auf custom eingestellt sein muss:

    gcloud compute routers update-bgp-peer ROUTER_NAME \
        --peer-name=PEER_NAME \
        --add-advertisement-ranges=ADVERTISED_IP_RANGES
    

    Ersetzen Sie Folgendes:

    • ROUTER_NAME: Der Name des Cloud Routers
    • PEER_NAME: Der Name Ihres BGP-Peers
    • ADVERTISED_IP_RANGES: Der Inhalt des neuen Arrays der IP-Adressbereiche

    Im folgenden Beispiel wird die benutzerdefinierte IP-Adresse 1.2.3.5 den Advertisements des Cloud Routers hinzugefügt:

    gcloud compute routers update-bgp-peer my-router \
        --peer-name my-bgp-session \
        --add-advertisement-ranges 1.2.3.5
    

API

Verwenden Sie die Methode routers.patch, um das Feld bgpPeers[] zu aktualisieren.

Im Feld bgpPeers[] wird ein Array von BGP-Peers akzeptiert. Wenn Sie PATCH auf dieses Feld anwenden, überschreiben Sie das vorhandene Array von BGP-Peers mit dem neuen Array, das in der Anfrage enthalten ist.

  1. Senden Sie eine GET-Anfrage, um das aktuelle Array von BGP-Peers für den Router abzurufen. Weitere Informationen finden Sie unter BGP-Sitzungskonfiguration aufrufen.

  2. Senden Sie eine PATCH-Anfrage mit einem neuen Array von BGP-Peers. Gehen Sie für jeden BGP-Peer, dem Sie Advertisements hinzufügen möchten, so vor:

    • Fügen Sie im Feld bgpPeers[].advertisedIpRanges[] Anzeigen für einen beliebigen IP-Adressbereich hinzu.
    • Fügen Sie im Feld bgpPeers[].advertisedGroups[] alle gewünschten Gruppen-Advertisements hinzu. Gültige Werte sind ALL_SUBNETS und ALL_VPC_SUBNETS. Weitere Informationen zu diesen Werten finden Sie in der API-Dokumentation unter routers.patch.
    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
    {
      "bgpPeers": [
        BGP_PEERS
      ]
    }
    

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Das Projekt, das den Cloud Router enthält
    • REGION: Die Region, in der sich der Cloud Router befindet
    • ROUTER_NAME: Der Name des Cloud Routers
    • BGP_PEERS: Der Inhalt des neuen Arrays von BGP-Peers

    Das folgende Beispiel enthält zwei BGP-Peers mit benutzerdefinierten Advertisements:

        {
          "name": "peer-1",
          "interfaceName": "if-peer-1",
          "ipAddress": "169.254.10.1",
          "peerIpAddress": "169.254.10.2",
          "peerAsn": 64512,
          "advertisedRoutePriority": 100,
          "advertiseMode": "CUSTOM",
          "advertisedGroups": ["ALL_SUBNETS"],
          "advertisedIpRanges": [
            {
              "range": "1.2.3.4",
              "description": "First example range"
            },
            {
              "range": "6.7.0.0/16",
              "description": "Second example range"
            }
          ]
        },
        {
          "name": "peer-2",
          "interfaceName": "if-peer-2",
          "ipAddress": "169.254.20.1",
          "peerIpAddress": "169.254.20.2",
          "peerAsn": 64513,
          "advertisedRoutePriority": 100,
          "advertiseMode": "CUSTOM",
          "advertisedIpRanges": [
            {
              "range": "192.168.10.0/24",
              "description": "Third example range"
            }
          ]
        }
    

Nächste Schritte

  • Informationen zur Konfiguration eines Cloud Routers, seiner BGP-Sitzungen und der Routen, die Cloud Router bewirbt, finden Sie unter Cloud Router-Details aufrufen.

  • Weitere Informationen zu Problemen mit benutzerdefiniertem Route Advertisement finden Sie unter Fehlerbehebung.