Routenverlängerung konfigurieren

Mit Service Extensions können unterstützte Application Load Balancer Plug-ins verwenden oder Callouts an Backend-Dienste senden, um benutzerdefinierte Verarbeitung in den Verarbeitungspfad einzufügen. Routerweiterungen werden im Anfrageverarbeitungspfad ausgeführt, wenn der Load-Balancer Anfrageheader empfängt und bevor er die URL-Zuordnung auswertet. Auf dieser Seite wird beschrieben, wie Sie Routenerweiterungen konfigurieren.

Eine Übersicht über Application Load Balancer-Erweiterungen finden Sie unter Übersicht über Cloud Load Balancing-Erweiterungen.

Eine Routenerweiterung für einen Application Load Balancer verweist auf die folgenden Ressourcen:

  • Eine Weiterleitungsregel, an die angehängt werden soll
  • Ein Plug-in oder ein Callout-Back-End-Dienst, dessen Back-Ends die ext_proc gRPC-API ausführen

Bei einer Routenerweiterung werden verwandte Erweiterungsdienste in einer Kette gruppiert. Sie können sowohl Plug-ins als auch Callouts in derselben Erweiterungskette konfigurieren. Die Erweiterungskette wählt den Traffic aus, auf den reagiert werden soll, indem sie Common Expression Language (CEL)-Abgleichsbedingungen verwendet. Der Load-Balancer wertet eine Anfrage sequenziell anhand der Abgleichsbedingungen für eine Kette aus. Wenn eine Anfrage die Bedingungen einer Kette erfüllt, wirken sich alle Erweiterungen in der Kette auf die Anfrage aus. Nur eine Kette entspricht einer bestimmten Anfrage.

Die Erweiterung verweist auf die Weiterleitungsregel des Load-Balancers, an die sie angehängt werden soll. Nachdem Sie die Ressource konfiguriert haben, beginnt der Load Balancer, passende Anfragen an Erweiterungsdienste zu senden.

Informationen zu den Limits für Application Load Balancer-Erweiterungen finden Sie auf der Seite Kontingente und Limits.

Mit Plug-ins konfigurieren

In diesem Abschnitt wird anhand eines Beispiels gezeigt, wie Sie eine Routenerweiterung mit einem Plug-in konfigurieren, das den :host-Anfrageheader in service-extensions.com umschreibt, wenn der Pfad mit /extensions übereinstimmt. Der frühere Host und der neu konfigurierte Host werden Backend-Diensten in verschiedenen Regionen zugeordnet, was das Routingverhalten veranschaulicht.

Alle Erweiterungsressourcen, die auf ein bestimmtes Plug-in verweisen, müssen vom selben Typ sein. Die Erweiterungen müssen auch dasselbe Load Balancing-Schema haben. Sie können Cloud Load Balancing-Erweiterungen nicht mit Plug-ins konfigurieren, die bereits in Media CDN-Erweiterungen verwendet werden.

Hinweise

  1. Erstellen Sie ein Plug‑in, das Ihren benutzerdefinierten Code enthält.

  2. Erstellen und konfigurieren Sie einen Application Load Balancer, der Routenerweiterungs-Plug-ins unterstützt.

    Folgen Sie der Anleitung auf der Seite Regionenübergreifenden internen Application Load Balancer mit Back-Ends von VM-Instanzgruppen einrichten für alle Schritte, mit Ausnahme der folgenden:

    • Geben Sie dem Backend-Dienst den Namen service-one.
    • Weisen Sie service-one einer VM-Instanz in der Region A zu.
    • Standardmäßig wird gl7-gilb-url-map auf service-one verwiesen.

  3. Richten Sie einen zusätzlichen Backend-Dienst (service-two) ein und verweisen Sie ihn auf eine VM in der Region B.

  4. Fügen Sie der URL-Zuordnung einen Pfad-Matcher hinzu, der auf service-two verweist. Verwenden Sie den Befehl gcloud compute url-maps add-path-matcher mit den folgenden Beispielwerten:

      gcloud compute url-maps add-path-matcher gl7-gilb-url-map \
      --path-matcher-name=rewrite-host \
      --default-service=service-two \
      --new-hosts=service-extensions.com \
      --location=global

  5. Richten Sie eine Möglichkeit ein, Testanfragen an Ihren Dienst zu senden (z. B. durch Ausführen von curl). Wenn Sie einen internen Load Balancer verwenden, erstellen Sie eine Client-VM zum Testen.

Routenerweiterung mit einem Plug-in konfigurieren

  1. Prüfen Sie das Verhalten, bevor eine Erweiterung konfiguriert wird.

    1. Prüfen Sie, ob eine Anfrage ohne expliziten Pfad an die Region A gesendet wird:

      curl FORWARDING_RULE_IP

      Ersetzen Sie FORWARDING_RULE_IP durch die IP-Adresse der Weiterleitungsregel. Verwenden Sie den Befehl gcloud compute forwarding-rules describe, um die IP-Adresse zu ermitteln.

      Die Ausgabe sieht in etwa so aus und gibt an, dass die Seite von einer VM in region A bereitgestellt wird:

      Page served from region-A-vm

    2. Prüfen Sie, ob es in der URL-Zuordnung keine Übereinstimmung für /extensions gibt:

      curl FORWARDING_RULE_IP/extensions

      Ersetzen Sie FORWARDING_RULE_IP durch die IP-Adresse der Weiterleitungsregel. Verwenden Sie den Befehl gcloud compute forwarding-rules describe, um die IP-Adresse zu ermitteln.

      Die Ausgabe gibt an, dass es in der URL-Zuordnung keine Übereinstimmung für /extensions gibt. Die Ausgabe sieht etwa so aus:

      <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html><head>
<title>404 Not Found</title>
</head><body>
...

  2. Konfigurieren Sie die Routenerweiterung.

    Console

    1. Rufen Sie in der Google Cloud Console die Seite Diensterweiterungen auf.

      Zu den Diensterweiterungen

    2. Klicken Sie auf Erweiterung erstellen.

      Ein Assistent wird geöffnet, der Sie durch einige erste Schritte führt.

    3. Wählen Sie für das Produkt Load Balancing aus. Klicken Sie anschließend auf Weiter.

      Eine Liste der unterstützten Application Load Balancer wird angezeigt.

    4. Wählen Sie als Load Balancer-Typ den regionenübergreifenden internen Application Load Balancer aus. Klicken Sie anschließend auf Weiter.

    5. Wählen Sie als Erweiterungstyp Routen-Erweiterungen aus und klicken Sie auf Weiter.

    6. Klicken Sie auf Weiter, um das Formular Erweiterung erstellen zu öffnen.

      Im Formular Erweiterung erstellen sind die vorherigen Auswahlen, die oben auf der Seite angezeigt werden, nicht bearbeitbar.

    7. Führen Sie im Abschnitt Grundlagen folgende Schritte aus:

      1. Geben Sie einen eindeutigen Namen für die Erweiterung an.

        Der Name muss mit einem Kleinbuchstaben beginnen, gefolgt von bis zu 62 Kleinbuchstaben, Ziffern oder Bindestrichen. Er darf nicht mit einem Bindestrich enden.

      2. Optional: Geben Sie eine kurze Beschreibung der Erweiterung mit maximal 1.024 Zeichen ein.

      3. Optional: Klicken Sie im Bereich Labels auf Label hinzufügen. Führen Sie dann in der angezeigten Zeile die folgenden Schritte aus:

        • Geben Sie für Schlüssel einen Schlüsselnamen ein.
        • Geben Sie für Wert einen Wert für den Schlüssel ein.

        Wenn Sie weitere Schlüssel/Wert-Paare hinzufügen möchten, klicken Sie auf Label hinzufügen. Sie können maximal 64 Schlüssel/Wert-Paare hinzufügen.

        Weitere Informationen zu Labels finden Sie unter Labels für Projekte erstellen und aktualisieren.

    8. Wählen Sie unter Weiterleitungsregeln eine oder mehrere Weiterleitungsregeln aus, die mit der Erweiterung verknüpft werden sollen, z. B. cr-ilb-forwarding-rule.

      Weiterleitungsregeln, die bereits mit einer anderen Erweiterung verknüpft sind, können nicht ausgewählt werden und werden deaktiviert angezeigt.

    9. Fügen Sie für Erweiterungsketten eine oder mehrere Erweiterungsketten hinzu, die für eine passende Anfrage ausgeführt werden sollen.

      So fügen Sie eine Erweiterungskette hinzu:

      • Geben Sie für Neue Erweiterungskette einen eindeutigen Namen an.

        Der Name muss RFC-1034 entsprechen, darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten und darf maximal 63 Zeichen lang sein. Außerdem muss das erste Zeichen ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Ziffer sein.

      • Wenn Sie Anfragen abgleichen möchten, für die die Erweiterungskette ausgeführt wird, geben Sie für Abgleichsbedingung einen CEL-Ausdruck (Common Expression Language) an, z. B. request.path.startsWith("/extensions").

        Weitere Informationen zu CEL-Ausdrücken finden Sie unter Syntaxhilfe oder in der CEL-Matcher-Sprachreferenz.

      • Fügen Sie eine Erweiterung hinzu, die für eine passende Anfrage ausgeführt werden soll. Für Routenerweiterungen können Sie nur eine Erweiterung angeben.

        Gehen Sie unter Erweiterungen so vor und klicken Sie dann auf Fertig:

        • Wählen Sie für Programmability type (Programmierbarkeitstyp) die Option Plugins aus.

        • Geben Sie unter Name der Erweiterung einen eindeutigen Namen an.

          Der Name muss RFC-1034 entsprechen, darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten und darf maximal 63 Zeichen lang sein. Außerdem muss das erste Zeichen ein Buchstabe und das letzte ein Buchstabe oder eine Ziffer sein.

        • Wählen Sie unter Plug‑in ein Plug‑in aus, das mit Service Extensions für dasselbe Produkt und denselben Erweiterungstyp erstellt wurde.

        • Klicken Sie für Header weiterleiten auf Header hinzufügen und fügen Sie dann HTTP-Header hinzu, die an die Erweiterung weitergeleitet werden sollen (vom Client oder Backend). Wenn kein Header angegeben ist, werden alle Header gesendet.

        • Optional: Wenn für die Erweiterung ein Zeitlimit überschritten wird oder sie fehlschlägt und Sie möchten, dass die Verarbeitung von Anfragen oder Antworten fortgesetzt wird, wählen Sie für Fail open die Option Aktiviert aus.

          Standardmäßig ist die Option Fail open nicht ausgewählt. In diesem Fall wird die Verarbeitung von Anfragen oder Antworten bei einem Fehler beendet. Wenn Antwortheader nicht an den Downstream-Client gesendet wurden, wird ein generischer HTTP-Statuscode 500 an den Client zurückgegeben. Wenn Antwortheader gesendet wurden, wird der HTTP-Stream zum Client zurückgesetzt.

          Die Standardoption, Fail open nicht ausgewählt zu lassen, wird bevorzugt, wenn Sicherheit oder Integrität Priorität haben. Wenn Sie Fail open aktivieren, insbesondere für nicht kritische Vorgänge, können Sie die Verfügbarkeit priorisieren.

    10. Klicken Sie auf Erweiterung erstellen.

    gcloud

    1. Definieren Sie das Plug-in in einer YAML-Datei und verknüpfen Sie es mit einer globalen Weiterleitungsregel, z. B. cr-ilb-forwarding-rule.

      cat >route-plugin.yaml <<EOF
    name: route-ext
    forwardingRules:
    - https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/forwardingRules/cr-ilb-forwarding-rule
    loadBalancingScheme: INTERNAL_MANAGED
    extensionChains:
    - name: "chain1"
      matchCondition:
        celExpression: 'request.path.startsWith("/extensions")'
      extensions:
      - name: 'ext1'
        service: projects/PROJECT_ID/locations/LOCATION/wasmPlugins/WASM_PLUGIN
        failOpen: false
        supportedEvents:
        - REQUEST_HEADERS
EOF

      Ersetzen Sie Folgendes:

      • PROJECT_ID: die Projekt-ID.
      • REGION: die Region der Weiterleitungsregel. Der Wert muss mit dem für den Speicherort des Plug-ins angegebenen Wert übereinstimmen.
      • LOCATION: Der Speicherort des Plug-ins als global oder eine Region.
      • WASM_PLUGIN: Die ID oder der voll qualifizierte Name des Plug-ins.

    2. Importieren Sie die Routenerweiterung. Verwenden Sie den Befehl gcloud service-extensions lb-route-extensions import mit den folgenden Beispielwerten.

      gcloud service-extensions lb-route-extensions import route-ext \
    --source=route-plugin.yaml \
    --location=global

    Nachdem eine Routenerweiterung erstellt wurde, dauert es eine Weile, bis das neue Plug-in an allen Standorten verfügbar ist. Die Zeit kann je nach Standort variieren, da das Plug-in nicht gleichzeitig an alle Standorte ausgeliefert wird.

  3. Verwenden Sie denselben curl-Befehl, um zu prüfen, ob die Routenerweiterung wie erwartet funktioniert:

    curl FORWARDING_RULE_IP/extensions

    Die Ausgabe sieht in etwa so aus und gibt an, dass die Seite von einer VM in region B bereitgestellt wird:

    Page served from region-B-vm

    Um zu prüfen, ob das Plug-in nur für Anfragen mit dem Pfadpräfix /extension ausgeführt wird, wiederholen Sie den Befehl curl ohne Pfad.

    curl FORWARDING_RULE_IP

    Die Ausgabe sieht etwa so aus:

    Page served from region-A-vm

Mit Zusatzinformationen konfigurieren

In diesem Abschnitt erfahren Sie, wie Sie eine Routenerweiterung mit einem Callout konfigurieren.

Hinweise

Erstellen Sie die erforderlichen Ressourcen, wie unter Callout-Backend-Dienst konfigurieren beschrieben.

Routenerweiterung mit einem Callout konfigurieren

Das folgende Beispiel zeigt, wie Sie eine Routenerweiterung konfigurieren, die aufgerufen wird, wenn der Pfad mit /extensions übereinstimmt. Der Server für Routen-Callouts in callout-vm ändert den Host-Header in service-extensions.com, legt den Pfad auf / fest und sendet dann eine Anweisung an den Load-Balancer, die Route neu zu berechnen. Der Traffic wird dann an l7-ilb-backend-service2 anstelle von l7-ilb-backend-service gesendet.

  1. Prüfen Sie, ob es in der URL-Zuordnung eine Übereinstimmung für /extensions gibt.

    1. Führen Sie den folgenden curl-Befehl für die Weiterleitungsregel auf der Client-VM aus:

      curl FORWARDING_RULE_IP/extensions

      Ersetzen Sie FORWARDING_RULE_IP durch die IP-Adresse der Weiterleitungsregel. Verwenden Sie den Befehl gcloud compute forwarding-rules describe, um die IP-Adresse zu ermitteln.

      Die Ausgabe gibt an, dass es in der URL-Zuordnung keine Übereinstimmung für /extensions gibt. Die Ausgabe sieht etwa so aus:

      <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
<html><head>
<title>404 Not Found</title>
</head><body>
...

  2. Konfigurieren Sie die Routenerweiterung.

    Console

    1. Rufen Sie in der Google Cloud Console die Seite Diensterweiterungen auf.

      Zu den Diensterweiterungen

    2. Klicken Sie auf Erweiterung erstellen.

      Ein Assistent wird geöffnet, der Sie durch einige erste Schritte führt.

    3. Wählen Sie für das Produkt Load Balancing aus. Klicken Sie anschließend auf Weiter.

      Eine Liste der unterstützten Application Load Balancer wird angezeigt.

    4. Wählen Sie einen Load-Balancer-Typ aus. Geben Sie für regionale Load Balancer auch die Region an. Klicken Sie auf Weiter.

    5. Wählen Sie als Erweiterungstyp Routen-Erweiterungen aus und klicken Sie auf Weiter.

    6. Klicken Sie auf Weiter, um das Formular Erweiterung erstellen zu öffnen.

      Im Formular Erweiterung erstellen sind die vorherigen Auswahlen, die oben auf der Seite angezeigt werden, nicht bearbeitbar.

    7. Führen Sie im Abschnitt Grundlagen folgende Schritte aus:

      1. Geben Sie einen eindeutigen Namen für die Erweiterung an.

        Der Name muss mit einem Kleinbuchstaben beginnen, gefolgt von bis zu 62 Kleinbuchstaben, Ziffern oder Bindestrichen. Er darf nicht mit einem Bindestrich enden.

      2. Optional: Geben Sie eine kurze Beschreibung der Erweiterung mit maximal 1.024 Zeichen ein.

      3. Optional: Klicken Sie im Bereich Labels auf Label hinzufügen. Führen Sie dann in der angezeigten Zeile die folgenden Schritte aus:

        • Geben Sie für Schlüssel einen Schlüsselnamen ein.
        • Geben Sie für Wert einen Wert für den Schlüssel ein.

        Wenn Sie weitere Schlüssel/Wert-Paare hinzufügen möchten, klicken Sie auf Label hinzufügen. Sie können maximal 64 Schlüssel/Wert-Paare hinzufügen.

        Weitere Informationen zu Labels finden Sie unter Labels für Projekte erstellen und aktualisieren.

    8. Wählen Sie unter Weiterleitungsregeln eine oder mehrere Weiterleitungsregeln aus, die mit der Erweiterung verknüpft werden sollen, z. B. l7-ilb-forwarding-rule.

      Weiterleitungsregeln, die bereits mit einer anderen Erweiterung verknüpft sind, können nicht ausgewählt werden und werden deaktiviert angezeigt.

    9. Fügen Sie für Erweiterungsketten eine oder mehrere Erweiterungsketten hinzu, die für eine passende Anfrage ausgeführt werden sollen.

      So fügen Sie eine Erweiterungskette hinzu: Gehen Sie so vor und klicken Sie dann auf Fertig.

      • Geben Sie für Neue Erweiterungskette einen eindeutigen Namen an.

        Der Name muss RFC-1034 entsprechen, darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten und darf maximal 63 Zeichen lang sein. Außerdem muss das erste Zeichen ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Ziffer sein.

      • Wenn Sie Anfragen abgleichen möchten, für die die Erweiterungskette ausgeführt wird, geben Sie für Abgleichsbedingung einen CEL-Ausdruck (Common Expression Language) an, z. B. request.path.startsWith("/extensions").

        Weitere Informationen zu CEL-Ausdrücken finden Sie unter Syntaxhilfe oder in der CEL-Matcher-Sprachreferenz.

      • Fügen Sie eine Erweiterung hinzu, die für eine passende Anfrage ausgeführt werden soll. Für Routenerweiterungen können Sie nur eine Erweiterung angeben.

        Gehen Sie unter Erweiterungen so vor und klicken Sie dann auf Fertig:

        • Wählen Sie als Programmability type (Programmierbarkeitstyp) die Option Callouts (Hinweis-Overlays) aus.

        • Geben Sie unter Name der Erweiterung einen eindeutigen Namen an.

          Der Name muss RFC-1034 entsprechen, darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten und darf maximal 63 Zeichen lang sein. Außerdem muss das erste Zeichen ein Buchstabe und das letzte ein Buchstabe oder eine Ziffer sein.

        • Geben Sie für Authority den authority-Header aus der gRPC-Anfrage ein, die vom Load Balancer an den Erweiterungsdienst gesendet wird.

        • Wählen Sie für Backend-Dienst einen Backend-Dienst aus, der gemäß der Anleitung unter Callout-Backend-Dienst konfigurieren erstellt wurde.

        • Geben Sie für Zeitüberschreitung einen Wert zwischen 10 und 1.000 Millisekunden an. Nach Ablauf dieser Zeit wird für eine Nachricht im Stream ein Zeitlimit überschritten, während der Load Balancer noch auf eine Antwort vom ext_proc-Dienst wartet.

        • Klicken Sie für Header weiterleiten auf Header hinzufügen und fügen Sie dann HTTP-Header hinzu, die an die Erweiterung weitergeleitet werden sollen (vom Client oder Backend). Wenn kein Header angegeben ist, werden alle Header gesendet.

        • Optional: Wenn für die Erweiterung ein Zeitlimit überschritten wird oder sie fehlschlägt und Sie möchten, dass die Verarbeitung von Anfragen oder Antworten fortgesetzt wird, wählen Sie für Fail open die Option Aktiviert aus. Nachfolgende Erweiterungen in der Kette werden ebenfalls ausgeführt.

          Standardmäßig ist die Option Fail open nicht ausgewählt. In diesem Fall wird die Verarbeitung von Anfragen oder Antworten bei einem Fehler beendet. Wenn Antwortheader nicht an den Downstream-Client gesendet wurden, wird ein generischer HTTP-Statuscode 500 an den Client zurückgegeben. Wenn Antwortheader gesendet wurden, wird der HTTP-Stream zum Client zurückgesetzt.

          Die Standardoption, Fail open nicht ausgewählt zu lassen, wird bevorzugt, wenn Sicherheit oder Integrität Priorität haben. Wenn Sie Fail open aktivieren, insbesondere für nicht kritische Vorgänge, können Sie die Verfügbarkeit priorisieren.

        • Klicken Sie unter Metadaten auf Metadaten hinzufügen und geben Sie Beispielwerte wie vorgeschlagen an. Geben Sie für Schlüssel key und für Wert value an.

          Klicken Sie auf Metadaten hinzufügen, um ein weiteres Schlüssel/Wert-Paar hinzuzufügen. Geben Sie für Schlüssel fr und für Wert forwarding_rule_id an.

          Im Feld Metadaten können Sie zusätzliche Informationen vom Load Balancer an den Erweiterungsserver übergeben. Die Metadaten werden in einer ProcessingRequest-Nachricht gesendet und als protobuf.Struct codiert. Jeder Text in den Metadaten, der mit der angegebenen Weiterleitungsregel-ID übereinstimmt, wird durch die voll qualifizierte Ressourcen-URL der Weiterleitungsregel ersetzt, die mit der Clientanfrage verknüpft ist.

          Die Gesamtgröße der Metadaten muss weniger als 1 KiB betragen. Die Gesamtzahl der Schlüssel in den Metadaten muss kleiner als 16 sein. Jeder Schlüssel darf maximal 64 Zeichen umfassen. Die Länge jedes Werts darf maximal 1.024 Zeichen betragen. Alle Werte müssen Strings sein.

    10. Klicken Sie auf Erweiterung erstellen.

    gcloud

    1. Definieren Sie den Callout in einer YAML-Datei und verknüpfen Sie ihn mit der Weiterleitungsregel. Verwenden Sie die angegebenen Beispielwerte.

      cat >route.yaml <<EOF
    name: route-ext
    forwardingRules:
    - https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-west1/forwardingRules/l7-ilb-forwarding-rule
    loadBalancingScheme: INTERNAL_MANAGED
    extensionChains:
    - name: "chain1"
      matchCondition:
        celExpression: 'request.path.startsWith("/extensions")'
      extensions:
      - name: 'ext11'
        authority: ext11.com
        service: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/us-west1/backendServices/l7-ilb-callout-service
        failOpen: false
        timeout: 0.1s
        metadata:
          "key": "value"
          "fr": "forwarding_rule_id"
EOF

      Ersetzen Sie PROJECT_ID durch die Projekt-ID.

      Mit dem Feld metadata in der Erweiterungskonfiguration können Sie zusätzliche Informationen vom Load Balancer an den Erweiterungsserver übergeben. Die Metadaten werden in einer ProcessingRequest-Nachricht gesendet und als protobuf.Struct codiert. Jeder Text in den Metadaten, der mit der angegebenen Weiterleitungsregel-ID übereinstimmt, wird durch die vollqualifizierte Ressourcen-URL der Weiterleitungsregel ersetzt, die mit der Clientanfrage verknüpft ist.

      Die Gesamtgröße von metadata muss kleiner als 1 KiB sein. Die Gesamtzahl der Schlüssel in den Metadaten muss kleiner als 16 sein. Jeder Schlüssel darf maximal 64 Zeichen umfassen. Die Länge jedes Werts darf maximal 1.024 Zeichen betragen. Alle Werte müssen Strings sein.

    2. Importieren Sie die Routenerweiterung. Verwenden Sie den Befehl gcloud service-extensions lb-route-extensions import mit den folgenden Beispielwerten.

      gcloud service-extensions lb-route-extensions import route-ext \
    --source=route.yaml \
    --location=us-west1

  3. Prüfen Sie, ob die Routenerweiterung wie erwartet funktioniert. Verwenden Sie denselben curl-Befehl:

    curl FORWARDING_RULE_IP/extensions

    Die Ausgabe gibt an, dass der Traffic mit dem virtuellen Host service-extensions.com übereinstimmte und den Dienst l7-ilb-backend-service2 erreichte, obwohl die ursprüngliche Anfrage dies nicht tat. Die Ausgabe sieht etwa so aus:

    Page served from second backend service

    Um zu prüfen, ob der Callout nur auf Anfragen mit dem Präfix /extension ausgerichtet ist, wiederholen Sie den Befehl curl ohne das Präfix path.

    curl FORWARDING_RULE_IP

    Die Ausgabe sieht etwa so aus:

    Page served from: l7-ilb-backend-example-1c7t

Einschränkungen für Routenverlängerungen

  • Routenerweiterungen unterstützen keine Verarbeitung von HTTP-Textkörpern.
  • Eine direkte Antwort der Erweiterung an den Client wird für Routenerweiterungen nicht unterstützt. Wenn Ihr Routenerweiterungsserver auf eine Verarbeitungsanfrage mit einer Verarbeitungsantwort antwortet, die eine direkte Antwort enthält, ignoriert der Load-Balancer die Verarbeitungsantwort.

Einschränkungen, die für alle Erweiterungen gelten, finden Sie unter Einschränkungen für Erweiterungen.

Nächste Schritte