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á.
# Configure a CloudFront integração básica com MediaTailor
AWS Elemental MediaTailor a integração com CloudFront a Amazon melhora o desempenho da entrega de conteúdo para seus espectadores. Este tópico orienta você na configuração de uma CloudFront distribuição básica para MediaTailor. Com essa integração, seus espectadores podem acessar conteúdo personalizado pela CloudFront rede. Você também aprenderá a configurar o armazenamento em cache adequado para diferentes tipos de conteúdo.
Para obter informações sobre como transmitir parâmetros de consulta CloudFront para autorização e roteamento, consulte[MediaTailor parâmetros de consulta do manifesto](manifest-query-parameters.md). Para roteamento avançado usando variáveis dinâmicas, consulte[MediaTailor variáveis de domínio para várias fontes de conteúdo](variables-domains.md).
## Pré-requisitos
Antes de configurar CloudFront com MediaTailor, verifique se você tem o seguinte:
+ Uma AWS conta ativa com permissões para criar e gerenciar CloudFront distribuições
+ Uma configuração de MediaTailor reprodução configurada (consulte[Usando AWS Elemental MediaTailor para inserir anúncios](configurations.md))
+ Seu servidor de origem de conteúdo devidamente configurado e acessível
+ Compreensão básica dos conceitos de streaming de vídeo (HLS/DASH)
## Configurando a distribuição CloudFront
Siga estas etapas para criar e configurar uma CloudFront distribuição para MediaTailor:
**Para criar uma CloudFront distribuição para MediaTailor**
1. Faça login no AWS Management Console e abra o CloudFront console em [https://console.aws.amazon.com/cloudfront/v3/home](https://console.aws.amazon.com/cloudfront/v3/home).
1. Escolha **Criar distribuição**.
1. Para o **domínio Origin**, insira o URL do seu MediaTailor endpoint (por exemplo,`a1b2c3d4.mediatailor.us-west-2.amazonaws.com`).
1. Em **Protocolo**, selecione **Somente HTTPS**.
1. Em **Nome**, insira um nome que ajude a identificar essa origem (por exemplo,`mediatailor-origin`).
1. Defina as configurações padrão de comportamento do cache:
1. Para **o padrão Path**, use o valor padrão (`*`).
1. Em **Comprimir objetos automaticamente**, selecione **Sim**.
1. Em **Política de protocolo Viewer**, selecione **Redirecionar HTTP para HTTPS**.
1. Em **Métodos HTTP permitidos**, selecione **GET, HEAD**.
1. Em **Política de cache**, selecione **CachingDisabled**.
1. Para a **política de solicitação do Origin**, selecione **AllViewer**encaminhar todos os cabeçalhos para o comportamento padrão.
**nota**
O comportamento padrão é usado AllViewer para lidar com segurança com qualquer conteúdo que não corresponda aos padrões de caminho específicos. Comportamentos de cache específicos para manifestos e segmentos serão configurados separadamente com as políticas apropriadas.
1. Defina as configurações de distribuição:
1. Para **Classe de preço**, selecione a opção que melhor corresponda às localizações do seu público.
1. Para **AWS WAF Web ACL**, selecione uma Web ACL existente ou deixe como **Não habilitar proteções de segurança**.
1. Para **Objeto raiz padrão**, deixe em branco.
1. Em **Registro padrão**, selecione **Ativado** para ativar o registro.
1. Escolha **Criar distribuição**.
## Configurando comportamentos de cache
Depois de criar sua distribuição, você precisa configurar comportamentos adicionais de cache para lidar com diferentes tipos de conteúdo de forma adequada. Esta seção aborda a configuração básica do comportamento do cache para CloudFront.
Para uma otimização abrangente do cache, incluindo configurações avançadas de TTL, configurações de chave de cache e ajuste de desempenho, consulte [Otimização de cache para CDN e integrações MediaTailor](cdn-optimize-caching.md) o guia de otimização da CDN.
### Configurando o comportamento do cache do manifesto
Não armazene manifestos em cache porque eles contêm conteúdo personalizado. Siga estas etapas para configurar o comportamento do cache:
**Para configurar o comportamento do cache do manifesto**
1. No CloudFront console, selecione sua distribuição.
1. Escolha a guia **Behaviors**.
1. Escolha **Create behavior** (Criar comportamento).
1. Em **Path pattern**, insira `*.m3u8` para combinar as playlists multivariantes e de mídia do HLS.
1. Para **Origin**, selecione sua MediaTailor origem.
1. Em **Política de cache**, selecione **CachingDisabled**.
1. Para a **política de solicitação do Origin**, selecione **AllViewer**para encaminhar todos os cabeçalhos necessários para conteúdo dinâmico.
1. Escolha **Criar**.
1. Repita essas etapas para manifestos do DASH usando o padrão de caminho correspondente`*.mpd`. MPDs
Essa configuração garante que cada espectador receba um manifesto personalizado com o conteúdo específico do anúncio. A CDN não armazena esses manifestos em cache, então cada solicitação vai diretamente para. MediaTailor
### Configurando o comportamento do cache de segmentos
Configure comportamentos de cache separados para segmentos de anúncios e segmentos de conteúdo para otimizar o desempenho e garantir o tratamento adequado do CORS.
#### Configurando o comportamento do cache do segmento de anúncios
Os segmentos de anúncios veiculados por meio do padrão de `/tm/*` caminho exigem uma configuração específica para lidar com o CORS adequadamente. Siga estas etapas:
**Para configurar o comportamento do cache do segmento de anúncios**
1. No CloudFront console, selecione sua distribuição.
1. Escolha a guia **Behaviors**.
1. Escolha **Create behavior** (Criar comportamento).
1. Em **Padrão de caminho**, insira `/tm/*` para corresponder aos segmentos de anúncios veiculados por MediaTailor.
1. Para **Origin**, selecione a origem MediaTailor dos seus segmentos (usando o `segments.mediatailor.region.amazonaws.com` nome do host).
1. Em **Política de cache**, selecione **CachingOptimized**.
1. Para **Política de solicitação do Origin**, selecione **Nenhuma**.
1. Para a **política de cabeçalhos de resposta**, selecione **CORS- with-preflight-and - SecurityHeadersPolicy** para garantir que os cabeçalhos CORS adequados sejam incluídos nas respostas.
1. Escolha **Criar**.
#### Configurando o comportamento do cache do segmento de conteúdo
Os segmentos de conteúdo podem usar políticas de armazenamento em cache padrão para um desempenho ideal. Configure comportamentos separados para diferentes formatos de segmento:
**Para configurar o comportamento do cache do segmento de conteúdo**
1. No CloudFront console, selecione sua distribuição.
1. Escolha a guia **Behaviors**.
1. Escolha **Create behavior** (Criar comportamento).
1. Em **Padrão de caminho**, insira `*.ts` para corresponder aos segmentos de conteúdo HLS.
1. Para **Origin**, selecione a origem do seu conteúdo.
1. Em **Política de cache**, selecione **CachingOptimized**.
1. Para **Política de solicitação do Origin**, selecione **Nenhuma**.
1. Para a **política de cabeçalhos de resposta**, selecione **CORS- with-preflight-and - SecurityHeadersPolicy** para garantir o tratamento consistente do CORS em todos os tipos de conteúdo.
1. Escolha **Criar**.
1. Repita essas etapas para outros formatos de segmento de conteúdo usando padrões de caminho apropriados:
+ `*.mp4`para MP4 segmentos
+ `*.m4s`para segmentos DASH
+ `*.cmfv`e `*.cmfa` para segmentos CMAF
Essa configuração garante que os segmentos de anúncios e segmentos de conteúdo sejam armazenados em cache adequadamente com o tratamento adequado do CORS. Os segmentos de anúncios usam a origem dos MediaTailor segmentos com proteção CORS, enquanto os segmentos de conteúdo usam sua origem de conteúdo com políticas de armazenamento em cache otimizadas.
## Atualizando a MediaTailor configuração
Depois de configurar sua CloudFront distribuição, atualize sua MediaTailor configuração para usar o CloudFront domínio:
**Para atualizar sua MediaTailor configuração**
1. Abra o [console do MediaTailor](https://console.aws.amazon.com/mediatailor/home).
1. Selecione a configuração que você deseja atualizar.
1. Na seção **Configuração da CDN**, insira seu nome de domínio CloudFront de distribuição (por exemplo,`d1234abcdef.cloudfront.net`) no campo de **prefixo do segmento de conteúdo da CDN**.
1. Salve as alterações.
Com essa configuração, MediaTailor gera manifestos com URLs esse ponto para sua CloudFront distribuição em vez de diretamente para a origem.
## Testando sua integração
Depois de configurar sua CloudFront distribuição e atualizar sua MediaTailor configuração, teste a integração:
**Para testar sua CloudFront MediaTailor integração**
1. Solicite um manifesto por meio CloudFront de sua distribuição (por exemplo,`https://d1234abcdef.cloudfront.net/v1/master/12345/my-config/index.m3u8`).
1. Verifique se o manifesto contém segmentos URLs que apontam para seu CloudFront domínio.
1. Reproduza o conteúdo por meio de um player de vídeo e verifique se o conteúdo e os anúncios são reproduzidos corretamente.
1. Verifique CloudFront os registros para garantir que as solicitações estejam sendo roteadas corretamente.
## Exemplo de configuração
Aqui está um exemplo de uma configuração de CloudFront distribuição MediaTailor com comportamentos de cache adequados:
**Example CloudFront exemplo de configuração de distribuição**
```
{
"DefaultCacheBehavior": {
"TargetOriginId": "mediatailor-origin",
"ViewerProtocolPolicy": "redirect-to-https",
"AllowedMethods": {
"Quantity": 2,
"Items": ["GET", "HEAD"]
},
"CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
"OriginRequestPolicyId": "59781a5b-3903-41f3-afcb-af62929ccde1",
"Comment": "Default behavior with CachingDisabled and AllViewer"
},
"CacheBehaviors": [
{
"PathPattern": "*.m3u8",
"TargetOriginId": "mediatailor-origin",
"ViewerProtocolPolicy": "redirect-to-https",
"CachePolicyId": "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
"OriginRequestPolicyId": "59781a5b-3903-41f3-afcb-af62929ccde1",
"Comment": "Manifest behavior with CachingDisabled and AllViewer"
},
{
"PathPattern": "*.ts",
"TargetOriginId": "mediatailor-origin",
"ViewerProtocolPolicy": "redirect-to-https",
"CachePolicyId": "658327ea-f89d-4fab-a63d-7e88639e58f6",
"OriginRequestPolicyId": "88a5eaf4-2fd4-4709-b370-b4c650ea3fcf",
"Comment": "Segment behavior with CachingOptimized and HostHeaderOnly"
}
]
}
```
Esse exemplo mostra:
+ **Comportamento padrão**: usa `CachingDisabled` e `AllViewer` para lidar com segurança com qualquer conteúdo que não corresponda a padrões de caminho específicos
+ **Comportamento manifesto (\*.m3u8)**: usos e para conteúdo dinâmico `CachingDisabled` `AllViewer`
+ **Comportamento do segmento (\*.ts): usos** e `CachingOptimized` `CORS-with-preflight-and-SecurityHeadersPolicy`
## Próximas etapas
Depois de configurar sua CloudFront integração básica com MediaTailor, considere estas próximas etapas:
+ Otimize o desempenho com CloudFront recursos adicionais (consulte[Otimizando o MediaTailor desempenho com recursos CloudFront](cloudfront-performance-optimization.md))
+ Implemente resiliência multirregional com o MQAR (consulte) [Implemente resiliência multirregional com o MQAR MediaTailor](media-quality-resiliency.md)
+ Configure o monitoramento e a solução de problemas (consulte[Monitore e solucione problemas de sua CloudFront integração MediaTailor](monitoring-and-troubleshooting.md))