Configurez CloudFront l'intégration de base avec MediaTailor - AWS Elemental MediaTailor
PrérequisConfiguration de CloudFront la distributionConfiguration des comportements du cacheMettre à jour MediaTailor la configurationTester votre intégrationExemple de configurationÉtapes suivantes

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, consultezMediaTailor paramètres de requête manifeste. Pour un routage avancé à l'aide de variables dynamiques, voirMediaTailor variables de domaine pour plusieurs sources de contenu.

Prérequis

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 (voirUtilisation AWS Elemental MediaTailor pour insérer des publicités)

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

  2. Choisissez Create Distribution.

  3. Pour le domaine Origin, entrez l'URL de votre MediaTailor point de terminaison (par exemple,a1b2c3d4.mediatailor.us-west-2.amazonaws.com).

  4. Pour Protocole, sélectionnez HTTPS uniquement.

  5. Dans Nom, entrez un nom qui vous aide à identifier cette origine (par exemple,mediatailor-origin).

  6. Configurez les paramètres de comportement du cache par défaut :

    1. Pour le modèle de chemin, utilisez la valeur par défaut (*).

    2. Pour compresser automatiquement les objets, sélectionnez Oui.

    3. Pour la politique du protocole Viewer, sélectionnez Rediriger le HTTP vers HTTPS.

    4. Pour les méthodes HTTP autorisées, sélectionnez GET, HEAD.

    5. Pour la politique de cache, sélectionnez CachingDisabled.

    6. Pour la politique de demande Origin, sélectionnez AllViewercette 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.

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

    2. Pour l'ACL AWS WAF Web, sélectionnez une ACL Web existante ou laissez le champ Ne pas activer les protections de sécurité.

    3. Pour l'objet racine par défaut, laissez le champ vide.

    4. Pour la journalisation standard, sélectionnez Activé pour activer la journalisation.

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

  2. Choisissez l’onglet Comportements.

  3. Choisissez Create behavior (Créer un comportement).

  4. Dans le champ Path pattern, saisissez pour *.m3u8 qu'il corresponde à des playlists HLS multivariantes et à des playlists multimédias.

  5. Pour Origin, sélectionnez votre MediaTailor origine.

  6. Pour la politique de cache, sélectionnez CachingDisabled.

  7. Pour la politique de demande Origin, sélectionnez AllViewercette option pour transférer tous les en-têtes requis pour le contenu dynamique.

  8. Choisissez Créer.

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

  2. Choisissez l’onglet Comportements.

  3. Choisissez Create behavior (Créer un comportement).

  4. Dans le champ Path pattern, saisissez /tm/* pour qu'il corresponde aux segments publicitaires diffusés par MediaTailor.

  5. Pour Origin, sélectionnez l'origine de vos MediaTailor segments (en utilisant le segments.mediatailor.region.amazonaws.com nom d'hôte).

  6. Pour la politique de cache, sélectionnez CachingOptimized.

  7. Pour la politique de demande d'origine, sélectionnez Aucune.

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

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

  2. Choisissez l’onglet Comportements.

  3. Choisissez Create behavior (Créer un comportement).

  4. Pour le modèle de chemin, entrez *.ts pour correspondre aux segments de contenu HLS.

  5. Pour Origin, sélectionnez l'origine de votre contenu.

  6. Pour la politique de cache, sélectionnez CachingOptimized.

  7. Pour la politique de demande d'origine, sélectionnez Aucune.

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

  9. Choisissez Créer.

  10. Répétez ces étapes pour les autres formats de segments de contenu en utilisant les modèles de chemin appropriés :

    • *.mp4pour les MP4 segments

    • *.m4spour les segments DASH

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

  2. Sélectionnez la configuration que vous souhaitez mettre à jour.

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

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

  2. Vérifiez que le manifeste contient un segment URLs qui pointe vers votre CloudFront domaine.

  3. Diffusez le contenu via un lecteur vidéo et vérifiez que le contenu et les publicités s'affichent correctement.

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

Exemple 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 (*.m3u8) : utilisations CachingDisabled et pour le contenu dynamique AllViewer

  • Comportement du segment (*.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 :