Plug‑in an eine Media CDN-Route anhängen

Auf dieser Seite wird beschrieben, wie Sie Diensterweiterungs-Plug‑ins in Media CDN-Routen konfigurieren.

Sie können Media CDN mit Diensterweiterungen verwenden, um benutzerdefinierten Code zum Verarbeitungspfad für Anfragen und Antworten hinzuzufügen. Durch diese Anpassung lassen sich viele einfache Anwendungsfälle realisieren.

Weitere Informationen finden Sie unter Übersicht über Media CDN-Erweiterungen.

Hinweis

  1. Media CDN-Ursprung erstellen
  2. Media CDN-Dienst erstellen
  3. Plug‑in mit Diensterweiterungen erstellen

Wasm-Aktion für ein Plug‑in erstellen

Wenn Sie eine Wasm-Aktion erstellen, können Sie kein Plug‑in verwenden, das bereits in einer Cloud Load Balancing-Erweiterung verwendet wird.

Erstellen Sie eine Wasm-Aktion für Ihr Diensterweiterungs-Plug‑in, indem Sie den gcloud alpha service-extensions wasm-actions create Befehl ausführen:

gcloud alpha service-extensions wasm-actions create WASM_ACTION \
    --wasm-plugin=WASM_PLUGIN \
    --supported-events=[EVENT,...]

Ersetzen Sie Folgendes:

  • WASM_ACTION: die ID oder der voll qualifizierte Name der Wasm-Aktion
  • WASM_PLUGIN: der Name des Plug‑ins, an das Sie die Aktion anhängen möchten
  • EVENT: der Teil der Nutzlast, der vom Plug‑in verarbeitet werden soll, angegeben durch einen oder beide der folgenden Werte: request-headers oder response-headers. Wenn nicht angegeben, werden beide Header verarbeitet.

Das Erstellen einer Wasm-Aktion kann einige Zeit dauern.

Plug‑in an eine Route anhängen

So hängen Sie ein Plug‑in an eine Media CDN-Route an:

  1. Führen Sie den gcloud edge-cache services export Befehl aus, um die aktuelle Konfiguration Ihres Dienstes in eine YAML-Datei zu exportieren:

      gcloud edge-cache services export SERVICE_NAME \
      --destination=FILENAME.yaml

    Ersetzen Sie Folgendes:

    • SERVICE_NAME: der Name des Media CDN-Dienstes
    • FILENAME: der Name der YAML-Datei

  2. Bearbeiten Sie die YAML-Datei mit einem Texteditor.

  3. Aktualisieren Sie die Routen in der Datei, um den wasmAction Header hinzuzufügen, wie in dem folgenden Beispiel gezeigt:

      name: SERVICE_NAME
  routing:
    hostRules:
    - hosts:
      - DOMAIN_NAME 
      pathMatcher: routes
    pathMatchers:
    - name: routes
      routeRules:
      - priority: '1'
        description: Route 1
        matchRules:
        - prefixMatch: /plugins
        origin: projects/PROJECT_NUMBER/locations/global/edgeCacheOrigins/ORIGIN_NAME
        routeAction:
          wasmAction: projects/PROJECT_NUMBER/locations/global/wasmActions/WASM_ACTION

    Ersetzen Sie Folgendes:

    • SERVICE_NAME: der Name des Media CDN-Dienstes
    • DOMAIN_NAME: die Domain des Media CDN-Dienstes
    • PROJECT_NUMBER: die Projektnummer
    • ORIGIN_NAME: der Ursprung des Inhalts
    • WASM_ACTION: die Diensterweiterungs- Wasm-Aktion

  4. Speichern Sie die YAML-Datei.

  5. Führen Sie den gcloud edge-cache services import Befehl aus:

      gcloud edge-cache services import SERVICE_NAME \
      --source=FILENAME.yaml

Es kann einige Zeit dauern, bis das neue Plug‑in an allen Standorten verteilt ist. Die Zeit kann je nach Standort variieren, da das Plug‑in nicht gleichzeitig an alle Standorte ausgeliefert wird.

Nächste Schritte