Associer un plug-in à une route Media CDN

Cette page explique comment configurer les plug-ins d'extensions de service dans les routes Media CDN.

Vous pouvez utiliser Media CDN avec Service Extensions pour ajouter du code personnalisé au chemin de traitement des requêtes et des réponses. Cette personnalisation permet de débloquer une grande variété de cas d'utilisation légers.

Pour en savoir plus, consultez la présentation des extensions Media CDN.

Avant de commencer

  1. Créer une origine Media CDN
  2. Créer un service Media CDN
  3. Créer un plug-in à l'aide de Service Extensions

Créer une action Wasm pour un plug-in

Lorsque vous créez une action Wasm, vous ne pouvez pas utiliser un plug-in déjà utilisé dans une extension Cloud Load Balancing.

Créez une action Wasm pour votre plug-in Service Extensions en exécutant la commande gcloud alpha service-extensions wasm-actions create :

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

Remplacez les éléments suivants :

  • WASM_ACTION : ID ou nom complet de l'action Wasm
  • WASM_PLUGIN : nom du plug-in auquel vous souhaitez associer l'action
  • EVENT : partie de la charge utile à traiter par le plug-in, indiquée par l'une ou l'autre de ces valeurs, ou les deux : request-headers ou response-headers. Si aucune valeur n'est spécifiée, les deux en-têtes sont traités.

La création d'une action Wasm peut prendre un certain temps.

Associer un plug-in à un itinéraire

Pour associer un plug-in à un itinéraire Media CDN, procédez comme suit :

  1. Pour exporter la configuration actuelle de votre service vers un fichier YAML, exécutez la commande gcloud edge-cache services export :

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

    Remplacez les éléments suivants :

    • SERVICE_NAME : nom du service Media CDN.
    • FILENAME : nom du fichier YAML

  2. Utilisez un éditeur de texte pour modifier le fichier YAML.

  3. Mettez à jour les routes dans le fichier pour ajouter l'en-tête wasmAction, comme indiqué dans l'exemple suivant :

      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

    Remplacez les éléments suivants :

    • SERVICE_NAME : nom du service Media CDN.
    • DOMAIN_NAME : domaine du service Media CDN
    • PROJECT_NUMBER : numéro de projet
    • ORIGIN_NAME : origine du contenu
    • WASM_ACTION : action Wasm des extensions de service

  4. Enregistrez le fichier YAML.

  5. Exécutez la commande gcloud edge-cache services import :

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

La distribution du nouveau plug-in à tous les emplacements peut prendre un certain temps. Le délai peut varier selon les zones géographiques, car le plug-in n'est pas distribué simultanément dans toutes les zones.

Étapes suivantes