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:
Sua origem de 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. Os 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 origem`manifests.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`
Selecione as políticas de solicitação de origem com base no tipo de conteúdo para evitar o envenenamento do cache e, ao mesmo tempo, garantir a funcionalidade adequada. A principal distinção é entre conteúdo que pode ser armazenado em cache e não pode ser armazenado em cache:
+ **Manifestos (não armazenáveis em cache)**: use `AllViewer` para encaminhar todos os cabeçalhos necessários para conteúdo dinâmico. Como os manifestos não são armazenados em cache, não há risco de envenenamento do cache.
+ **Segmentos (armazenáveis em cache)**: use `None` para obter um desempenho ideal.
+ **Origens do S3**: uso `CORS-S3Origin` para buckets do Amazon S3
+ **MediaPackage origens**: uso `CORS-S3Origin` para endpoints MediaPackage V2
![\[Origins table showing ContentOrigin, MediaTailorSegments, and MediaTailorManifests with their respective details.\]](http://docs.aws.amazon.com/pt_br/mediatailor/latest/ug/images/origins-cdn.png)
## 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**: os padrões mais 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.\]](http://docs.aws.amazon.com/pt_br/mediatailor/latest/ug/images/bhv.png)
### 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á **MediaTailorSegments**no 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 [CachingOptimized](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-caching-optimized)o 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:** `None`
+ **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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) 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 [MediaTailor visão geral e implementação da inserção de anúncios guiada pelo servidor](server-guided.md) (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 `/v1/i-media/*` caminho. O SGAI permite um melhor desempenho de cache porque os manifestos não são específicos para o visualizador.
+ **Padrão de caminho:** `/v1/i-media/*` (caminho iMedia para SGAI)
Exemplo URLs que corresponde a esse padrão:
+ `https://your-distribution.cloudfront.net/v1/i-media/your-config/manifest.m3u8`
+ `https://your-distribution.cloudfront.net/v1/i-media/your-config/playlist.mpd`
+ **Origem:** a origem que você criou com o `manifests.mediatailor.region.amazonaws.com` domínio.
Isso está **MediaTailorManifests**no 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 [CachingOptimized](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-caching-optimized)o 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:** `None`
+ **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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) 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 para o 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á **MediaTailorManifests**no 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 [CachingDisabled](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-policy-caching-disabled)o guia CloudFront do usuário.
+ **Política de solicitação de origem:** `AllViewer`
Para manifestos personalizados, use a `AllViewer` política para encaminhar todos os cabeçalhos necessários para conteúdo dinâmico.
+ **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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) 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](ad-reporting-server-side.md) Essas solicitações são essenciais para rastrear beacons, portanto, cada solicitação deve ser processada 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á **MediaTailorManifests**no 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 [CachingDisabled](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-policy-caching-disabled)o guia CloudFront do usuário.
+ **Política de solicitação de origem:** `AllViewer`
Para solicitações de beacon do lado do servidor, use a `AllViewer` política para encaminhar todos os cabeçalhos necessários para o rastreamento. Como essas solicitações não são armazenadas em cache, não há risco de envenenamento do cache.
+ **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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) 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á **ContentOrigin**no 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 [CachingOptimized](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html#managed-cache-caching-optimized)o 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:** `None`
+ **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 reprodutores 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](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-response-headers-policies.html#managed-response-headers-policies-cors-preflight-security) no guia do CloudFront usuário.