Invalidation du cache de réseau CDN par le biais de Dynamic Media invalidating-cdn-cache-for-dm-assets-in-aem-cs

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. Il n’est plus nécessaire d’attendre que le cache expire à l’aide d’une valeur TTL (Time To Live) (dix heures par défaut). Au lieu de cela, vous pouvez envoyer une requête depuis l’interface utilisateur de Dynamic Media pour que le cache arrive à expiration en quelques minutes.

NOTE
Cette fonctionnalité nécessite l’utilisation du réseau CDN groupé avec Adobe fourni avec Adobe Experience Manager Dynamic Media. Aucun autre réseau CDN personnalisé n’est pris en charge avec cette fonctionnalité.

Si vous avez activé Imagerie dynamique sur votre compte et que vous utilisez le réseau CDN groupé avec Adobe, vous pouvez purger toutes les URL avec différentes chaînes de requête en purgeant l’URL de base unique.

Par exemple, invalider https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image invalide également les URL suivantes :

  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image
  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image?wid=300
  • https://weekendsite.scene7.com/is/image/<CUSTOMER-NAME>/image?$PLP$
  • et ainsi de suite.

Cependant, cette invalidation ne concerne pas les domaines génériques qui ne prennent pas en charge l’imagerie dynamique, comme s7d1.scene7.com. Ces domaines ont toujours besoin de l’URL complète pour que l’invalidation fonctionne avec succès.

Pour invalider le cache du réseau CDN au moyen de Dynamic Media :

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

  1. Dans Adobe Experience Manager as a Cloud Service, accédez à 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 :

    table 0-row-2 1-row-2 2-row-2
    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 (comprenant les paramètres d’image prédéfinis ou des modificateurs) 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 renseigne https://<publishserver_name>/is/image/<company_name>/<ID> avec <publishserver_name> comme nom de serveur de publication défini dans les paramètres généraux dans Dynamic Media Classic. <company_name> est le nom de la racine de votre société associée à cette instance d’Experience Manager et <ID> correspond aux ressources sélectionnées par le biais du sélecteur de ressources à invalider.
    Tout paramètre prédéfini ou 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 chemin d’accès, <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.
    • Le modèle d’invalidation du réseau CDN peut enregistrer du texte jusqu’à 2 500 caractères.
    • Spécifiez 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.
    • 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 d’invalidation du réseau CDN suivant est fourni à des fins de démonstration uniquement.

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

    note note
    NOTE
    Le modèle d’invalidation du réseau CDN peut enregistrer du texte jusqu’à 2 500 caractères.
  3. Dans le coin supérieur droit de la page Modèle d’invalidation du réseau CDN, sélectionnez Enregistrer, puis OK.

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

  4. Dans Experience Manager as a Cloud Service, accédez à Outils  > Ressources  > Invalidation du réseau CDN.

    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

    note note
    NOTE
    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. Utilisez cette option réservée aux images.
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    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 dé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 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 sélectionner Suivant. Dans ce cas, vous devez sélectionner X à droite d’une ressource sélectionnée ou sur une URL ajoutée manuellement pour la supprimer de la liste d’invalidation.
    Spécifiez 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, sélectionnez Suivant.

  7. Sur la page Invalidation du réseau de diffusion de contenu- Confirmer, dans la zone de liste URL, apparaît 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 le cas 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 accédez à Outils > Ressources > Invalidation du réseau CDN, les cinq URL suivantes sont générées dans l’interface utilisateur Invalidation du réseau CDN – Confirmer  :

    Invalidation du réseau de diffusion de contenu – Confirmer

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

  8. Dans le coin supérieur droit de la page, sélectionnez 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 pour les 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. Correction et renvoi.
Se produit si l’API d’invalidation du cache du réseau CDN IPS renvoie une erreur. L’erreur indique que l’URL fait référence à une autre entreprise ou qu’elle n’est pas valide selon la validation effectuée par l’API cdnCacheInvalidation d’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 pour être invalidée.
Se produit si aucune URL n’est présente sur la page Invalidation du réseau CDNConfirmer et que vous sélectionnez Envoyer.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab