Configuración lista para producción para CloudFront MediaTailor - AWS Elemental MediaTailor
Arquitectura de tres orígenesPrioridad y configuración del comportamiento de la caché

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración lista para producción para CloudFront MediaTailor

Esta configuración CloudFront de distribución proporciona todo lo que necesitas para entregar MediaTailor contenido con una inserción de anuncios en el servidor a escala. Copie esta configuración y personalícela según sus orígenes y requisitos específicos.

Lo que consigue esta configuración

Esta configuración crea una CloudFront distribución lista para la producción que gestiona todos los tipos de MediaTailor solicitudes con un rendimiento y un almacenamiento en caché óptimos. Incluye tres orígenes (el contenido, los MediaTailor segmentos y los MediaTailor manifiestos) con cuatro comportamientos de caché que direccionan las solicitudes correctamente y almacenan el contenido en caché de forma adecuada.

Cuándo usar esta configuración

Esta configuración es ideal para la transmisión en directo y los flujos de trabajo híbridos que requieren la inserción de anuncios en el lado del servidor. video-on-demand

Arquitectura de tres orígenes

MediaTailor utiliza un patrón de arquitectura de tres orígenes para optimizar la entrega de contenido y el rendimiento de la inserción de anuncios. Cada origen cumple un propósito específico en el flujo de trabajo de inserción de anuncios:

El origen de tu contenido

Este es el verdadero origen del contenido que alimenta MediaTailor. Por ejemplo, podría ser AWS Elemental MediaPackage V2 u otro servicio de entrega de contenido. Este origen muestra tu contenido original antes de la inserción del anuncio. Algunos ejemplos habituales son los siguientes:

  • MediaPackage Configuraciones de empaquetado V2

  • Redes de entrega de contenido de terceros

  • Servidores de streaming locales

  • Buckets de Amazon S3 con contenido estático

MediaTailor origen de los segmentos

Este origen utiliza el nombre de servidor segments.mediatailor.region.amazonaws.com y muestra los segmentos de anuncios reales después de MediaTailor codificarlos. Estos son los segmentos de vídeo que contienen los anuncios. Este origen gestiona:

  • Segmentos de anuncios transcodificados en el mismo formato que tu contenido

  • Redirigió las solicitudes desde el patrón de /segment/* ruta

  • Segmentos de anuncios que se han procesado para su inserción en el servidor

MediaTailor manifiesta su origen

Este origen usa el nombre de host manifests.mediatailor.region.amazonaws.com y se puede usar como nombre de host regional para las configuraciones de reproducción en la región especificada AWS . MediaTailor selecciona la configuración de reproducción correcta en función de la ruta de la solicitud. Este origen proporciona:

  • Manifiestos HLS y DASH personalizados con inserción de anuncios específica para cada espectador

  • Manifiestos de inserción de anuncios guiada por el servidor (SGAI) para contenido que se puede almacenar en caché

  • Seguimiento de anuncios y gestión de balizas para generar informes desde el servidor

Con el nombre de host de origenmanifests.mediatailor.region.amazonaws.com, puede tener varias configuraciones de reproducción que funcionen con la misma CloudFront distribución si se encuentran en la región especificada e incluir el nombre de la configuración de reproducción en la ruta de solicitud. Por ejemplo:

  • https://your-distribution.cloudfront.net/v1/master/playback-config-1/manifest.m3u8

  • https://your-distribution.cloudfront.net/v1/master/playback-config-2/manifest.m3u8

Revisa y ajusta las políticas de solicitud de origen en función de tus requisitos específicos de origen del contenido. En el ejemplo se utilizan las políticas de origen de S3, pero es posible que necesites políticas diferentes para los orígenes personalizados. Tenga en cuenta estos factores al seleccionar las políticas de solicitud de origen:

  • Orígenes de S3: uso Managed-CORS-S3Origin para buckets de Amazon S3

  • Orígenes personalizados: utilice Managed-AllViewer o Managed-AllViewerAndCloudFrontHeaders-2022-6 para orígenes HTTP personalizados

  • MediaPackage orígenes: se utilizan Managed-CORS-S3Origin para puntos finales de la MediaPackage versión 2

Origins table showing ContentOrigin, MediaTailorSegments, and MediaTailorManifests with their respective details.

Prioridad y configuración del comportamiento de la caché

MediaTailor requiere configuraciones de comportamiento de caché específicas para gestionar los diferentes tipos de solicitudes de forma adecuada. La prioridad de los comportamientos de la caché es fundamental porque los CDNs procese en orden (del más pequeño al más grande) y utilice ese comportamiento para el primer patrón de ruta coincidente. Entender esta prioridad es fundamental para solucionar problemas:

  • Prioridad 0: la mayoría de los patrones específicos (como/tm/*) se evalúan primero

  • Números de prioridad más altos: los patrones menos específicos se evalúan en orden

  • Comportamiento predeterminado: captura todas las solicitudes que no coinciden con otros patrones

Si las solicitudes no se comportan como se esperaba, comprueba que los patrones de ruta no se superpongan de forma no deseada.

Table showing behaviors with path patterns, origins, and policies for different URL paths.

Prioridad 0: comportamiento de las rutas de los segmentos de anuncios

Este comportamiento gestiona las solicitudes redirigidas desde el comportamiento de la ruta del segmento y sirve para los segmentos de anuncios reales. CloudFront aplica los siguientes comportamientos a todas las solicitudes con un patrón de /tm/* ruta. Este es el comportamiento de mayor prioridad porque la publicación de segmentos de anuncios es fundamental para una reproducción ininterrumpida.

  • Patrón de ruta: /tm/*

    Ejemplos URLs que coinciden con este patrón:

    • https://your-distribution.cloudfront.net/tm/ad-segment-001.ts

    • https://your-distribution.cloudfront.net/tm/transcoded-ad.m4s

  • Origen: el origen que creaste con el segments.mediatailor.region.amazonaws.com dominio.

    Esto se muestra MediaTailorSegmentsen el ejemplo de la sección anterior sobre los orígenes.

  • Política de caché: Managed-CachingOptimized

    La política de Managed-CachingOptimized caché debe configurarse para incluir el encabezado Origin en la clave de caché para evitar problemas de envenenamiento de la caché por CORS. Sin el Origin encabezado en la clave de caché, puede producirse el siguiente escenario:

    1. Una solicitud sin Origin encabezado es recibida y almacenada en caché por CloudFront

    2. Una solicitud posterior con un Origin encabezado recibe la respuesta en caché (que carece de encabezados CORS)

    3. El navegador rechaza la respuesta porque faltan encabezados CORS, lo que provoca errores de reproducción

    Para obtener más información sobre lo que incluye la política de caché CloudFront administrada, consulte la CachingOptimizedguía del CloudFront usuario. También puedes usar esta misma configuración desde la política gestionada de tu CDN de terceros.

  • Política de solicitudes de Origin: Managed-CORS-S3Origin

    Para obtener más información sobre lo que incluye la política de solicitudes de origen CloudFront gestionadas, consulta CORS-S3Origin en la guía del usuario. CloudFront También puedes usar estos mismos ajustes de la política gestionada de tu CDN de terceros.

  • Política de encabezados de respuesta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    El uso de la política de encabezados de Managed-CORS-with-preflight-and-SecurityHeadersPolicy respuesta es fundamental para evitar el envenenamiento de la caché del CORS. Esta política garantiza que se CloudFront incluya el Access-Control-Allow-Origin encabezado en las respuestas, algo necesario para que los actores basados en la web puedan acceder a segmentos de anuncios de distintos orígenes.

    Para obtener más información sobre lo que incluye la política de encabezados de respuesta, consulta CORS- with-preflight-and - SecurityHeadersPolicy en la guía del CloudFront usuario.

Adaptar estos ajustes a otros CDNs

Si utilizas una CDN que no sea CloudFront, busca una configuración equivalente que logre lo siguiente.

Coincidencia de patrones de ruta

Configura un comportamiento específico para que el patrón de /tm/* ruta gestione los segmentos de MediaTailor anuncios

Configuración de claves de caché

Incluye el Origin encabezado en tu clave de caché para asegurarte de que las respuestas se almacenen en caché por separado para los distintos orígenes

Reenvío de encabezados

Reenvía el Origin encabezado y otros encabezados relacionados con CORS al origen

Administración de encabezados de respuesta

Configura tu CDN para asegurarte de que el Access-Control-Allow-Origin encabezado esté presente en las respuestas

La terminología específica y las opciones de configuración variarán según el proveedor de CDN, pero los principios subyacentes siguen siendo los mismos.

Prioridad 1: comportamiento de inserción de anuncios guiado por el servidor

Este comportamiento gestiona las solicitudes Descripción de la inserción de AWS Elemental MediaTailor anuncios guiada por el servidor (SGAI) cuando los clientes configuran el modo guiado, que proporciona manifiestos que se pueden almacenar en caché. CloudFront aplica los siguientes comportamientos a todas las solicitudes con un patrón de ruta. /i-media/* La SGAI permite un mejor rendimiento de almacenamiento en caché porque los manifiestos no son específicos del visor.

  • Patrón de ruta: /i-media/* (ruta de iMedia para SGAI)

    Ejemplos URLs que coinciden con este patrón:

    • https://your-distribution.cloudfront.net/i-media/your-config/manifest.m3u8

    • https://your-distribution.cloudfront.net/i-media/your-config/playlist.mpd

  • Origen: el origen que creaste con el manifests.mediatailor.region.amazonaws.com dominio.

    Esto se muestra MediaTailorManifestsen el ejemplo de la sección anterior sobre los orígenes.

  • Política de caché: Managed-CachingOptimized

    Para obtener más información sobre lo que incluye la política de caché CloudFront gestionada, consulta CachingOptimizedla guía del CloudFront usuario. También puedes usar esta misma configuración desde la política gestionada de tu CDN de terceros.

  • Política de solicitudes de Origin: Managed-CORS-S3Origin

    Para obtener más información sobre lo que incluye la política de solicitudes de origen CloudFront gestionadas, consulta CORS-S3Origin en la guía del usuario. CloudFront También puedes usar estos mismos ajustes de la política gestionada de tu CDN de terceros.

  • Política de encabezados de respuesta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Para obtener más información sobre lo que incluye la política de encabezados de respuesta, consulta CORS- with-preflight-and - SecurityHeadersPolicy en la guía del CloudFront usuario.

Prioridad 2: Comportamiento manifiesto personalizado

Este comportamiento gestiona las solicitudes de manifiestos personalizados. CloudFront aplica los siguientes comportamientos a todas las solicitudes con un patrón de /v1/* ruta. CloudFront aplica los siguientes comportamientos y no almacena en caché los manifiestos personalizados porque contienen contenido publicitario específico para los espectadores. URLs Estos comportamientos se aplican a todas las solicitudes que tienen un patrón de /v1/* ruta. Esta es la MediaTailor funcionalidad principal, en la que cada espectador recibe un manifiesto único con una inserción de anuncios personalizada.

  • Patrón de ruta: /v1/* ( MediaTailor solicitudes V1 estándar)

    Ejemplos URLs que coinciden con este patrón:

    • https://your-distribution.cloudfront.net/v1/master/your-config/manifest.m3u8

    • https://your-distribution.cloudfront.net/v1/dash/your-config/manifest.mpd

  • Origen: el origen que creaste con el manifests.mediatailor.region.amazonaws.com dominio.

    Esto se muestra MediaTailorManifestsen el ejemplo de la sección anterior sobre los orígenes.

  • Política de caché: Managed-CachingDisabled

    Para obtener más información sobre lo que incluye la política de caché, consulta CachingDisabledla guía del CloudFront usuario.

  • Política de solicitudes de Origin: Managed-AllViewerAndCloudFrontHeaders-2022-6

    Para obtener más información sobre lo que incluye la política de solicitudes de Origin, consulta AllViewerAndCloudFrontHeaders-2022-6 en la guía del CloudFront usuario.

  • Política de encabezados de respuesta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Para obtener más información sobre lo que incluye la política de encabezados de respuesta, consulta CORS- with-preflight-and - SecurityHeadersPolicy en la guía del CloudFront usuario.

Encabezado Accept-Coding

Te recomendamos que tu CDN conserve el Accept-Encoding encabezado para que no lo vean los espectadores. Este encabezado proporciona MediaTailor instrucciones sobre cómo comprimir los manifiestos personalizados.

En CloudFront, la política de solicitud de AllViewerAndCloudFrontHeaders origen incluye la transferencia del Accept-Encoding encabezado desde el espectador. Si utilizas una CDN diferente, asegúrate de que conserve este encabezado.

A continuación se explica cómo MediaTailor gestiona el Accept-Encoding encabezado.

  • Dispositivos antiguos: los dispositivos inteligentes más antiguos TVs que no admiten gzip no envían el encabezado Accept-Encoding, por lo MediaTailor que devuelven los manifiestos sin comprimir

  • Dispositivos modernos: los iPhones, los navegadores Chrome y otros clientes modernos envían el encabezado Accept-Encoding, lo que permite comprimir los manifiestos antes de su entrega MediaTailor

Prioridad 3: comportamiento de la ruta de baliza del lado del servidor

Este comportamiento gestiona las solicitudes MediaTailor que dan como resultado redireccionamientos para. Seguimiento del lado del servidor Estas solicitudes son esenciales para rastrear las balizas, por lo que todas las solicitudes deben ser procesadas por. MediaTailor CloudFront aplica los siguientes comportamientos a todas las solicitudes con un patrón de /segment/* ruta.

  • Patrón de ruta: /segment/*

    Ejemplos URLs que coinciden con este patrón:

    • https://your-distribution.cloudfront.net/segment/tracking-beacon-123

    • https://your-distribution.cloudfront.net/segment/ad-request-456.ts

  • Origen: el origen que creaste con el manifests.mediatailor.region.amazonaws.com dominio.

    Esto se muestra MediaTailorManifestsen el ejemplo de la sección anterior sobre los orígenes.

  • Política de caché: Managed-CachingDisabled

    Para obtener más información sobre lo que incluye la política de caché, consulta CachingDisabledla guía del CloudFront usuario.

  • Política de solicitudes de Origin: Managed-AllViewerAndCloudFrontHeaders-2022-6

    Para obtener más información sobre lo que incluye la política de solicitudes de Origin, consulta AllViewerAndCloudFrontHeaders-2022-6 en la guía del CloudFront usuario.

  • Política de encabezados de respuesta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Para obtener más información sobre lo que incluye la política de encabezados de respuesta, consulta CORS- with-preflight-and - SecurityHeadersPolicy en la guía del CloudFront usuario.

Cuando MediaTailor procesa estas solicitudes, devuelve una respuesta de redireccionamiento 302 con una ruta que apunta a la ubicación real del segmento. Por ejemplo, una solicitud /segment/ad123.ts podría redirigir /tm/encoded-ad-segment.ts al origen del segmento.

Prioridad 4: comportamiento de la ruta de origen del contenido

Si la ruta de la solicitud no coincide con ninguno de los demás patrones, CloudFront aplica el comportamiento predeterminado. Este comportamiento envía las solicitudes directamente al origen del contenido, sin procesarlas desde él MediaTailor. Esto permite acceder directamente al origen del contenido (como la MediaPackage versión 2) cuando sea necesario. CloudFront aplica los siguientes comportamientos a todas las solicitudes que no incluyen ninguno de los patrones de ruta anteriores.

  • Patrón de ruta: (*)

  • Origen: el origen que creaste con el dominio para el origen de tu contenido.

    Esto se muestra ContentOriginen el ejemplo de la sección anterior sobre los orígenes.

  • Política de caché: Managed-CachingOptimized

    Para obtener más información sobre lo que incluye la política de caché CloudFront gestionada, consulta CachingOptimizedla guía del CloudFront usuario. También puedes usar esta misma configuración desde la política gestionada de tu CDN de terceros.

    nota

    Para las implementaciones de HLS de baja latencia, considere la posibilidad de utilizar una política de almacenamiento en caché personalizada con directivas HLS de baja latencia (LLH) en lugar de la política estándar. CachingOptimized

  • Política de solicitudes de origen: se configura para pasar los encabezados y los parámetros de cadena de consulta adecuados al origen del contenido. Para obtener información sobre las políticas de solicitudes de origen gestionadas disponibles, consulta Cómo utilizar las políticas de solicitudes de origen gestionado en la guía para desarrolladores de CF.

  • Política de encabezados de respuesta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Si bien el comportamiento predeterminado del origen del contenido no suele correr los mismos riesgos de intoxicación de la caché de CORS que el comportamiento de los segmentos de anuncios, se recomienda utilizar la política de encabezados de Managed-CORS-with-preflight-and-SecurityHeadersPolicy respuesta e incluir el Origin encabezado en la clave de caché. Esto garantiza una gestión coherente del CORS en todos los tipos de contenido y evita posibles problemas de reproducción en los reproductores basados en la web.

    Para los segmentos de contenido, la política de Managed-CachingOptimized caché proporciona un buen rendimiento, mientras que la política de encabezados de Managed-CORS-with-preflight-and-SecurityHeadersPolicy respuesta garantiza un manejo correcto del CORS. Esta combinación permite un almacenamiento en caché eficiente y, al mismo tiempo, mantiene la compatibilidad con los reproductores basados en la web que requieren encabezados CORS.

    Aplicar una gestión coherente del CORS tanto en los segmentos de anuncios como en los segmentos de contenido crea una experiencia de reproducción más fiable y simplifica la solución de problemas. Sin una configuración de CORS adecuada, los reproductores podrían experimentar un comportamiento incoherente al realizar la transición entre el contenido y los anuncios.

    Para obtener más información sobre lo que incluye la política de encabezados de respuesta, consulta CORS- with-preflight-and - SecurityHeadersPolicy en la guía del usuario. CloudFront