Configurar rotas de serviço

O Media CDN oferece recursos avançados de roteamento HTTP que permitem mapear o tráfego para origens e configurações específicas de borda em um nível refinado.

Configurar uma regra de rota

Configure uma regra de rota para um serviço do Media CDN.

Solicitações de correspondência

Uma configuração do Media CDN contém um conjunto de rotas definidas na seção Roteamento de um recurso EdgeCacheService. Essas rotas correspondem a solicitações com base em um host (no mínimo). Para mais detalhes sobre como o tráfego é direcionado a uma origem, consulte HostRule e PathMatcher. Cada rota pode definir a própria configuração de CDN, reescritas, redirecionamentos, políticas de CORS, cabeçalhos HTTP personalizados e mapeamento de origem. As rotas podem compartilhar origens.

Por exemplo, é possível rotear solicitações de manifestos para uma origem específica e definir um TTL de cache de curta duração e uma política de armazenamento em cache negativo. As solicitações de segmentos podem ser divididas para outra origem usando cabeçalhos e parâmetros de consulta para separar tipos de manifesto ou usuários específicos.

O exemplo a seguir mostra como rotear solicitações que correspondem a um cabeçalho, parâmetro de consulta e prefixo de caminho específicos para o host media.example.com:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 10
      origin: staging-live-origin
      matchRules:
      - prefixMatch: /vod/
        headerMatches:
        - headerName: "x-staging-client"
          presentMatch: true
        queryParameterMatches:
        - name: "live"
          exactMatch: "yes"
      routeAction:
        cdnPolicy:
          defaultTtl: 5s

Correspondência de caminho

A Media CDN oferece suporte a correspondência de caminhos completa (exata), de prefixo e de caractere curinga. A correspondência de caminho pode ser combinada com a correspondência baseada em host, cabeçalho e parâmetro de consulta para criar regras de roteamento de solicitação refinadas.

Confira três maneiras de fazer a correspondência com um caminho do URL.

Para mais detalhes, consulte a especificação da API para MatchRule.

Por exemplo, para corresponder a todas as solicitações que começam com /stream/, crie uma regra de rota semelhante a esta:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    - *.vod.example.com
    pathMatcher: example_routes
  pathMatchers:
  - name: example_routes
    routeRules:
    - priority: 1
      matchRules:
      - prefixMatch: /stream/

Este exemplo inclui explicitamente a barra invertida final na regra de correspondência:

• Uma solicitação para media.example.com/stream/id/1234/hls/manifest.m3u8 corresponde a esta rota.
• Uma solicitação para media.example.com/stream-eu/id/4567/hls/manifest.m3u8 não corresponde a essa rota.

No segundo caso, o Media CDN retorna um erro HTTP 404, a menos que haja outra rota ou uma rota catch-all configurada.

Para orientações sobre como a precedência funciona em rotas com prefixos semelhantes, consulte a seção Prioridade e ordem de rotas.

Correspondência de padrões (caractere curinga)

Com a correspondência de padrão, é possível combinar várias partes de um URL, incluindo URLs parciais e sufixos (extensões de arquivo), usando uma sintaxe curinga.

Também é possível associar um ou mais segmentos de caminho a variáveis nomeadas em um campo pathTemplateMatch e, em seguida, consultar essas variáveis ao reescrever o URL em um campo pathTemplateRewrite. Isso permite reordenar e remover segmentos de URL antes que a solicitação seja enviada à sua origem.

O exemplo a seguir mostra como fazer a correspondência com dois sufixos de URL diferentes:

# EdgeCacheService.routing.pathMatchers[]
    routeRules:
    - priority: 1
      description: "Match video segments"
      matchRules:
      - pathTemplateMatch: "/**.ts"
      - pathTemplateMatch: "/**.m4s"
      origin: prod-video-storage

A sintaxe compatível inclui o seguinte.

Observações:

• Se você não estiver reescrevendo um URL, use os operadores mais simples * e **.
• Ao usar variáveis para capturar segmentos de caminho, as partes do URL que não são capturadas por uma variável não podem ser referenciadas em um pathTemplateRewrite subsequente. Por exemplo, consulte a seção Capturar variáveis de caminho.
• Não é possível se referir a variáveis em um pathTemplateRewrite subsequente que não existem no pathTemplateMatch na mesma rota.
• As variáveis diferenciam maiúsculas de minúsculas, com {FORMAT}, {forMAT} e {format} representando variáveis e valores diferentes.
• É possível especificar até 10 operadores (curingas ou variáveis) em uma correspondência. Os campos pathTemplateMatch e pathTemplateRewrite não podem exceder 255 caracteres.

Exemplo: correspondência em uma extensão de arquivo

O exemplo a seguir mostra um caso de uso comum para operadores curinga: corresponder a todos os segmentos de caminho até um sufixo.

Nesse caso, faça o seguinte:

• Busque manifestos de vídeo (playlists) que terminam em .m3u8 e .mpd na origem do manifesto, aplicando um TTL curto (5 segundos) a essas respostas porque elas mudam regularmente.
• Extraia segmentos de vídeo que terminam em .ts e .m4s da origem do segmento e aplique um TTL mais longo (um dia) a essas respostas.

Essa abordagem é usada com frequência ao usar serviços de SSAI (inserção de anúncios do lado do servidor) ou DAI (inserção de anúncios dinâmicos) e para vídeos ao vivo em que o manifesto é atualizado a cada poucos segundos.

A configuração a seguir demonstra como configurar o roteamento da Media CDN para oferecer suporte a isso:

name: prod-service
routing:
  hostRules:
  - hosts:
    - media.example.com
    pathMatcher: