Show Menu
SUJETS×

Invalidation du cache CDN par le biais de Contenu multimédia dynamique

Les ressources Contenu multimédia dynamique sont mises en cache par le réseau CDN (Content Diffusion Network) pour une diffusion rapide à vos clients. Cependant, lorsque vous apportez des mises à jour à ces ressources, vous souhaiterez peut-être que ces modifications prennent effet immédiatement sur votre site Web. La purge ou l’invalidation du cache CDN vous permet de mettre rapidement à jour les fichiers distribués par Contenu multimédia dynamique. Au lieu d’attendre que le cache arrive à expiration à l’aide d’une valeur TTL (durée de vie) (10 heures par défaut), vous pouvez envoyer une demande depuis l’interface utilisateur Contenu multimédia dynamique pour que le cache arrive à expiration en quelques minutes.
Les étapes suivantes s’appliquent uniquement à Contenu multimédia dynamique sur AEM en tant que Cloud Service. Cette fonctionnalité nécessite également l’utilisation du CDN prêt à l’emploi fourni avec AEM Contenu multimédia dynamique ; aucun autre CDN personnalisé n’est pris en charge.
Pour invalider le cache CDN au moyen de Contenu multimédia dynamique
Partie 1 de 2 : Création d’un modèle d’invalidation CDN
  1. Dans AEM en tant que Cloud Service, appuyez sur Outils > Actifs > Modèle d’invalidation CDN.
  2. Sur la page du modèle d’invalidation CDN, effectuez l’une des options suivantes en fonction de votre scénario :
    Scénario
    Option
    J’ai déjà créé un modèle d’invalidation CDN dans le passé à l’aide de Contenu multimédia dynamique classique.
    Le champ de texte Créer un modèle est prérenseigné avec vos données de modèle. Dans ce cas, vous pouvez modifier le modèle ou passer à l’étape suivante.
    Je dois créer un modèle. Que puis-je entrer ?
    Dans le champ de texte Créer un modèle , saisissez une URL d’image (y compris les paramètres prédéfinis ou les modificateurs d’image) référençant <ID> l’image au lieu d’un ID d’image spécifique comme dans l’exemple suivant :
    https://my.publishserver.com/is/image/company_name/<ID>?$product$
    Si le modèle contient uniquement <ID> , Contenu multimédia dynamique remplit https://<publishserver_name>/is/image/<company_name>/<ID> l’emplacement où <publishserver_name> est le nom de votre serveur de publication défini dans Paramètres généraux de Contenu multimédia dynamique classique ; le nom <company_name> est celui de la racine de votre société associée à cette instance AEM et <ID> est le nom des ressources sélectionnées par le biais du sélecteur de ressources à invalider.
    Toute publication de paramètres prédéfinis/modificateurs <ID> est copiée en l’état dans la définition d’URL.
    Seules les images (c'est-à-dire /is/image ) peuvent être formées automatiquement en fonction du modèle.
    Par exemple, /is/content/ l’ajout de fichiers tels que des vidéos ou des fichiers PDF à l’aide du sélecteur de ressources ne génère pas automatiquement d’URL. Au lieu de cela, vous devez spécifier de tels actifs soit dans le modèle d’invalidation CDN, soit vous pouvez ajouter manuellement l’URL à ces actifs dans la partie 2 de la 2 : Définition des options d’invalidation CDN.
    Exemples :
    Dans ce premier exemple, le modèle d’invalidation contient <ID> avec l’URL de ressource /is/content . Par exemple, http://my.publishserver.com:8080/is/content/dms7snapshot/<ID> . Le Contenu multimédia dynamique forme l’URL en fonction de ce paramètre, en <ID> étant les ressources sélectionnées par le biais du sélecteur de ressources que vous souhaitez invalider.
    Dans ce deuxième exemple, le modèle d’invalidation contient l’URL complète de la ressource utilisée dans vos propriétés Web avec /is/content (sans dépendre du sélecteur de ressources). Par exemple, http://my.publishserver.com:8080/is/content/dms7snapshot/backpack où backpack correspond à l’ID de fichier.
    Les formats de fichier pris en charge dans Contenu multimédia dynamique peuvent être invalidés. Les types de fichiers non pris en charge pour l’invalidation CDN sont Postscript, Encapsulated Postscript, Adobe Illustrator, Adobe InDesign, Microsoft Powerpoint, Microsoft Excel, Microsoft Word et Rich Text Format.
    Lorsque vous créez le modèle, mais que vous prêtez une attention particulière à la syntaxe et aux fautes de frappe ; Contenu multimédia dynamique n’effectue aucune validation de modèle.
    Notez que vous devez spécifier des URL pour les images de rognage intelligent dans ce modèle d’invalidation CDN ou dans le champ de texte URL d’ Ajoute de la partie 2 : Définition des options d’invalidation CDN.
    Important : ​Chaque entrée d’un modèle d’invalidation CDN doit se trouver sur sa propre ligne.
    L'exemple de modèle suivant est fourni à titre d'illustration uniquement.
  3. Dans le coin supérieur droit de la page de modèle d’invalidation du CDN, appuyez sur Enregistrer , puis sur OK.
    Partie 2 de 2 : Définition des options d’invalidation CDN
  4. Dans AEM en tant que Cloud Service, appuyez sur Outils > Actifs > Invalidation CDN.
  5. Sur la page Invalidation ​CDN - Détails de l’ Ajoute, sélectionnez les ressources pour l’invalidation CDN.
    Si vous décidez de ne pas cocher les options Invalider les paramètres d’image prédéfinis associés au fichier dans le CDN et Invalider en fonction du modèle ​, l’URL de base des fichiers sélectionnés est alors formée pour invalidation. Cette option est réservée aux images.
    Option
    Description
    Invalider les paramètres d’image prédéfinis associés à la ressource dans le réseau de diffusion de contenu
    (Facultatif) Lorsque vous cochez cette option, les fichiers sélectionnés et toutes les URL de paramètres d’image prédéfinis associées sont automatiquement formés en vue de l’invalidation du cache.
    Les fichiers et leurs URL prédéfinies associées sont automatiquement créés pour invalidation. Cette option fonctionne uniquement pour les fichiers d’image.
    Invalidation basée sur un modèle
    (Facultatif) Cochez cette option pour n’utiliser que le modèle défini pour la formation d’URL.
    Ajouter des ressources
    Utilisez le sélecteur de ressources pour sélectionner les fichiers que vous souhaitez invalider. Vous pouvez sélectionner des fichiers publiés ou non publiés.
    La mise en cache sur le CDN repose sur des URL et non sur des ressources. Par conséquent, il est nécessaire que vous connaissiez les URL complètes qui se trouvent sur votre site Web. Après avoir déterminé ces URL, vous pouvez les ajouter au modèle. Vous pouvez ensuite sélectionner et ajouter ces ressources et invalider les URL en une seule étape.
    Utilisez cette option conjointement avec les paramètres d’image prédéfinis associés au fichier Invalider dans le CDN ou Invalidation en fonction du modèle , ou les deux.
    Ajouter une URL
    Ajoutez ou collez manuellement des chemins d’URL complets aux fichiers Contenu multimédia dynamique dont vous souhaitez invalider le cache CDN. Utilisez cette option si vous n’avez pas créé de modèle d’invalidation CDN dans la partie 1 de 2 : Création d’un modèle d’invalidation CDN et n’avoir que quelques ressources à invalider.
    Important : Chaque URL que vous ajoutez doit se trouver sur sa propre ligne.
    Vous pouvez invalider jusqu’à 1 000 URL à la fois. Si le nombre d’URL dans le champ de texte URL d’ Ajoute est supérieur à 1 000, vous ne pouvez pas appuyer sur Suivant . Dans ce cas, vous devez appuyer sur X à droite d’une ressource sélectionnée ou sur une URL ajoutée manuellement pour la supprimer de la liste d’invalidation.
    Notez que vous devez spécifier des URL pour les images de rognage intelligent dans le modèle d’invalidation CDN ou dans ce champ de texte URL ​Ajoute.
  6. Near the upper-right corner of the page, tap Next.
  7. Sur la page Invalidation ​CDN - Confirmer , dans la zone de liste des URL , une ou plusieurs URL sont générées à partir du modèle d’invalidation CDN que vous avez créé précédemment et des ressources que vous venez d’ajouter.
    Par exemple, à l’aide de l’exemple Modèle d’invalidation CDN qui s’affichait dans les étapes précédentes, supposons que vous ayez ajouté une ressource unique nommée spinset . Lorsque vous appuyez sur Outils > Ressources > Invalidation CDN, les cinq URL suivantes sont générées dans l’interface utilisateur Invalidation CDN - Confirmer :
    Si nécessaire, appuyez sur X à droite d’une URL pour la supprimer du processus d’invalidation.
  8. Près du coin supérieur droit de la page, appuyez sur Envoyer pour lancer le processus d’invalidation du réseau de diffusion de contenu.

Résolution des erreurs d’invalidation CDN

Dans tous les cas, soit le lot entier est traité pour invalidation, soit le lot entier a échoué.
Erreur
Explication
Échec de la récupération des URL pour les ressources sélectionnées.
Se produit si l'un des scénarios suivants est satisfait :
- Une configuration Contenu multimédia dynamique est introuvable.
- Il existe une exception lors de la récupération d’un utilisateur de service par l’intermédiaire duquel la configuration Contenu multimédia dynamique est lue.
- Le serveur de publication ou la racine de société utilisée pour former les URL est absent de la configuration Contenu multimédia dynamique.
Certaines URL ne sont pas correctement définies. Veuillez corriger et soumettre à nouveau.
Se produit si l'API d'invalidation du cache CDN d'IPS renvoie une erreur indiquant que l'URL fait référence à une autre société ou si l'URL n'est pas valide conformément à la validation effectuée par l'API cdnCacheInvalidation d'IPS.
Échec de l'invalidation du cache CDN.
Se produit si la demande d’invalidation du cache CDN échoue pour une autre raison.
Aucune URL entrée n'a été invalidée.
Se produit si aucune URL n’est présente dans la page Invalidation ​CDN - Confirmer et que vous appuyez sur Envoyer.