Configure a CloudFront integração básica com MediaTailor - AWS Elemental MediaTailor
Pré-requisitosConfigurando a distribuição CloudFront Configurando comportamentos de cacheAtualizando a MediaTailor configuraçãoTestando sua integraçãoExemplo de configuraçãoPróximas etapas

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, consulteMediaTailor parâmetros de consulta do manifesto. Para roteamento avançado usando variáveis dinâmicas, consulteMediaTailor variáveis de domínio para várias fontes de conteúdo.

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 (consulteUsando AWS Elemental MediaTailor para inserir anúncios)

  • 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.

  2. Escolha Criar distribuição.

  3. Para o domínio Origin, insira o URL do seu MediaTailor endpoint (por exemplo,a1b2c3d4.mediatailor.us-west-2.amazonaws.com).

  4. Em Protocolo, selecione Somente HTTPS.

  5. Em Nome, insira um nome que ajude a identificar essa origem (por exemplo,mediatailor-origin).

  6. Defina as configurações padrão de comportamento do cache:

    1. Para o padrão Path, use o valor padrão (*).

    2. Em Comprimir objetos automaticamente, selecione Sim.

    3. Em Política de protocolo Viewer, selecione Redirecionar HTTP para HTTPS.

    4. Em Métodos HTTP permitidos, selecione GET, HEAD.

    5. Em Política de cache, selecione CachingDisabled.

    6. Para a política de solicitação do Origin, selecione AllViewerencaminhar 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.

  7. 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.

    2. Para AWS WAF Web ACL, selecione uma Web ACL existente ou deixe como Não habilitar proteções de segurança.

    3. Para Objeto raiz padrão, deixe em branco.

    4. Em Registro padrão, selecione Ativado para ativar o registro.

  8. 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 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.

  2. Escolha a guia Behaviors.

  3. Escolha Create behavior (Criar comportamento).

  4. Em Path pattern, insira *.m3u8 para combinar as playlists multivariantes e de mídia do HLS.

  5. Para Origin, selecione sua MediaTailor origem.

  6. Em Política de cache, selecione CachingDisabled.

  7. Para a política de solicitação do Origin, selecione AllViewerpara encaminhar todos os cabeçalhos necessários para conteúdo dinâmico.

  8. Escolha Criar.

  9. 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.

  2. Escolha a guia Behaviors.

  3. Escolha Create behavior (Criar comportamento).

  4. Em Padrão de caminho, insira /tm/* para corresponder aos segmentos de anúncios veiculados por MediaTailor.

  5. Para Origin, selecione a origem MediaTailor dos seus segmentos (usando o segments.mediatailor.region.amazonaws.com nome do host).

  6. Em Política de cache, selecione CachingOptimized.

  7. Para Política de solicitação do Origin, selecione Nenhuma.

  8. 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.

  9. 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.

  2. Escolha a guia Behaviors.

  3. Escolha Create behavior (Criar comportamento).

  4. Em Padrão de caminho, insira *.ts para corresponder aos segmentos de conteúdo HLS.

  5. Para Origin, selecione a origem do seu conteúdo.

  6. Em Política de cache, selecione CachingOptimized.

  7. Para Política de solicitação do Origin, selecione Nenhuma.

  8. 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.

  9. Escolha Criar.

  10. Repita essas etapas para outros formatos de segmento de conteúdo usando padrões de caminho apropriados:

    • *.mp4para MP4 segmentos

    • *.m4spara segmentos DASH

    • *.cmfve *.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 de MediaTailor.

  2. Selecione a configuração que você deseja atualizar.

  3. 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.

  4. 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).

  2. Verifique se o manifesto contém segmentos URLs que apontam para seu CloudFront domínio.

  3. 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.

  4. 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:

exemplo 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: