Collega un plug-in a una route Media CDN

Questa pagina descrive come configurare i plug-in di Service Extensions nelle route Media CDN.

Puoi utilizzare Media CDN con Service Extensions per aggiungere codice personalizzato al percorso di elaborazione delle richieste e delle risposte. Questa personalizzazione sblocca un'ampia gamma di casi d'uso leggeri.

Per saperne di più, consulta Panoramica delle estensioni di Media CDN.

Prima di iniziare

  1. Crea un'origine Media CDN
  2. Crea un servizio Media CDN
  3. Creare un plug-in utilizzando Service Extensions

Crea un'azione Wasm per un plug-in

Quando crei un'azione Wasm, non puoi utilizzare un plug-in già in uso in un'estensione Cloud Load Balancing.

Crea un'azione Wasm per il plug-in Service Extensions eseguendo il comando gcloud alpha service-extensions wasm-actions create:

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

Sostituisci quanto segue:

  • WASM_ACTION: l'ID o il nome completo dell'azione Wasm
  • WASM_PLUGIN: il nome del plug-in a cui vuoi collegare l'azione
  • EVENT: la parte del payload da elaborare dal plug-in, come indicato da uno o entrambi questi valori: request-headers o response-headers. Se non specificato, vengono elaborati entrambi gli header.

La creazione di un'azione Wasm potrebbe richiedere un po' di tempo.

Collegare un plug-in a una rotta

Per collegare un plug-in a una route Media CDN:

  1. Per esportare la configurazione attuale del servizio in un file YAML, esegui il comando gcloud edge-cache services export:

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

    Sostituisci quanto segue:

    • SERVICE_NAME: il nome del servizio Media CDN
    • FILENAME: il nome del file YAML

  2. Utilizza un editor di testo per modificare il file YAML.

  3. Aggiorna le route nel file per aggiungere l'intestazione wasmAction come mostrato nell'esempio seguente:

      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

    Sostituisci quanto segue:

    • SERVICE_NAME: il nome del servizio Media CDN
    • DOMAIN_NAME: il dominio del servizio Media CDN
    • PROJECT_NUMBER: il numero di progetto
    • ORIGIN_NAME: l'origine dei contenuti
    • WASM_ACTION: l'azione Wasm di Service Extensions

  4. Salva il file YAML.

  5. Esegui il comando gcloud edge-cache services import:

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

Potrebbe essere necessario un po' di tempo prima che il nuovo plug-in venga distribuito in tutte le posizioni. L'ora potrebbe variare a seconda della località perché il plug-in non viene distribuito in tutte le località contemporaneamente.

Passaggi successivi