Invalidation du cache du réseau de diffusion de contenu par le biais de Dynamic Media

Les ressources Dynamic Media sont mises en cache par le réseau de diffusion de contenu (CDN) 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 du réseau CDN vous permet de mettre rapidement à jour les ressources distribuées par Dynamic Media. 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 requête depuis l’interface utilisateur de Dynamic Media pour que le cache arrive à expiration en quelques minutes.

IMPORTANT

Cette fonctionnalité nécessite l’utilisation du CDN prêt à l’emploi, livré avec AEM Dynamic Media ; aucun autre CDN personnalisé n’est pris en charge.

Voir aussi Présentation de la mise en cache dans Dynamic Media.

Pour invalider le cache CDN au moyen de Dynamic Media

Partie 1 de 2 : création d’un modèle d’invalidation du réseau CDN

  1. Dans AEM as a Cloud Service, appuyez sur Outils > Ressources > Modèle d’invalidation du réseau de diffusion de contenu.

    Fonction de validation du réseau CDN

  2. Sur la page Modèle d’invalidation du réseau de diffusion de contenu, effectuez l’une des opérations suivantes en fonction de votre scénario :

    Scénario Option
    J’ai déjà créé un modèle d’invalidation du réseau CDN dans le passé à l’aide de Dynamic Media Classic. 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 dois-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>, 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>, Dynamic Media remplit https://<publishserver_name>/is/image/<company_name>/<ID>, où <publishserver_name> est le nom de votre serveur de publication défini dans les paramètres généraux de Dynamic Media Classic ; <company_name> est le nom du dossier racine de votre entreprise associé à cette instance AEM et <ID> correspond aux ressources sélectionnées par le biais du sélecteur de ressources qui sont à invalider.
    Tout paramètre prédéfini/modificateur placé après <ID> est copié 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.
    Pour /is/content/, l’ajout de ressources telles 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 ces ressources dans le modèle d’invalidation du réseau CDN ou vous pouvez ajouter manuellement l’URL à ces ressources dans Partie 2 de 2 : définition des options d’invalidation du réseau 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>. Dynamic Media forme l’URL en fonction de ce paramètre, <ID> correspondant aux 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 (indépendamment du sélecteur de ressources). Par exemple, http://my.publishserver.com:8080/is/content/dms7snapshot/backpack où backpack correspond à l’ID de ressource.
    Les formats de ressources pris en charge dans Dynamic Media peuvent être invalidés. Les types de fichiers de ressources non pris en charge pour l’invalidation du réseau CDN comprennent les types Postscript, Encapsulated Postscript, Adobe Illustrator, Adobe InDesign, Microsoft PowerPoint, Microsoft Excel, Microsoft Word et Rich Text Format.
    Lorsque vous créez le modèle, faites très attention à la syntaxe et aux fautes de frappe ; Dynamic Media n’effectue aucune validation de modèle.
    Notez que vous devez spécifier des URL pour les recadrages intelligents d’images dans ce modèle d’invalidation du réseau CDN ou dans le champ de texte Ajouter une URL dans Partie 2 : définition des options d’invalidation CDN.
    Important : Chaque entrée d’un modèle d’invalidation du réseau CDN doit se trouver sur sa propre ligne.
    L’exemple de modèle suivant est fourni à titre d’illustration uniquement.

    Modèle d’invalidation du réseau CDN – Créer

  3. Dans le coin supérieur droit de la page Modèle d’invalidation du réseau de diffusion de contenu, appuyez sur Enregistrer, puis sur OK.

    Partie 2 de 2 : définition des options d’invalidation du réseau CDN

  4. Dans AEM as a Cloud Service, appuyez sur Outils > Ressources > Invalidation du réseau de diffusion de contenu.

    Fonction de validation du réseau CDN

  5. Sur la page Invalidation du réseau de diffusion de contenuAjouter des détails, sélectionnez les ressources pour l’invalidation du réseau CDN.

    Invalidation du réseau de diffusion de contenu – Ajouter des détails

    REMARQUE

    Si vous décidez de ne pas cocher les options Invalider les paramètres d’image prédéfinis associés à la ressource dans le réseau de diffusion de contenu et Invalider en fonction d’un modèle, l’URL de base des ressources sélectionnées 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 ressources sélectionnées et toutes les URL de paramètres d’image prédéfinis associées sont automatiquement formées en vue de l’invalidation du cache.
    Les ressources et leurs URL prédéfinies associées sont automatiquement formées en vue de l’invalidation. Cette option fonctionne uniquement pour les ressources d’image.
    Invalidation en fonction d’un modèle (Facultatif) Cochez cette option afin de 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 ressources que vous souhaitez invalider. Vous pouvez sélectionner des ressources publiées ou non publiées.
    La mise en cache sur le réseau CDN repose sur des URL et non sur des ressources. Il est donc nécessaire de connaître 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 options Invalider les paramètres d’image prédéfinis associés à la ressource dans le réseau de diffusion de contenu ou Invalidation en fonction d’un modèle, ou les deux.
    Ajouter une URL Ajoutez ou collez manuellement des chemins d’URL complets aux ressources Dynamic Media dont vous souhaitez invalider le cache de réseau CDN. Utilisez cette option si vous n’avez pas créé de modèle d’invalidation du réseau CDN dans Partie 1 de 2 : création d’un modèle d’invalidation du réseau CDN et n’avez 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 indiqué dans le champ de texte URL Ajouter une URL 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 recadrages intelligents d’images dans le modèle d’invalidation du réseau CDN ou dans ce champ de texte Ajouter une URL.
  6. Dans le coin supérieur droit de la page, appuyez sur Suivant.

  7. Sur la page Invalidation du réseau de diffusion de contenuConfirmer, dans la zone de liste URL, apparaissent une liste d’une ou plusieurs URL générées à partir du modèle d’invalidation du réseau CDN que vous avez créé précédemment et les ressources que vous venez d’ajouter.

    Par exemple, en suivant l’exemple de modèle d’invalidation du réseau CDN utilisé dans les étapes précédentes, supposons que vous ayez ajouté une ressource unique nommée spinset. Lorsque vous appuyez sur Outils > Ressources > Invalidation du réseau de diffusion de contenu, les cinq URL suivantes sont générées dans l’interface utilisateur Invalidation du réseau de diffusion de contenu – Confirmer :

    Invalidation du réseau de diffusion de contenu – Confirmer

    Si nécessaire, appuyez sur X à droite d’une URL pour supprimer cette URL du processus d’invalidation.

  8. Dans le coin supérieur droit de la page, appuyez sur Envoyer pour lancer le processus d’invalidation du réseau CDN.

Résolution des erreurs d’invalidation du réseau 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 de la ou des ressources sélectionnées. Se produit dans l’un des scénarios suivants :
- Une configuration Dynamic Media est introuvable.
- Il existe une exception lors de la récupération d’un utilisateur de service par l’intermédiaire duquel la configuration Dynamic Media est lue.
- Le serveur de publication ou le dossier racine d’entreprise utilisé pour former les URL est absent de la configuration Dynamic Media.
Certaines URL ne sont pas correctement définies. Corrigez ces erreurs puis procédez de nouveau à l’envoi. Se produit si l’API d’invalidation de cache de réseau CDN IPS renvoie une erreur indiquant que l’URL fait référence à une autre entreprise ou si l’URL n’est pas valide conformément à la validation effectuée par l’API cdnCacheInvalidation IPS.
Échec de l’invalidation du cache de réseau CDN. Se produit si la requête d’invalidation du cache de réseau CDN échoue pour une autre raison.
Aucune URL entrée à valider. Se produit si aucune URL n’est présente sur la page Invalidation du réseau de diffusion de contenuConfirmer et que vous appuyez sur Envoyer.

Sur cette page