Configuração pronta para produção para CloudFront MediaTailor - AWS Elemental MediaTailor
Arquitetura de três origensPrecedência e configuração do comportamento do cache

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configuração pronta para produção para CloudFront MediaTailor

Essa configuração CloudFront de distribuição fornece tudo o que você precisa para fornecer MediaTailor conteúdo com inserção de anúncios no lado do servidor em grande escala. Copie essa configuração e personalize-a de acordo com suas origens e requisitos específicos.

O que essa configuração realiza

Essa configuração cria uma CloudFront distribuição pronta para produção que lida com todos os tipos de MediaTailor solicitações com armazenamento em cache e desempenho ideais. Ele inclui três origens (seu conteúdo, MediaTailor segmentos e MediaTailor manifestos) com quatro comportamentos de cache que encaminham as solicitações corretamente e armazenam o conteúdo em cache de forma adequada.

Quando usar essa configuração

Essa configuração é ideal para streaming ao vivo e fluxos de trabalho híbridos que exigem inserção de anúncios no lado do servidor. video-on-demand

Arquitetura de três origens

MediaTailor usa um padrão de arquitetura de três origens para otimizar a entrega de conteúdo e o desempenho de inserção de anúncios. Cada origem tem uma finalidade específica no fluxo de trabalho de inserção de anúncios:

A origem do seu conteúdo

Essa é a verdadeira origem do seu conteúdo que alimenta MediaTailor. Por exemplo, isso pode ser AWS Elemental MediaPackage V2 ou outro serviço de entrega de conteúdo. Essa origem veicula seu conteúdo original antes da inserção do anúncio. Exemplos comuns incluem:

  • MediaPackage Configurações de empacotamento V2

  • Redes de entrega de conteúdo de terceiros

  • Servidores de streaming locais

  • Buckets Amazon S3 com conteúdo estático

MediaTailor origem dos segmentos

Essa origem usa o nome do host segments.mediatailor.region.amazonaws.com e veicula os segmentos de anúncios reais depois MediaTailor de codificá-los. Esses são os segmentos de vídeo que contêm os anúncios. Essa origem trata de:

  • Segmentos de anúncios transcodificados no mesmo formato do seu conteúdo

  • Solicitações redirecionadas do padrão de /segment/* caminho

  • Segmentos de anúncios que foram processados para inserção de anúncios no lado do servidor

MediaTailor manifesta origem

Essa origem usa o nome do host manifests.mediatailor.region.amazonaws.com e pode ser usada como um nome de host regional para configurações de reprodução na região especificada. AWS MediaTailor seleciona a configuração de reprodução correta com base no caminho da solicitação. Essa origem fornece:

  • Manifestos HLS e DASH personalizados com inserção de anúncios específicos para o espectador

  • Manifestos de inserção de anúncios guiados por servidor (SGAI) para conteúdo armazenável em cache

  • Rastreamento de anúncios e tratamento de beacons para relatórios do lado do servidor

Com o nome do host de origemmanifests.mediatailor.region.amazonaws.com, você pode ter várias configurações de reprodução que funcionam com a mesma CloudFront distribuição se estiverem na região especificada e incluir o nome da configuração de reprodução no caminho da solicitação. Por exemplo:

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

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

Revise e ajuste as políticas de solicitação de origem com base em seus requisitos específicos de origem de conteúdo. O exemplo usa políticas de origem do S3, mas talvez você precise de políticas diferentes para origens personalizadas. Considere esses fatores ao selecionar as políticas de solicitação de origem:

  • Origens do S3: uso Managed-CORS-S3Origin para buckets do Amazon S3

  • Origens personalizadas: use Managed-AllViewer ou Managed-AllViewerAndCloudFrontHeaders-2022-6 para origens HTTP personalizadas

  • MediaPackage origens: uso Managed-CORS-S3Origin para endpoints MediaPackage V2

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

Precedência e configuração do comportamento do cache

MediaTailor requer configurações específicas de comportamento de cache para lidar adequadamente com diferentes tipos de solicitações. A precedência dos comportamentos de cache é fundamental porque os CDNs processe em ordem (do menor para o maior) e use o comportamento para o primeiro padrão de caminho correspondente. Compreender essa precedência é essencial para solucionar problemas:

  • Precedência 0: a maioria dos padrões específicos (como/tm/*) são avaliados primeiro

  • Números de precedência mais altos: padrões menos específicos são avaliados em ordem

  • Comportamento padrão: captura todas as solicitações que não correspondem a outros padrões

Se as solicitações não estiverem se comportando conforme o esperado, verifique se seus padrões de caminho não se sobrepõem de forma não intencional.

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

Precedência 0: comportamento do caminho dos segmentos de anúncios

Esse comportamento lida com as solicitações redirecionadas do comportamento do caminho do segmento, veiculando os segmentos de anúncios reais. CloudFront aplica os seguintes comportamentos a todas as solicitações com um padrão de /tm/* caminho. Esse é o comportamento de maior prioridade porque a entrega do segmento de anúncios é fundamental para a reprodução ininterrupta.

  • Padrão de caminho: /tm/*

    Exemplo URLs que corresponde a esse padrão:

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

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

  • Origem: a origem que você criou com o segments.mediatailor.region.amazonaws.com domínio.

    Isso está MediaTailorSegmentsno exemplo da seção anterior sobre origens.

  • Política de cache: Managed-CachingOptimized

    A política de Managed-CachingOptimized cache deve ser configurada para incluir o cabeçalho Origin na chave de cache para evitar problemas de envenenamento do cache do CORS. Sem o Origin cabeçalho na chave de cache, o seguinte cenário pode ocorrer:

    1. Uma solicitação sem Origin cabeçalho é recebida e armazenada em cache por CloudFront

    2. Uma solicitação subsequente com um Origin cabeçalho recebe a resposta em cache (que não possui cabeçalhos CORS)

    3. O navegador rejeita a resposta devido à falta de cabeçalhos CORS, causando falhas na reprodução

    Para obter detalhes sobre o que está incluído na política de cache CloudFront gerenciado, consulte CachingOptimizedo guia CloudFront do usuário. Você também pode usar essas mesmas configurações da política gerenciada em sua CDN de terceiros.

  • Política de solicitação de origem: Managed-CORS-S3Origin

    Para obter detalhes sobre o que está incluído na política de solicitação de origem CloudFront gerenciada, consulte CORS-S3Origin no guia do usuário. CloudFront Você também pode usar essas mesmas configurações da política gerenciada em sua CDN de terceiros.

  • Política de cabeçalhos de resposta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Usar a política de cabeçalhos de Managed-CORS-with-preflight-and-SecurityHeadersPolicy resposta é fundamental para evitar o envenenamento do cache do CORS. Essa política garante a CloudFront inclusão do Access-Control-Allow-Origin cabeçalho nas respostas, o que é necessário para que players da web acessem segmentos de anúncios de diferentes origens.

    Para obter detalhes sobre o que está incluído na política de cabeçalhos de resposta, consulte CORS- with-preflight-and - SecurityHeadersPolicy no guia do CloudFront usuário.

Adaptando essas configurações a outras CDNs

Se você estiver usando uma CDN diferente de CloudFront, procure configurações equivalentes que realizem o seguinte.

Combinação de padrões de caminho

Configure um comportamento específico para o padrão de /tm/* caminho para lidar com segmentos de MediaTailor anúncios

Configuração da chave de cache

Inclua o Origin cabeçalho em sua chave de cache para garantir que as respostas sejam armazenadas em cache separadamente para origens diferentes

Encaminhamento de cabeçalho

Encaminhar o Origin cabeçalho e outros cabeçalhos relacionados ao CORS para a origem

Gerenciamento do cabeçalho de resposta

Configure sua CDN para garantir que o Access-Control-Allow-Origin cabeçalho esteja presente nas respostas

A terminologia específica e as opções de configuração variam de acordo com o provedor de CDN, mas os princípios subjacentes permanecem os mesmos.

Precedência 1: comportamento de inserção de anúncios guiado pelo servidor

Esse comportamento processa solicitações Entendendo a AWS Elemental MediaTailor inserção de anúncios guiada pelo servidor (SGAI) quando os clientes configuram o modo guiado, que fornece manifestos que podem ser armazenados em cache. CloudFront aplica os seguintes comportamentos a todas as solicitações com um padrão de /i-media/* caminho. O SGAI permite um melhor desempenho de armazenamento em cache porque os manifestos não são específicos para o visualizador.

  • Padrão de caminho: /i-media/* (caminho iMedia para SGAI)

    Exemplo URLs que corresponde a esse padrão:

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

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

  • Origem: a origem que você criou com o manifests.mediatailor.region.amazonaws.com domínio.

    Isso está MediaTailorManifestsno exemplo da seção anterior sobre origens.

  • Política de cache: Managed-CachingOptimized

    Para obter detalhes sobre o que está incluído na política de cache CloudFront gerenciado, consulte CachingOptimizedo guia CloudFront do usuário. Você também pode usar essas mesmas configurações da política gerenciada em sua CDN de terceiros.

  • Política de solicitação de origem: Managed-CORS-S3Origin

    Para obter detalhes sobre o que está incluído na política de solicitação de origem CloudFront gerenciada, consulte CORS-S3Origin no guia do usuário. CloudFront Você também pode usar essas mesmas configurações da política gerenciada em sua CDN de terceiros.

  • Política de cabeçalhos de resposta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Para obter detalhes sobre o que está incluído na política de cabeçalhos de resposta, consulte CORS- with-preflight-and - SecurityHeadersPolicy no guia do CloudFront usuário.

Precedência 2: comportamento manifesto personalizado

Esse comportamento lida com solicitações de manifesto personalizadas. CloudFront aplica os seguintes comportamentos a todas as solicitações com um padrão de /v1/* caminho. CloudFront aplica os seguintes comportamentos e não armazena em cache manifestos personalizados porque eles contêm conteúdo de anúncio específico do espectador. URLs Esses comportamentos se aplicam a todas as solicitações que têm um padrão de /v1/* caminho. Essa é a principal MediaTailor funcionalidade em que cada espectador recebe um manifesto exclusivo com inserção de anúncios personalizados.

  • Padrão de caminho: /v1/* ( MediaTailor solicitações V1 padrão)

    Exemplo URLs que corresponde a esse padrão:

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

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

  • Origem: a origem que você criou com o manifests.mediatailor.region.amazonaws.com domínio.

    Isso está MediaTailorManifestsno exemplo da seção anterior sobre origens.

  • Política de cache: Managed-CachingDisabled

    Para obter detalhes sobre o que está incluído na política de cache, consulte CachingDisabledo guia CloudFront do usuário.

  • Política de solicitação de origem: Managed-AllViewerAndCloudFrontHeaders-2022-6

    Para obter detalhes sobre o que está incluído na política de solicitação de origem, consulte AllViewerAndCloudFrontHeaders-2022-6 no guia do CloudFront usuário.

  • Política de cabeçalhos de resposta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Para obter detalhes sobre o que está incluído na política de cabeçalhos de resposta, consulte CORS- with-preflight-and - SecurityHeadersPolicy no guia do CloudFront usuário.

Cabeçalho Accept-Encoding

Recomendamos que sua CDN preserve o Accept-Encoding cabeçalho dos visualizadores. Esse cabeçalho fornece MediaTailor instruções sobre como compactar manifestos personalizados.

Em CloudFront, a política de solicitação de AllViewerAndCloudFrontHeaders origem inclui a passagem do Accept-Encoding cabeçalho do visualizador. Se você usar uma CDN diferente, certifique-se de que ela preserve esse cabeçalho.

Veja a seguir como MediaTailor manipula o Accept-Encoding cabeçalho.

  • Dispositivos antigos: dispositivos inteligentes mais antigos TVs que não suportam gzip não enviarão o cabeçalho Accept-Encoding, portanto, retornam manifestos não compactados MediaTailor

  • Dispositivos modernos: iPhones, navegadores Chrome e outros clientes modernos enviam o cabeçalho Accept-Encoding, permitindo compactar os manifestos antes da MediaTailor entrega

Precedência 3: comportamento do caminho do beacon do lado do servidor

Esse comportamento manipula solicitações MediaTailor que resultam em redirecionamentos para. Rastreamento do lado do servidor Essas solicitações são essenciais para rastrear beacons, portanto, todas as solicitações devem ser processadas por. MediaTailor CloudFront aplica os seguintes comportamentos a todas as solicitações com um padrão de /segment/* caminho.

  • Padrão de caminho: /segment/*

    Exemplo URLs que corresponde a esse padrão:

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

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

  • Origem: a origem que você criou com o manifests.mediatailor.region.amazonaws.com domínio.

    Isso está MediaTailorManifestsno exemplo da seção anterior sobre origens.

  • Política de cache: Managed-CachingDisabled

    Para obter detalhes sobre o que está incluído na política de cache, consulte CachingDisabledo guia CloudFront do usuário.

  • Política de solicitação de origem: Managed-AllViewerAndCloudFrontHeaders-2022-6

    Para obter detalhes sobre o que está incluído na política de solicitação de origem, consulte AllViewerAndCloudFrontHeaders-2022-6 no guia do CloudFront usuário.

  • Política de cabeçalhos de resposta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Para obter detalhes sobre o que está incluído na política de cabeçalhos de resposta, consulte CORS- with-preflight-and - SecurityHeadersPolicy no guia do CloudFront usuário.

Quando MediaTailor processa essas solicitações, ele retorna uma resposta de redirecionamento 302 com um caminho que aponta para a localização real do segmento. Por exemplo, uma solicitação para /segment/ad123.ts pode redirecionar para a /tm/encoded-ad-segment.ts origem do segmento.

Precedência 4: comportamento do caminho de origem do conteúdo

Se o caminho da solicitação não corresponder a nenhum dos outros padrões, CloudFront aplica o comportamento padrão. Esse comportamento envia solicitações diretamente para a origem do conteúdo, sem processamento de MediaTailor. Isso permite acesso direto à origem do seu conteúdo (como MediaPackage V2) quando necessário. CloudFront aplica os seguintes comportamentos a todas as solicitações que não incluem nenhum dos padrões de caminho anteriores.

  • Padrão de caminho: (*)

  • Origem: a origem que você criou com o domínio da origem do seu conteúdo.

    Isso está ContentOriginno exemplo da seção anterior sobre origens.

  • Política de cache: Managed-CachingOptimized

    Para obter detalhes sobre o que está incluído na política de cache CloudFront gerenciado, consulte CachingOptimizedo guia CloudFront do usuário. Você também pode usar essas mesmas configurações da política gerenciada em sua CDN de terceiros.

    nota

    Para implementações de HLS de baixa latência, considere usar uma política de cache personalizada com diretivas HLS de baixa latência (LLH) em vez da política padrão. CachingOptimized

  • Política de solicitação de origem: configurada para transmitir cabeçalhos e parâmetros de sequência de caracteres de consulta apropriados para sua origem de conteúdo. Para obter informações sobre as políticas de solicitação de origem gerenciada disponíveis, consulte Usar políticas de solicitação de origem gerenciada no guia do desenvolvedor do CF.

  • Política de cabeçalhos de resposta: Managed-CORS-with-preflight-and-SecurityHeadersPolicy

    Embora o comportamento padrão da origem do conteúdo geralmente não enfrente os mesmos riscos de envenenamento do cache do CORS que o comportamento do segmento de anúncios, ainda é recomendável usar a política de cabeçalhos de Managed-CORS-with-preflight-and-SecurityHeadersPolicy resposta e incluir o Origin cabeçalho na sua chave de cache. Isso garante o tratamento consistente do CORS em todos os tipos de conteúdo e evita possíveis problemas de reprodução em players baseados na web.

    Para segmentos de conteúdo, a política de Managed-CachingOptimized cache fornece bom desempenho, enquanto a política de cabeçalhos de Managed-CORS-with-preflight-and-SecurityHeadersPolicy resposta garante o tratamento adequado do CORS. Essa combinação permite um armazenamento em cache eficiente, mantendo a compatibilidade com players baseados na web que exigem cabeçalhos CORS.

    A aplicação consistente do CORS em segmentos de anúncios e segmentos de conteúdo cria uma experiência de reprodução mais confiável e simplifica a solução de problemas. Sem a configuração adequada do CORS, os jogadores podem ter um comportamento inconsistente ao fazer a transição entre conteúdo e anúncios.

    Para obter detalhes sobre o que está incluído na política de cabeçalhos de resposta, consulte CORS- with-preflight-and - SecurityHeadersPolicy no guia do CloudFront usuário.