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 des extensions de service pour ajouter du code personnalisé au chemin de traitement des requêtes-réponses. Cette personnalisation permet de débloquer un large éventail 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 d'extensions de service

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 d'extensions de service en exécutant la gcloud alpha service-extensions wasm-actions create commande :

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 une ou les deux valeurs suivantes : 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 à une route

Pour associer un plug-in dans une route Media CDN, procédez comme suit :

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

      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. Modifiez le fichier YAML à l'aide d'un éditeur de texte.

  3. Mettez à jour les routes dans le fichier pour ajouter l'en-tête wasmAction, comme illustré 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 : le numéro du projet
    • ORIGIN_NAME : origine du contenu.
    • WASM_ACTION : action Wasm des extensions de service .

  4. Enregistrez le fichier YAML.

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

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

La distribution du nouveau plug-in dans tous les emplacements peut prendre un certain temps. Ce délai peut varier d'un emplacement à l'autre, car le plug-in n'est pas distribué simultanément dans tous les emplacements.

Étape suivante