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

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

Sie können Media CDN mit Service Extensions verwenden, um benutzerdefinierten Code in den Anfrage-Antwort-Verarbeitungspfad einzufügen. Durch diese Anpassung werden viele einfache Anwendungsfälle möglich.

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

Hinweise

  1. Media CDN-Ursprung erstellen
  2. Media CDN-Dienst erstellen
  3. Plug‑in mit Service Extensions 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 Service Extensions-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, dem Sie die Aktion zuweisen möchten
  • EVENT: Der Teil der Nutzlast, der vom Plug-in verarbeitet werden soll, wie durch einen oder beide dieser Werte angegeben: request-headers oder response-headers. Wenn nichts angegeben ist, werden beide Header verarbeitet.

Es kann einige Zeit dauern, bis eine Wasm-Aktion erstellt wird.

Plugin an eine Route anhängen

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

  1. Wenn Sie die aktuelle Konfiguration Ihres Dienstes in eine YAML-Datei exportieren möchten, führen Sie den Befehl gcloud edge-cache services export aus:

      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 im 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 der Inhalte
    • WASM_ACTION: die Wasm-Aktion für Diensterweiterungen

  4. Speichern Sie die YAML-Datei.

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

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

Es kann einige Zeit dauern, 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 allen Standorten bereitgestellt wird.

Nächste Schritte