Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Configurez CloudFront l'intégration de base avec MediaTailor
AWS Elemental MediaTailor l'intégration avec Amazon CloudFront améliore les performances de diffusion de contenu pour vos spectateurs. Cette rubrique vous explique comment configurer une CloudFront distribution de base pour MediaTailor. Grâce à cette intégration, vos spectateurs peuvent accéder à du contenu personnalisé via le CloudFront réseau. Vous apprendrez également à configurer une mise en cache appropriée pour différents types de contenu.
Pour plus d'informations sur la transmission de paramètres de requête à CloudFront des fins d'autorisation et de routage, consultez[MediaTailor paramètres de requête manifeste](manifest-query-parameters.md). Pour un routage avancé à l'aide de variables dynamiques, voir[MediaTailor variables de domaine pour plusieurs sources de contenu](variables-domains.md).
## Conditions préalables
Avant de procéder CloudFront à la configuration avec MediaTailor, assurez-vous de disposer des éléments suivants :
+ Un AWS compte actif autorisé à créer et à gérer CloudFront des distributions
+ Une configuration MediaTailor de lecture configurée (voir[Utilisation AWS Elemental MediaTailor pour insérer des publicités](configurations.md))
+ Votre serveur d'origine de contenu correctement configuré et accessible
+ Compréhension de base des concepts de streaming vidéo (HLS/DASH)
## Configuration de CloudFront la distribution
Procédez comme suit pour créer et configurer une CloudFront distribution pour MediaTailor :
**Pour créer une CloudFront distribution pour MediaTailor**
1. Connectez-vous à la console AWS de gestion et ouvrez-la sur CloudFront [https://console.aws.amazon.com/cloudfront/v3/home](https://console.aws.amazon.com/cloudfront/v3/home).
1. Choisissez **Create Distribution**.
1. Pour le **domaine Origin**, entrez l'URL de votre MediaTailor point de terminaison (par exemple,`a1b2c3d4.mediatailor.us-west-2.amazonaws.com`).
1. Pour **Protocole**, sélectionnez **HTTPS uniquement**.
1. Dans **Nom**, entrez un nom qui vous aide à identifier cette origine (par exemple,`mediatailor-origin`).
1. Configurez les paramètres de comportement du cache par défaut :
1. Pour **le modèle de chemin**, utilisez la valeur par défaut (`*`).
1. Pour **compresser automatiquement les objets**, sélectionnez **Oui**.
1. Pour la **politique du protocole Viewer**, sélectionnez **Rediriger le HTTP vers HTTPS**.
1. Pour les **méthodes HTTP autorisées**, sélectionnez **GET, HEAD**.
1. Pour la **politique de cache**, sélectionnez **CachingDisabled**.
1. Pour la **politique de demande Origin**, sélectionnez **AllViewer**cette option pour transférer tous les en-têtes pour le comportement par défaut.
**Note**
Le comportement par défaut permet AllViewer de gérer en toute sécurité tout contenu qui ne correspond pas à des modèles de chemin spécifiques. Les comportements de cache spécifiques pour les manifestes et les segments seront configurés séparément avec des politiques appropriées.
1. Configurez les paramètres de distribution :
1. Pour la **catégorie de prix**, sélectionnez l'option qui correspond le mieux à la zone géographique de votre public.
1. Pour l'**ACL AWS WAF Web**, sélectionnez une ACL Web existante ou laissez le champ **Ne pas activer les protections de sécurité**.
1. Pour l'**objet racine par défaut**, laissez le champ vide.
1. Pour la **journalisation standard**, sélectionnez **Activé** pour activer la journalisation.
1. Choisissez **Create Distribution**.
## Configuration des comportements du cache
Après avoir créé votre distribution, vous devez configurer des comportements de cache supplémentaires pour gérer les différents types de contenu de manière appropriée. Cette section décrit la configuration de base du comportement du cache pour CloudFront.
Pour une optimisation complète de la mise en cache, y compris les paramètres TTL avancés, les configurations des clés de cache et le réglage des performances, consultez [Optimisation de la mise en cache pour le CDN et les intégrations MediaTailor](cdn-optimize-caching.md) le guide d'optimisation du CDN.
### Configuration du comportement du cache du manifeste
Ne mettez pas en cache les manifestes car ils contiennent du contenu personnalisé. Pour configurer le comportement du cache, procédez comme suit :
**Pour configurer le comportement du cache du manifeste**
1. Dans la CloudFront console, sélectionnez votre distribution.
1. Choisissez l’onglet **Comportements**.
1. Choisissez **Create behavior (Créer un comportement)**.
1. Dans le champ **Path pattern**, saisissez pour `*.m3u8` qu'il corresponde à des playlists HLS multivariantes et à des playlists multimédias.
1. Pour **Origin**, sélectionnez votre MediaTailor origine.
1. Pour la **politique de cache**, sélectionnez **CachingDisabled**.
1. Pour la **politique de demande Origin**, sélectionnez **AllViewer**cette option pour transférer tous les en-têtes requis pour le contenu dynamique.
1. Choisissez **Créer**.
1. Répétez ces étapes pour les manifestes DASH en utilisant le modèle `*.mpd` de chemin correspondant MPDs.
Cette configuration garantit que chaque spectateur reçoit un manifeste personnalisé avec son contenu publicitaire spécifique. Le CDN ne met pas ces manifestes en cache. Chaque demande est donc directement envoyée à MediaTailor.
### Configuration du comportement du cache de segments
Configurez des comportements de cache distincts pour les segments publicitaires et les segments de contenu afin d'optimiser les performances et de garantir une gestion appropriée du CORS.
#### Configuration du comportement du cache des segments publicitaires
Les segments publicitaires diffusés selon le modèle de `/tm/*` chemin nécessitent une configuration spécifique pour gérer correctement le CORS. Procédez comme suit :
**Pour configurer le comportement du cache des segments publicitaires**
1. Dans la CloudFront console, sélectionnez votre distribution.
1. Choisissez l’onglet **Comportements**.
1. Choisissez **Create behavior (Créer un comportement)**.
1. Dans **le champ Path pattern**, saisissez `/tm/*` pour qu'il corresponde aux segments publicitaires diffusés par MediaTailor.
1. Pour **Origin**, sélectionnez l'origine de vos MediaTailor segments (en utilisant le `segments.mediatailor.region.amazonaws.com` nom d'hôte).
1. Pour la **politique de cache**, sélectionnez **CachingOptimized**.
1. Pour la **politique de demande d'origine**, sélectionnez **Aucune**.
1. Pour la **politique des en-têtes de réponse**, sélectionnez **CORS- with-preflight-and - SecurityHeadersPolicy** pour vous assurer que les en-têtes CORS appropriés sont inclus dans les réponses.
1. Choisissez **Créer**.
#### Configuration du comportement du cache des segments de contenu
Les segments de contenu peuvent utiliser des politiques de mise en cache standard pour des performances optimales. Configurez des comportements distincts pour les différents formats de segment :
**Pour configurer le comportement du cache des segments de contenu**
1. Dans la CloudFront console, sélectionnez votre distribution.
1. Choisissez l’onglet **Comportements**.
1. Choisissez **Create behavior (Créer un comportement)**.
1. Pour **le modèle de chemin**, entrez `*.ts` pour correspondre aux segments de contenu HLS.
1. Pour **Origin**, sélectionnez l'origine de votre contenu.
1. Pour la **politique de cache**, sélectionnez **CachingOptimized**.
1. Pour la **politique de demande d'origine**, sélectionnez **Aucune**.
1. Pour la **politique des en-têtes de réponse**, sélectionnez **CORS- with-preflight-and - SecurityHeadersPolicy** pour garantir une gestion CORS cohérente de tous les types de contenu.
1. Choisissez **Créer**.
1. Répétez ces étapes pour les autres formats de segments de contenu en utilisant les modèles de chemin appropriés :
+ `*.mp4`pour les MP4 segments
+ `*.m4s`pour les segments DASH
+ `*.cmfv`et `*.cmfa` pour les segments CMAF
Cette configuration garantit que les segments publicitaires et les segments de contenu sont mis en cache de manière appropriée avec une gestion CORS appropriée. Les segments publicitaires utilisent l'origine MediaTailor des segments avec une protection CORS, tandis que les segments de contenu utilisent votre origine de contenu avec des politiques de mise en cache optimisées.
## Mettre à jour MediaTailor la configuration
Après avoir configuré votre CloudFront distribution, mettez à jour votre MediaTailor configuration pour utiliser le CloudFront domaine :
**Pour mettre à jour votre MediaTailor configuration**
1. Ouvrez la [MediaTailor console](https://console.aws.amazon.com/mediatailor/home).
1. Sélectionnez la configuration que vous souhaitez mettre à jour.
1. Dans la section **Configuration du CDN**, entrez le nom de votre domaine de CloudFront distribution (par exemple,`d1234abcdef.cloudfront.net`) dans le champ de **préfixe du segment de contenu CDN**.
1. Enregistrez vos modifications.
Avec cette configuration, MediaTailor génère des manifestes pointant vers votre CloudFront distribution plutôt URLs que directement vers l'origine.
## Tester votre intégration
Après avoir configuré votre CloudFront distribution et mis à jour votre MediaTailor configuration, testez l'intégration :
**Pour tester votre MediaTailor intégration CloudFront et votre intégration**
1. Demandez un manifeste par le biais CloudFront de votre distribution (par exemple,`https://d1234abcdef.cloudfront.net/v1/master/12345/my-config/index.m3u8`).
1. Vérifiez que le manifeste contient un segment URLs qui pointe vers votre CloudFront domaine.
1. Diffusez le contenu via un lecteur vidéo et vérifiez que le contenu et les publicités s'affichent correctement.
1. Vérifiez les CloudFront journaux pour vous assurer que les demandes sont correctement acheminées.
## Exemple de configuration
Voici un exemple de configuration de CloudFront distribution MediaTailor avec des comportements de cache appropriés :
**Example CloudFront exemple de configuration de distribution**
```
{
"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"
}
]
}
```
Cet exemple montre :
+ **Comportement par défaut** : utilise `CachingDisabled` et `AllViewer` gère en toute sécurité tout contenu qui ne correspond pas à des modèles de chemin spécifiques
+ **Comportement du manifeste (\$1.m3u8)** : utilisations `CachingDisabled` et pour le contenu dynamique `AllViewer`
+ **Comportement du segment (\$1.ts)** : utilisations `CachingOptimized` et `CORS-with-preflight-and-SecurityHeadersPolicy`
## Étapes suivantes
Après avoir configuré votre CloudFront intégration de base avec MediaTailor, considérez les étapes suivantes :
+ Optimisez les performances grâce à des CloudFront fonctionnalités supplémentaires (voir[Optimisation MediaTailor des performances grâce aux CloudFront fonctionnalités](cloudfront-performance-optimization.md))
+ Mettre en œuvre la résilience multirégionale avec MQAR (voir) [Mettre en œuvre la résilience multirégionale MediaTailor avec MQAR](media-quality-resiliency.md)
+ Configurer la surveillance et le dépannage (voir[Surveillez et résolvez les problèmes liés à votre intégration CloudFront et MediaTailor](monitoring-and-troubleshooting.md))