Invalidation du cache du réseau CDN 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 souhaitez 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. Plutôt que d’attendre que le cache arrive à expiration en utilisant une valeur TTL (durée de vie) (dix heures par défaut), vous pouvez envoyer une demande depuis Dynamic Media pour que le cache arrive à expiration en quelques minutes.

REMARQUE

Cette fonctionnalité nécessite l’utilisation du CDN prêt à l’emploi fourni avec Adobe Experience Manager Dynamic Media. Aucun autre CDN personnalisé n’est pris en charge avec cette fonctionnalité.

IMPORTANT

Les étapes suivantes s’appliquent uniquement au mode Dynamic Media - Scene7 dans Adobe Experience Manager 6.5, Service Pack 6 (Experience Manager 6.5.6) ou version ultérieure. Cette fonction d’invalidation du réseau de diffusion de contenu requiert également que vous utilisiez le réseau de diffusion de contenu prêt à l’emploi fourni avec le Dynamic Media Experience Manager ; aucun autre CDN personnalisé n’est pris en charge.
Si vous utilisez Dynamic Media dans Experience Manager 6.5, Service Pack 5 (Experience Manager 6.5.5) ou version antérieure, suivez les étapes décrites dans Invalidation du cache CDN par le biais de Dynamic Media Classic.

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

Pour invalider le contenu mis en cache sur le réseau de diffusion de contenu pour les ressources Dynamic Media :

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

  1. Dans Experience Manager 6.5.6 ou version ultérieure, appuyez sur Outils > Ressources > Invalidation CDN.

    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 d’image prédéfinis ou les 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 remplit https://<publishserver_name>/is/image/<company_name>/<ID><publishserver_name> est le nom de votre serveur de publication défini dans 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 de Experience Manager et <ID> est les ressources sélectionnées par le biais du sélecteur de ressources à 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 chemin d’accès, <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 (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 non pris en charge pour l’invalidation CDN sont les suivants : PostScript®, PostScript® encapsulé, 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.
    Spécifiez les URL pour les cultures dynamiques d’image dans ce modèle d’invalidation CDN ou dans le champ Ajouter URLtext de la 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 Experience Manager en tant que Cloud Service, appuyez sur Outils > Ressources > Invalidation CDN.

    Fonction de validation du réseau CDN

  5. Sur la page Invalidation CDN - Détails de l’Ajoute, sélectionnez les ressources pour l’invalidation 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. Utilisez cette option pour les images uniquement.

    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 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 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.
    Spécifiez les URL pour les cultures dynamiques d’image dans le modèle d’invalidation CDN ou dans ce champ Ajouter URLtext.
  6. Dans le coin supérieur droit de la page, appuyez sur Suivant.

  7. Sur la page Invalidation CDN - Confirmer, dans la zone URLs liste, vous pouvez voir une liste d’une ou de plusieurs URL générées à partir du modèle d’invalidation CDN que vous avez créé précédemment et des actifs 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 CDN, les cinq URL suivantes sont générées dans l’interface utilisateur Invalidation CDN - 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 pour les ressources sélectionnées. Se produit si l'un des scénarios suivants est satisfait :
- 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 la racine de société utilisée pour former les URL est absent de la configuration de 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 de diffusion de contenu 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 IPS cdnCacheInvalidation.
É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 n’est invalidée. Se produit si aucune URL n'est présente dans la page Invalidation CDN - Confirmer et que vous appuyez sur Envoyer.

Sur cette page