Cómo adjuntar un complemento a una ruta de Media CDN

En esta página, se describe cómo configurar complementos de Extensiones del servicio en rutas de Media CDN.

Puedes usar Media CDN con Extensiones del servicio para agregar código personalizado a la ruta de procesamiento de solicitud-respuesta. Esta personalización desbloquea una amplia variedad de casos de uso livianos.

Para obtener más información, consulta Descripción general de las extensiones de Media CDN.

Antes de comenzar

  1. Crea un origen de Media CDN.
  2. Crea un servicio de Media CDN.
  3. Crea un complemento con Extensiones del servicio.

Crea una acción de Wasm para un complemento

Cuando creas una acción de Wasm, no puedes usar un complemento que ya esté en uso en una extensión de Cloud Load Balancing.

Para crear una acción de Wasm para tu complemento de Extensiones del servicio, ejecuta el gcloud alpha service-extensions wasm-actions create comando:

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

Reemplaza lo siguiente:

  • WASM_ACTION: el ID o el nombre completamente calificado de la acción de Wasm
  • WASM_PLUGIN: el nombre del complemento al que deseas adjuntar la acción
  • EVENT: la parte de la carga útil que procesará el complemento, como se indica con uno o ambos de estos valores: request-headers o response-headers. Si no se especifica, se procesan ambos encabezados.

Es posible que la creación de una acción de Wasm tarde un poco.

Adjunta un complemento a una ruta

Para adjuntar un complemento en una ruta de Media CDN, sigue estos pasos:

  1. Para exportar la configuración actual de tu servicio a un archivo YAML, ejecuta el gcloud edge-cache services export comando:

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

    Reemplaza lo siguiente:

    • SERVICE_NAME: el nombre del servicio de Media CDN
    • FILENAME: el nombre del archivo YAML

  2. Usa un editor de texto para editar el archivo YAML.

  3. Actualiza las rutas en el archivo para agregar el encabezado wasmAction, como se muestra en el siguiente ejemplo:

      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

    Reemplaza lo siguiente:

    • SERVICE_NAME: el nombre del servicio de Media CDN
    • DOMAIN_NAME: el dominio del servicio de Media CDN
    • PROJECT_NUMBER: el número del proyecto
    • ORIGIN_NAME: el origen del contenido
    • WASM_ACTION: la acción de Wasm de Extensiones del servicio

  4. Guarda el archivo YAML.

  5. Ejecuta el gcloud edge-cache services import comando:

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

Es posible que el nuevo complemento tarde un poco en distribuirse en todas las ubicaciones. El tiempo puede variar según la ubicación, ya que el complemento no se entrega a todas las ubicaciones de forma simultánea.

¿Qué sigue?