Media CDN fournit des fonctionnalités de routage HTTP avancées qui vous permettent de mapper avec précision le trafic vers des configurations et origines de périphérie spécifiques.
Mise en correspondance des requêtes
Une configuration Media CDN contient un ensemble de routes définies dans le
Routage
pour une
EdgeCacheService
ressource.
Ces routes correspondent aux requêtes en fonction (au moins) d'un hôte. Pour en savoir plus sur la façon dont le trafic est dirigé vers une origine, consultez HostRule
et PathMatcher
.
Chaque route peut définir sa propre configuration CDN, réécrire, rediriger,
Règles CORS, en-têtes HTTP personnalisés et mappage de l'origine
Les routes peuvent partager des origines.
Par exemple, vous pouvez acheminer les requêtes de fichiers manifestes vers une origine spécifique définissez une valeur TTL de courte durée et un règle de mise en cache négative. Les requêtes portant sur des segments peuvent être réparties vers une autre origine en utilisant des en-têtes et des paramètres de requête pour répartir des types de fichier manifeste ou des utilisateurs spécifiques.
L'exemple suivant montre comment acheminer les requêtes correspondant à un en-tête spécifique,
paramètre de requête et préfixe de chemin d'accès pour l'hôte 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
Mise en correspondance des chemins d'accès
Media CDN est compatible avec la mise en correspondance complète (exacte), de préfixe et de chemin d'accès générique. La correspondance de chemin d'accès peut être combinée avec la correspondance basée sur l'hôte, l'en-tête et les paramètres de requête afin de créer des règles de routage de requêtes précises.
Voici trois méthodes pour mettre en correspondance un chemin d'URL.
Champ | Description | Exemple |
---|---|---|
matchRules[].fullPathMatch
|
La condition fullPathMatch est mise en correspondance avec le chemin d'URL complet, qui n'inclut pas la chaîne de requête. Vous devez spécifier les barres obliques finales, le cas échéant.
|
Une route avec une règle de correspondance de Une |
matchRules[].prefixMatch
|
La condition prefixMatch est mise en correspondance avec le préfixe de chemin d'URL. Les URL commençant par la même chaîne sont mises en correspondance.
|
Une route avec une règle de correspondance de |
matchRules[].pathTemplateMatch
|
La condition pathTemplateMatch accepte les opérateurs génériques qui vous permettent de mettre en correspondance des formats d'URL complexes et des segments de chemin d'accès, mais aussi de capturer des variables nommées pour réécrire des URL.
|
Une route avec une règle de correspondance de
Pour plus d'exemples, consultez la section Mise en correspondance de schémas. |
Pour en savoir plus, consultez la spécification de l'API pour MatchRule
.
Par exemple, pour mettre en correspondance toutes les requêtes commençant par /stream/
, créez une règle de routage semblable à celle-ci :
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/
Cet exemple inclut explicitement la barre oblique finale dans la règle de correspondance :
- Une requête envoyée à
media.example.com/stream/id/1234/hls/manifest.m3u8
est mise en correspondance avec cette route. - Une requête adressée à
media.example.com/stream-eu/id/4567/hls/manifest.m3u8
n'est pas mise en correspondance avec cette route.
Dans le deuxième cas, Media CDN renvoie une erreur HTTP 404
, à moins qu'une autre route ou une route collecteur ne soit configurée.
Pour plus d'informations sur le fonctionnement de la priorité pour les routes avec des préfixes similaires, consultez la section Priorité et ordre des routes.
Correspondance de schémas (caractère générique)
La correspondance de format vous permet de faire correspondre plusieurs parties d'une URL, y compris des URL partielles. et les suffixes (extensions de fichier), en utilisant une syntaxe générique.
Vous pouvez également associer un ou plusieurs composants de chemin d'accès à des variables nommées dans un champ pathTemplateMatch
, puis faire référence à ces variables lors de la réécriture de l'URL dans un champ pathTemplateRewrite
. Cela vous permet de réorganiser et de supprimer les composants d'URL avant que la requête ne soit envoyée à votre origine.
L'exemple suivant montre comment mettre en correspondance deux suffixes d'URL différents :
# EdgeCacheService.routing.pathMatchers[] routeRules: - priority: 1 description: "Match video segments" matchRules: - pathTemplateMatch: "/**.ts" - pathTemplateMatch: "/**.m4s" origin: prod-video-storage
La syntaxe acceptée inclut les éléments suivants.
Opérateur | Correspondance établie | Exemple |
---|---|---|
*
|
Correspond à un seul composant de chemin d'accès, jusqu'au séparateur de chemin suivant : /
|
/videos/*/*/*.m4s correspond à /videos/123414/hls/1080p5000_00001.m4s . |
**
|
Correspond à zéro segments de chemin ou plus. S'il est présent, il doit s'agir du dernier opérateur. | /**.mpd correspond à /content/123/india/dash/55/manifest.mpd . |
{name} or {name=*}
|
Une variable nommée correspondant à un segment de chemin d'accès.
Correspond à un seul composant de chemin, jusqu'au séparateur de chemin suivant : |
/content/{format}/{lang}/{id}/{file}.vtt correspond à /content/hls/en-us/12345/en_193913.vtt et capture format="hls" , lang="en-us" , id="12345" et file="en_193913" en tant que variables.
|
{name=videos/*}
|
Une variable nommée correspondant à plusieurs segments de chemin. Le composant de chemin d'accès correspondant à videos/* est capturé en tant que variable nommée.
|
/videos/{language=lang/*}/* correspond à /videos/lang/en/video.m4s et renseigne la variable de chemin d'accès language avec la valeur lang/en .
|
{name=**}
|
Une variable nommée correspondant à zéro segments de chemin ou plus. S'il est présent, il doit s'agir du dernier opérateur. |
|
Remarques :
- Si vous ne réécrivez pas une URL, utilisez les opérateurs plus simples
*
et**
. - Lorsque vous utilisez des variables pour capturer des composants de chemin, toute partie de l'URL qui
qui ne sont pas capturées par une variable ne peuvent pas être référencées dans un
pathTemplateRewrite
Pour obtenir un exemple, consultez la section Capturer des variables de chemin d'accès. - Vous ne pouvez pas faire référence à des variables dans un
pathTemplateRewrite
ultérieur qui n'existent pas dans lepathTemplateMatch
sur le même itinéraire. - Les variables sont sensibles à la casse.
{FORMAT}
,{forMAT}
et{format}
représentent différentes variables et valeurs. - Vous pouvez spécifier jusqu'à 10 opérateurs (caractères génériques ou variables) dans une correspondance.
Les champs
pathTemplateMatch
etpathTemplateRewrite
ne doivent pas dépasser 255 caractères.
Exemple : Correspondance avec une extension de fichier
L'exemple suivant montre un cas d'utilisation courant des opérateurs génériques, à savoir la mise en correspondance de tous les composants de chemin jusqu'à un suffixe.
Dans ce cas, vous effectuez les opérations suivantes :
- Récupérer les fichiers manifestes de vidéo (listes de lecture) qui se terminent par
.m3u8
et.mpd
à partir de leur origine, en appliquant une valeur TTL courte (5 secondes) à ces réponses car elles changent régulièrement. - Extraire les séquences vidéo se terminant par
.ts
et.m4s
à partir de l'origine du segment, puis appliquer une valeur TTL plus longue (1 jour) à ces réponses.
Cette approche est souvent utilisée lors de l'utilisation de services SSAI (injection d'annonce côté serveur) ou DAI (insertion dynamique d'annonce) ainsi que pour les flux vidéo en direct lorsque le fichier manifeste est mis à jour avec un intervalle de quelques secondes.
La configuration suivante montre comment configurer le routage Media CDN pour assurer cette compatibilité :
name: prod-service routing: hostRules: - hosts: - media.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: # the first route only matches video manifests - priority: 1 matchRules: - pathTemplateMatch: "/**.m3u8" # "**" matches all path segments - pathTemplateMatch: "/**.mpd" origin: manifest-origin routeAction: cdnPolicy: cacheMode: FORCE_CACHE_ALL defaultTtl: 5s # the second route matches video segments, fetches them # from a separate origin server, caching them for a longer # duration (1 day). - priority: 2 matchRules: - pathTemplateMatch: "/**.ts" - pathTemplateMatch: "/**.m4s" origin: segment-origin routeAction: cdnPolicy: cacheMode: FORCE_CACHE_ALL defaultTtl: 86400s
Exemple : Capturer des variales de chemin d'accès
L'exemple suivant montre comment utiliser des variables nommées pour décrire un ou plusieurs composants de chemin d'accès.
Ces variables peuvent être utilisées dans un pathTemplateRewrite
pour réécrire le chemin d'accès avant l'envoi de la requête vers l'origine ou pour effectuer une autodescription pathTemplateMatch
complexe.
routing: hostRules: - hosts: - media.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 1 matchRules: # Matches a request of "/us/en/hls/123139139/segments/00001.ts" - pathTemplateMatch: "/{country}/{lang}/{format}/{id}/{file=**}" origin: my-origin routeAction: urlRewrite: # Rewrites to "/123139139/hls/segments/00001.ts" pathTemplateRewrite: "/{id}/{format}/{file}"
À savoir :
- Chaque variable
{name}
capture un seul segment de chemin d'accès. Un segment de chemin d'accès correspond à tous les caractères entre une paire de/
(barre obliques) dans un chemin d'URL. - Une variable
{name=**}
capture tous les segments de chemin restants. Dans ce cas, elle est mise en correspondance à la fois avecsegments/00001.ts
et avecmaster.m3u8
. - Dans la section
pathTemplateRewrite
sur la même route, vous faites référence à certaines des variables que vous avez capturées dans lepathTemplateMatch
. Vous omettez explicitement les variables{country}
et{lang}
, car elles ne correspondent pas à la structure de répertoires de l'origine.
Dans cet exemple, les événements suivants se produisent :
- Une URL de requête entrante de
/us/en/hls/123139139/segment_00001.ts
est mise en correspondance avecpathTemplateMatch
et est réécrite en/123139139/hls/segment_00001.ts
avant d'être envoyée à l'origine. - Une URL de requête entrante de
/us/123139139/master.m3u8
n'est pas mise en correspondance avecpathTemplateMatch
et reçoit une réponse HTTP404 (Not Found)
. - Une URL de requête entrante de
/br/es/dash/c966cbbe6ae3/subtitle_00001.vtt
est également mise en correspondance avecpathTemplateMatch
et est réécrite en/c966cbbe6ae3/dash/subtitle_00001.vtt
avant d'être envoyée à l'origine.
Pour en savoir plus sur l'interaction de la mise en correspondance des caractères génériques avec la réécriture d'URL, consultez la section Réécritures.
Mise en correspondance des hôtes
Chaque service peut être mis en correspondance avec plusieurs noms d'hôte, chaque ensemble de noms d'hôte contenant son propre groupe de routes (que l'on appelle outils de mise en correspondance des chemins d'accès). Dans le cas le plus courant, tous les noms d'hôte d'un service sont mappés sur un même ensemble de routes partagées avec une seule liste d'hôtes et un seul outil de mise en correspondance des chemins d'accès.
name: prod-service routing: hostRules: - hosts: - media.example.com - *.vod.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: # list of routes for the configured hosts - priority: 999 matchRules: - prefixMatch: / origin: DEFAULT_ORIGIN
Les hôtes qui ne correspondent pas reçoivent une page HTTP 404
par défaut. Pour accepter n'importe quel hôte, vous pouvez inclure le caractère générique *
en tant qu'entrée hostRules[].hosts[]
.
Vous pouvez également définir des groupes de routes (par exemple, pour un regroupement par pays ou pour regrouper les routes de diffusion en direct ou à la demande). Comme chaque service dispose d'une seule règle de sécurité, nous vous recommandons généralement d'avoir un service pour chaque marché (zone géographique) ou charge de travail.
Remarques :
- Les en-têtes d'hôte (ou HTTP/2
:authority
) contenant un port sont implicitement mis en correspondance avec un hôte configuré. Vous n'avez pas besoin de spécifier explicitement . - Si la requête est effectuée via HTTP, une entrée
hostRules[].hosts[]
avec une valeur de*.vod.example.com
est mise en correspondance avecus.vod.example.com
etus.vod.example.com:80
. - Si la requête est de type HTTPS (TLS), une entrée
hostRules[].hosts[]
avec une valeur de*.vod.example.com
est mise en correspondance avecus.vod.example.com:443
.
Pour en savoir plus, consultez la spécification de l'API pour HostRule
.
Mise en correspondance des en-têtes et des paramètres de requête
Vous pouvez configurer des routes pour qu'elles soient mises en correspondance avec des noms d'en-tête et des paramètres de requête spécifiques, ainsi qu'avec la présence d'une valeur d'en-tête (préfixe, suffixe ou correspondance exacte).
La mise en correspondance des en-têtes et des paramètres de requête utilise un opérateur logique "AND". La requête doit correspondre à tous les paramètres de requête et à toutes les clés d'en-tête (et valeurs, le cas échéant) être mises en correspondance avec la route donnée.
Par exemple, si vous souhaitez acheminer les requêtes avec un nom de champ d'en-tête et une valeur d'en-tête spécifiques vers une origine nommée alternate-origin
, configurez vos conditions de mise en correspondance dans routeRules[].matchRules[].headerMatches[]
:
name: prod-service routing: hostRules: - hosts: - media.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 1 origin: alternate-origin matchRules: - prefixMatch: "/videos/" headerMatches: - headerName: "x-device-name" exactMatch: "roku"
Dans cet exemple, les requêtes contenant /videos/
au début de l'URL et l'en-tête x-device-name: roku
seront mises en correspondance avec cette route. Les requêtes ne comportant pas ce nom d'en-tête ou une valeur différente ne seront pas mises en correspondance.
Pour en savoir plus, consultez les spécifications de l'API pour
HeaderMatch
De même, pour la mise en correspondance avec des paramètres de requête, spécifiez une ou plusieurs valeurs queryParameterMatches
comme suit :
name: prod-service routing: hostRules: - hosts: - media.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 1 origin: eu-live-origin-prod matchRules: - prefixMatch: "/videos/" queryParameterMatches: - name: "playback_type" exactMatch: "live" - name: "geo" exactMatch: "eu"
Dans cet exemple, une requête client https://cdn.example.com/videos/1234/abcd/xyz.m3u8?playback_type=live&geo=eu
est mise en correspondance avec cette route.
Pour en savoir plus, consultez les spécifications de l'API pour
QueryParameterMatcher
Définir une route collecteur (par défaut)
Par défaut, Media CDN renvoie une erreur HTTP 404 (Not Found)
si une requête ne correspond à aucune route configurée.
Pour configurer une route collecteur pour un pathMatcher
(collection de routes) donné, procédez comme suit :
- Créez une
routeRule
avec la priorité la plus faible (nombre plus élevé), par exemple 999, qui est la priorité de route la plus faible possible. - Configurez une
matchRule
avec une correspondance de préfixe de/
(correspondance avec tous les chemins de requête). - Configurez une
origin
ou uneurlRedirect
(un seul de ces éléments) sur la route.
Par exemple, pour configurer une route collecteur qui dirige toutes les requêtes sans correspondance vers une origine par défaut nommée my-origin
, créez une route avec la valeur priority: 999
et avec une matchRules[].prefixMatch
définie sur /
comme suit :
name: prod-service routing: hostRules: - hosts: - cdn.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 999 origin: my-origin matchRules: - prefixMatch: /
Vous pouvez éventuellement réécrire l'URL avant la récupération de l'origine, ou rediriger vers une page par défaut (par exemple, votre page de destination) plutôt que d'envoyer la requête "en l'état" à l'origine.
Priorité et ordre des routes
Chaque route d'un tableau de routeRules[]
doit être associée à une valeur de priority
.
Les routes plus spécifiques doivent être définies avec une priorité plus élevée (nombre plus petit). Une route correspondant au préfixe /stream/
avec une priorité de 1 empêche une route plus spécifique correspondant au préfixe /stream/live/eu/
avec une priorité de 5 d'être mise en correspondance avec des requêtes.
- La priorité de route la plus élevée est "1", et la plus faible est "999".
- Vous ne pouvez pas configurer plusieurs règles de routage avec la même priorité. La priorité de chaque règle doit être définie sur un nombre compris entre 1 et 999 (inclus).
- La définition d'une route "catch-all" vous permet d'envoyer les requêtes qui ne correspondent pas à une origine ou à une redirection par défaut vers une page de destination ou un point de terminaison.
Dans l'exemple suivant, vous pouvez constater que la route /live/us/
ne serait jamais mise en correspondance car la route /live/
a une priorité plus élevée :
routeRules: - priority: 1 description: "Live routes" matchRules: - prefixMatch: /live/ routeAction: cdnPolicy: defaultTtl: 5s - priority: 2 description: "U.S based live streams" matchRules: # This would never be matched, as the /live/ prefixMatch at priority 1 # would always take precedence. - prefixMatch: /live/us/ routeAction: cdnPolicy: defaultTtl: 5s - priority: 999 description: "Catch-all route" matchRules: - prefixMatch: /
Pour résoudre ce problème, définissez la route la plus spécifique (la plus longue) sur un niveau de priorité plus élevé :
routeRules: - priority: 1 description: "U.S based live streams" matchRules: # The more specific (longer) match is at a higher priority, and now # matches requests as expected. - prefixMatch: /live/us/ routeAction: cdnPolicy: defaultTtl: 5s - priority: 2 description: "Live routes" matchRules: - prefixMatch: /live/ routeAction: cdnPolicy: defaultTtl: 5s - priority: 999 description: "Catch-all route" matchRules: - prefixMatch: /
Cela permet à la route plus spécifique d'être correctement mise en correspondance avec les requêtes. Une requête avec le préfixe /live/eu/
est toujours acheminée vers la route /live/
dont la priorité est de 2.
Filtrage des méthodes
Par défaut, les proxys Media CDN ne servent que GET
, HEAD
et OPTIONS
à votre origine et filtre celles pouvant la modifier.
Dans Preview, vous pouvez remplacer cette valeur par défaut
le comportement d'une règle de routage spécifique en spécifiant les méthodes
par proxy à votre origine. En plus de GET
, HEAD
et OPTIONS
,
Media CDN est compatible avec PUT
, POST
, DELETE
et PATCH
.
Pour configurer la prise en charge d'un ensemble de méthodes pour une règle de routage, spécifiez un
Section routeMethods
ayant une valeur allowed_methods
pour chaque méthode
routeRules: - priority: 5 description: "Video uploads" routeMethods: allowedMethods: ["PUT", "POST", "OPTIONS"] matchRules: - pathTemplateMatch: "/uploads/**.ts" origin: prod-video-storage - priority: 10 description: "Video serving" routeMethods: allowedMethods: ["GET", "HEAD"] matchRules: - pathTemplateMatch: "/videos/**.ts" origin: prod-video-storage
En version Preview, Media CDN permet de mettre à jour et d'afficher cette configuration à l'aide de l'API Network Services v1alpha1.
Vous pouvez également utiliser la commande gcloud alpha edge-cache services export
et la commande gcloud alpha edge-cache services import
pour mettre à jour les fichiers YAML de configuration de service.
Normalisation des chemins d'accès
La normalisation des chemins d'accès décrit comment Media CDN combine plusieurs représentations d'une URL en une seule représentation canonique dans des scénarios spécifiques.
La normalisation des chemins d'accès peut améliorer directement les taux de succès de mise en cache en réduisant le nombre d'URL de requête représentant le même contenu, et en limitant les erreurs d'origine pour les origines qui attendent des chemins normalisés.
Les requêtes entrantes sont normalisées comme suit :
- Plusieurs barres obliques consécutives sont fusionnées en une seule. Par exemple, un chemin d'URL de
/videos///12345/manifest.mpd
est normalisé en/videos/12345/manifest.mpd
. - Les segments de chemin d'accès sont normalisés conformément à la section 6.2.2.3 du document RFC 3986.
Par exemple, le chemin d'accès
/a/b/c/./../../g
est normalisé en/a/g
sur la base de l'algorithme Supprimer les segments à point défini dans la RFC 3986. Cette normalisation se produit avant de vérifier le cache ou de transférer la requête à l'origine. - Les requêtes ne sont pas normalisées en encodage-pourcent. Par exemple, une URL avec une barre oblique en encodage-pourcent (
%2F
) n'est pas décodée dans sa forme non encodée.
Les URL restent sensibles à la casse et ne sont pas normalisées en termes de casse. De nombreuses URL contiennent des encodages en base64 sensibles à la casse, y compris les URL avec des jetons de requête signée.
Réécritures et redirections
Les sections suivantes fournissent des exemples sur la réécriture des requêtes et la configuration des redirections.
Réécrire les URL de requête
Media CDN est compatible avec les réécritures d'hôtes et de chemins d'accès. Les réécritures modifient l'URL envoyée à l'origine et vous permettent de modifier les hôtes et les chemins d'accès selon vos besoins. Les réécritures d'hôtes et de chemins d'accès sont effectuées au niveau de la route, ce qui vous permet de définir les requêtes spécifiques qui sont réécrites en fonction de n'importe quelle mise en correspondance, y compris celles basées sur le chemin d'accès, les paramètres de requête et l'en-tête de requête.
Pour en savoir plus, consultez les spécifications de l'API pour
RouteAction.UrlRewrite
Voici trois façons de réécrire une requête :
Champ | Description |
---|---|
urlRewrite.pathPrefixRewrite
|
Réécrit le chemin d'accès, en supprimant le préfixe spécifié dans l'élément
Une seule règle |
urlRewrite.pathTemplateRewrite
|
Une seule règle |
urlRewrite.hostRewrite
|
Réécrit l'hôte avant que la requête ne soit envoyée au serveur d'origine. |
Remarques :
- Les URL réécrites ne modifient pas la clé de cache. La clé de cache est basée sur l'URL de requête envoyée par le client.
- La réécriture se produit après la mise en correspondance avec la route et la validation des requêtes signées. Les routes ne sont pas remises en correspondance avec une autre règle de correspondance.
Exemple : Supprimer un préfixe de chemin d'accès
Par exemple, pour réécrire une URL de requête client /vod/videos/hls/1234/abc.ts
en /videos/hls/1234/abc.ts
(en supprimant /vod
du chemin d'accès), vous pouvez utiliser la fonctionnalité pathPrefixRewrite
:
name: prod-service routing: hostRules: - hosts: - cdn.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 1 origin: my-origin matchRules: - prefixMatch: "/vod/videos/" routeAction: urlRewrite: pathPrefixRewrite: "/videos/"
Un pathPrefixRewrite
fonctionne en remplaçant l'intégralité du composant de chemin d'accès mis en correspondance dans matchRules[].prefixMatch
par la valeur de pathPrefixRewrite
.
Pour réécrire un nom d'hôte (par exemple, réécrire cdn.example.com
en my-bucket.s3.us-west-2.amazonaws.com
), vous pouvez configurer les éléments suivants :
name: prod-service routing: hostRules: - hosts: - cdn.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 1 origin: my-origin matchRules: - prefixMatch: "/videos/" routeAction: urlRewrite: hostRewrite: "my-bucket.s3.us-west-2.amazonaws.com"
Dans ce cas, l'URL de la requête d'origine passe de cdn.example.com/videos/*
à my-bucket.s3.us-west-2.amazonaws.com/videos/*
.
Vous pouvez également combiner les réécritures d'hôte et de chemin d'accès dans une même route.
Exemple : Utiliser des variables pour réécrire des URL
Pour utiliser pathTemplateMatch
et pathTemplateRewrite
pour réécrire des parties d'une URL de requête entrante, consultez la section Capturer des variables.
Rediriger des requêtes
Media CDN accepte trois types de redirections :
- Les redirections d'hôte, qui ne redirigent que l'hôte (domaine), sans modifier le chemin d'accès et les paramètres de requête.
- Les redirections de chemin d'accès, qui remplacent complètement le chemin d'accès.
- Les redirections de préfixe de chemin d'accès, qui ne remplacent que le préfixe correspondant.
Les redirections sont définies par défaut sur HTTP 301 (Moved Permanently)
, mais peuvent être configurées pour renvoyer différents codes d'état de redirection par route.
La configuration suivante est un exemple de redirection basée sur un préfixe, dans lequel vous redirigez les utilisateurs accédant à https://cdn.example.com/on-demand/*
vers https://cdn.example.com/streaming/*
.
name: prod-service routing: hostRules: - hosts: - cdn.example.com pathMatcher: example_routes pathMatchers: - name: example_routes routeRules: - priority: 10 matchRules: - prefixMatch: "/on-demand/" urlRedirect: # The prefix matched in matchRules.prefixMatch is replaced # by this value prefixRedirect: "/streaming/" redirectResponseCode: TEMPORARY_REDIRECT # corresponds to a HTTP 307
Cet exemple modifie également la redirection en redirection temporaire, ce qui empêche les clients (tels que les navigateurs) de la mettre en cache. Cela peut être utile si vous prévoyez de modifier prochainement la redirection.
Les valeurs redirectResponseCode
acceptées sont indiquées dans le tableau suivant.
Code de réponse de redirection | Code d'état HTTP |
---|---|
MOVED_PERMANENTLY_DEFAULT |
HTTP 301 (déplacé définitivement) |
FOUND |
HTTP 302 (trouvé) |
SEE_OTHER |
HTTP 303 (voir ailleurs) |
TEMPORARY_REDIRECT |
HTTP 307 (redirection temporaire) |
PERMANENT_REDIRECT |
HTTP 308 (redirection permanente) |
Remarques :
- Une route peut diriger le trafic vers une origine ou renvoyer une redirection au client. Vous ne pouvez pas définir à la fois
origin
eturlRedirect
en même temps. - Les routes qui redirigent vers HTTPS nécessitent qu'au moins un certificat SSL soit associé au service.
Pour en savoir plus, consultez les spécifications de l'API pour
RouteRule.UrlRedirect
Rediriger toutes les requêtes vers HTTPS
Pour rediriger toutes les requêtes vers HTTPS (au lieu de HTTP), vous pouvez configurer chacun de vos services pour rediriger automatiquement toutes les requêtes client vers HTTPS. Les clients se connectant via HTTP reçoivent une réponse HTTP 301 (Permanent Redirect)
avec l'en-tête Location
défini sur la même URL utilisant "https://" au lieu de "http://".
gcloud
gcloud edge-cache services update MY_SERVICE \ --require-tls
Request issued for: [MY_SERVICE] Updated service [MY_SERVICE].
La commande renvoie une description de votre service, avec requireTls
maintenant défini sur true
.
name: MY_SERVICE requireTls: true
Vous pouvez également choisir de définir Strict-Transport-Security comme en-tête de réponse pour encourager les clients à toujours se connecter directement via HTTPS
Utiliser des backends de stockage tiers
Media CDN est compatible avec la connexion aux points de terminaison HTTP accessibles au public en dehors de Google Cloud, y compris aux buckets de stockage AWS S3, à Azure Blob Storage et à d'autres fournisseurs de stockage. Cela peut être utile si vous disposez d'une architecture multicloud ou si vous devez encore migrer des données vers Cloud Storage avec le service de transfert de stockage.
Voici une configuration d'origine minimale qui configure un bucket hébergé virtuellement dans AWS S3 :
name: MY_S3_ORIGIN originAddress: BUCKET-NAME.s3.REGION.amazonaws.com
Si vous n'utilisez pas un nom de bucket correspondant aux noms d'hôte configurés pour vos ressources EdgeCacheService
, vous devez également configurer une réécriture d'hôte pour les routes associées à cette origine (ou à ces origines). Sans cela, l'en-tête "Host" défini par la requête client est utilisé lors de la récupération à partir de l'origine.
Par exemple, pour mapper toutes les requêtes dont le préfixe de chemin est /legacy/
vers votre bucket externe, vous pouvez configurer à la fois un hostRewrite
et un pathPrefixRewrite
pour supprimer ce préfixe de la requête d'origine :
routeRules: - description: legacy backend matchRules: - prefixMatch: "/legacy/" routeAction: urlRewrite: hostRewrite: BUCKET-NAME.s3.REGION.amazonaws.com pathPrefixRewrite: / cdnPolicy: cacheMode: CACHE_ALL_STATIC defaultTtl: 3600s
Pour en savoir plus sur la manière dont l'en-tête d'hôte est défini sur les requêtes d'origine, consultez la documentation sur les en-têtes de requête d'origine.
Partage des ressources entre origines multiples (CORS)
Le partage des ressources entre origines multiples (CORS, Cross-Origin Resource Sharing) est une approche centrée sur le navigateur pour effectuer des requêtes entre origines de manière sécurisée.
Les stratégies CORS vous permettent de définir automatiquement des en-têtes CORS, tels que
Access-Control-Allow-Origins
, selon une règle par route.
Configurer le CORS
Media CDN vous permet de définir une règle CORS sur une route
EdgeCacheService
Une stratégie CORS définit ces règles avec un ensemble commun d'en-têtes HTTP. Vous pouvez
définir des en-têtes CORS courants dans les réponses, tels que
Access-Control-Allow-Origin
, Access-Control-Max-Age
et Access-Control-Allow-Headers
. Ces en-têtes vous
permettent de créer
d'appels multi-origines à vos services Media CDN qui pourraient être
est hébergé sur un autre domaine (d'origine) que l'interface de votre site Web et peut
les requêtes multi-origines
que vous n'autorisez pas explicitement.
Par exemple, player.example.com
et api.example.com
ont des origines différentes
(au sens du navigateur), et il peut être utile que votre application d'interface
envoyer des requêtes à api.example.com
pour récupérer la playlist suivante ou actualiser une
liste de contenus associés. De même, player.example.com
peut avoir besoin de
Contactez cdn.example.com
pour récupérer des playlists et des segments de vidéos:
cdn.example.com
doit indiquer que tout va bien et que
player.example.com
est un élément allowed origin
, comme toute autre règle.
(en-têtes autorisés, si des cookies peuvent être inclus).
Prenons un autre exemple : si vous souhaitez autoriser stream.example.com
en tant qu'origine
et un en-tête X-Client-ID
dans les requêtes CORS, vous pouvez configurer un corsPolicy
sur une
comme suit:
corsPolicy: maxAge: 600 allowOrigins: ["stream.example.com"] allowHeaders: ["X-Client-ID"]
Un corsPolicy
est configuré à
routing.pathMatchers[].routeRules[].routeAction.corsPolicy
dans un
EdgeCacheService. Chaque routeRule
peut définir un corsPolicy
différent si nécessaire, ou aucun.
Si vous définissez une valeur corsPolicy
et un en-tête de réponse personnalisé par
à l'aide des champs responseHeadersToAdd
d'un itinéraire portant le même nom,
l'en-tête de réponse personnalisé est prioritaire sur et est utilisé à la place de l'en-tête
Valeur corsPolicy
.
Si la réponse de l'origine définit des en-têtes HTTP et que vous avez une valeur corsPolicy
défini, les valeurs corsPolicy
sont utilisées à la place. Les valeurs ne sont pas condensées ni combinées pour éviter d'envoyer des valeurs d'en-tête non valides à un client ou de définir par inadvertance une règle plus permissive que prévu.
L'{origin_request_header}
spécial est renseigné avec l'en-tête HTTP Origin
dans la requête client. Elle peut être définie comme valeur d'en-tête de réponse personnalisée sur une
pour l'en-tête Access-Control-Allow-Origin
.
Pour en savoir plus, consultez la documentation
spécifique pour
RouteAction.CORSPolicy
Champs de la règle CORS
Le tableau suivant décrit les champs contenus dans une stratégie CORS.
Champ | Description | Exemple |
---|---|---|
allowOrigins |
Définit l'en-tête de réponse
Par exemple, si votre contenu vidéo est diffusé depuis |
Access-Control-Allow-Origins: https://stream.example.com
|
maxAge |
Définit l'en-tête de réponse Certains navigateurs imposent une limite de 2 heures ou moins, même si la valeur maximale (86 400 secondes) est spécifiée. |
Access-Control-Max-Age: 7200
|
allowMethods |
Définit l'en-tête de réponse Par défaut, Media CDN n'accepte que les |
Access-Control-Allow-Methods: GET, OPTIONS, HEAD
|
allowHeaders |
Définit l'en-tête Cela est souvent requis par les lecteurs vidéo, qui doivent accéder à certains en-têtes de réponse pour le contenu vidéo lorsqu'il est demandé avec une requête multi-origines. |
Access-Control-Allow-Headers: Content-Type, If-Modified-Since,
Range, User-Agent
|
exposeHeaders |
Définit l'en-tête de réponse Cela est souvent requis par les lecteurs vidéo, qui peuvent avoir besoin d'accéder à des en-têtes de réponse spécifiques pour le contenu vidéo lorsqu'il est demandé avec une requête multi-origines. |
Access-Control-Expose-Headers: Date, Cache-Status, Content-Type,
Content-Length
|
allowCredentials |
Définit l'en-tête de réponse Cet en-tête est omis lorsqu'il est défini sur "false". |
Access-Control-Allow-Credentials: true
|
disabled |
Désactive le corsPolicy sans le supprimer. Les requêtes OPTIONS préliminaires sont envoyées par proxy à l'origine.
|
Non disponible |
Exemple de corsPolicy
L'exemple de configuration suivant illustre une configuration corsPolicy
de base :
routeRules: - priority: 1 matchRules: - prefixMatch: /stream/ routeAction: cdnPolicy: defaultTtl: 3600s corsPolicy: allowOrigins: - "https://stream.example.com" - "https://stream-staging.example.com" maxAge: 86400s # some browsers might only honor up to 7200s or less allowMethods: - "GET" - "HEAD" - "OPTIONS" allowHeaders: - "Content-Type" - "If-Modified-Since" - "Range" - "User-Agent" exposeHeaders: - "Content-Type" - "Content-Length" - "Date"
Résoudre les problèmes de routage
Si certaines requêtes ne récupèrent pas de résultats correspondants ou renvoient des erreurs, vérifiez les points suivants :
- Une route doit avoir une
matchRule
avec un seul élément défini parmiprefixMatch
,fullPathMatch
oupathTemplateMatch
. L'API renvoie une erreur si vous n'incluez aucun de ces champs. - Assurez-vous que la valeur
priority
de chaque route est définie correctement : les routes plus spécifiques (plus longues) doivent avoir une priorité plus élevée que les routes plus courtes et moins spécifiques. - Par défaut, seules les requêtes
GET
,HEAD
etOPTIONS
sont acceptées. Dans la version Preview, vous pouvez configurer la compatibilité autres méthodes, consultez la section Méthodes de routage. Les méthodes qui ne sont pas activées pour une route particulière sont rejetées avec une erreur HTTP405 (Method Not Allowed)
. - Les requêtes HTTP
GET
comportant un corps ou toute requête incluant des bandes-annonces sont refusées. avec une erreur HTTP400
, car le corps de la requête n'est pas autorisé dansGET
requêtes. - La mise en correspondance de paramètres de requête et d'en-têtes utilise un opérateur logique "AND". La requête doit donc correspondre à toutes les clés de paramètre de requête ou d'en-tête (et aux valeurs, le cas échéant) pour être mise en correspondance avec la route donnée.
Étape suivante
- Consultez la documentation sur la configuration de la mise en cache.
- Découvrez comment vous connecter à différentes origines.
- Configurez des certificats TLS (SSL) pour votre service.
- Configurez des requêtes signées pour authentifier l'accès au contenu.