Configura le route di servizio

Media CDN offre funzionalità avanzate di routing HTTP che consentono di mappare il traffico a origini e configurazioni perimetrale specifiche a un livello granulare.

Configurare una regola di route

Configura una regola di route per un servizio Media CDN.

Richieste con corrispondenza

Una configurazione di Media CDN contiene un insieme di route definiti nella sezione Routing per una risorsa EdgeCacheService. Queste route corrispondono alle richieste in base ad almeno un host. Per maggiori dettagli su come il traffico viene indirizzato a un'origine, vedi HostRule e PathMatcher. Ogni route è in grado di definire la propria configurazione CDN, riscritture, reindirizzamenti, norme CORS, intestazioni HTTP personalizzate e mapping delle origini. Le route possono condividere le origini.

Ad esempio, puoi instradare le richieste di manifest a un'origine specifica e definire un TTL della cache di breve durata e una policy di memorizzazione nella cache negativa. Le richieste di segmenti possono essere suddivise in un'altra origine utilizzando intestazioni e parametri di query per separare tipi di manifest o utenti specifici.

L'esempio seguente mostra come instradare le richieste che corrispondono a un'intestazione, un parametro di query e un prefisso del percorso specifici per l'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

Corrispondenza percorso

Media CDN supporta la corrispondenza esatta, del prefisso e con caratteri jolly del percorso. La corrispondenza del percorso può essere combinata con la corrispondenza basata su host, intestazione e parametri di query per creare regole di routing delle richieste granulari.

Di seguito sono riportati tre modi per trovare la corrispondenza con un percorso dell'URL.

Per ulteriori dettagli, consulta la specifica dell'API per MatchRule.

Ad esempio, per trovare corrispondenze per tutte le richieste che iniziano con /stream/, crea una regola di routing simile alla seguente:

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/

Questo esempio include esplicitamente la barra finale nella regola di corrispondenza:

• Una richiesta a media.example.com/stream/id/1234/hls/manifest.m3u8 corrisponde a questo percorso.
• Una richiesta a media.example.com/stream-eu/id/4567/hls/manifest.m3u8 non corrisponde a questo percorso.

Nel secondo caso, Media CDN restituisce un errore HTTP 404, a meno che non sia stata configurata un'altra route o una route catch-all.

Per indicazioni su come funziona la precedenza per le route con prefissi simili, consulta la sezione Ordinamento e priorità route.

Corrispondenza di pattern (caratteri jolly)

La corrispondenza dei pattern consente di abbinare più parti di un URL, compresi gli URL parziali e i suffissi (estensioni dei file), utilizzando la sintassi con caratteri jolly.

Puoi anche associare uno o più segmenti di percorso a variabili denominate in un campo pathTemplateMatch e poi fare riferimento a queste variabili quando riscrivi l'URL in un campo pathTemplateRewrite. In questo modo puoi riordinare e rimuovere i segmenti URL prima che la richiesta venga inviata all'origine.

Il seguente esempio mostra come puoi trovare corrispondenze con due suffissi URL diversi:

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

La sintassi supportata include quanto segue.

Note:

• Se non riscrivi un URL, utilizza gli operatori più semplici * e **.
• Quando utilizzi le variabili per acquisire segmenti di percorso, non è possibile fare riferimento a parti dell'URL non acquisite da una variabile in un pathTemplateRewrite successivo. Per un esempio, consulta la sezione Acquisizione delle variabili di percorso.
• Non puoi fare riferimento a variabili in un pathTemplateRewrite successivo che non esistono nel pathTemplateMatch sulla stessa route.
• Le variabili sono sensibili alle maiuscole, con {FORMAT}, {forMAT} e {format} che rappresentano variabili e valori diversi.
• Puoi specificare fino a 10 operatori (caratteri jolly o variabili) in una corrispondenza. I campi pathTemplateMatch e pathTemplateRewrite non devono superare i 255 caratteri.

Esempio: corrispondenza in base a un'estensione di file

L'esempio seguente mostra un caso d'uso comune per gli operatori jolly: la corrispondenza di tutti i segmenti di percorso fino a un suffisso.

In questo caso, segui questi passaggi:

• Recupera i manifest dei video (playlist) che terminano con .m3u8 e .mpd dall'origine del manifest, applicando un TTL breve (5 secondi) a queste risposte perché cambiano regolarmente.
• Recupera i segmenti video che terminano con .ts e .m4s dall'origine del segmento e applica un TTL più lungo (1 giorno) a queste risposte.

Questo approccio viene spesso utilizzato quando si utilizzano servizi SSAI (inserimento di annunci lato server) o DAI (inserimento di annunci dinamici) e per i video in diretta in cui il manifest viene aggiornato ogni pochi secondi.

La seguente configurazione mostra come configurare il routing di Media CDN per supportare questa operazione:

name: prod-service
routing:
  hostRules:
  - hosts:
    -