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

En esta página, se describe cómo configurar complementos de Service Extensions en rutas de Media CDN.

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

Para obtener más información, consulta la 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 Service Extensions

Crea una acción de Wasm para un complemento

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

Ejecuta el comando gcloud alpha service-extensions wasm-actions create para crear una acción de Wasm para tu complemento de Service Extensions:

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

Reemplaza lo siguiente:

  • WASM_ACTION: Es el ID o el nombre completamente calificado de la acción de Wasm.
  • WASM_PLUGIN: Es el nombre del complemento al que deseas adjuntar la acción.
  • EVENT: Es 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.

Cómo adjuntar 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 comando gcloud edge-cache services export:

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

    Reemplaza lo siguiente:

    • SERVICE_NAME: Es 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: Es el nombre del servicio de Media CDN.
    • DOMAIN_NAME: Es el dominio del servicio de Media CDN.
    • PROJECT_NUMBER: El número del proyecto
    • ORIGIN_NAME: Es el origen del contenido.
    • WASM_ACTION: Es la acción de Wasm de las extensiones del servicio.

  4. Guarda el archivo YAML.

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

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

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

¿Qué sigue?