Correction des échecs de déploiement de la configuration du Dispatcher dans AEM
La configuration de Dispatcher échoue lors du déploiement ou de la migration en raison d’une structure de fichiers incorrecte, d’un package non pris en charge ou de paramètres de configuration de pipeline et de cache incorrectement alignés. Ces problèmes peuvent empêcher un déploiement réussi ou provoquer un comportement inattendu dans les environnements AEM. Pour résoudre ce problème, corrigez la structure de configuration, examinez le comportement du pipeline et validez la configuration.
Description description
Environnements
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services (AMS)
- Scénarios de déploiement et de migration de la configuration de Dispatcher
Problème/Symptômes
- Le déploiement échoue lorsque la configuration du Dispatcher est chargée sous la forme d’une archive compressée au lieu de dossiers bruts
- La migration affiche l’erreur EPERM : opération non autorisée, lien symbolique sur les systèmes Windows
- Le pipeline Dispatcher uniquement ne met pas à jour les configurations comme prévu
- Le cache ne s’efface pas après le déploiement malgré les mises à jour de la configuration
Cause
Les échecs de déploiement se produisent car Cloud Manager nécessite la structure de dossiers brute du Dispatcher plutôt que des archives compressées. Dans AMS, les variables spécifiques à un environnement doivent être définies en externe au lieu d’être codées en dur. Lors de la migration, Dispatcher Converter s’appuie sur des liens symboliques, que les restrictions du système d’exploitation peuvent bloquer.
Résolution resolution
Pour résoudre ce problème, procédez comme suit
- Assurez-vous que le référentiel contient des dossiers de Dispatcher non compressés, tels que
conf.detconf.dispatcher.dà l’emplacement approprié, et supprimez tous les fichiers zip créés manuellement. - Créez un pipeline de couche web dédié dans Cloud Manager et sélectionnez le chemin d’accès au référentiel approprié afin qu’il déploie la configuration du Dispatcher indépendamment sans déclencher de déploiements complets.
- Passez en revue le comportement de déploiement et confirmez que le pipeline sélectionné inclut la structure source du Dispatcher et s’exécute correctement avec les journaux mis à jour, en notant que les pipelines réservés au Dispatcher se mettent à jour de manière incrémentielle.
- Appliquez les méthodes d’effacement du cache prises en charge en activant un point d’entrée de vidage pour AEM as a Cloud Service ou en utilisant des scripts personnalisés dans AMS, et confirmez les mises à jour du cache en vérifiant les horodatages du cache du Dispatcher.
- Définissez des variables spécifiques à un environnement dans Managed Services à l’aide de fichiers de variables, incluez-les dans les configurations d’hôte virtuel et assurez-vous que la configuration est résolue correctement lors des requêtes.
- Récupérez les packages de configuration du Dispatcher de l’environnement, le cas échéant, et vérifiez que les fichiers extraits correspondent à la structure de répertoires attendue.
- Exécutez la conversion du Dispatcher avec les autorisations système appropriées ou utilisez un environnement pris en charge pour éviter les erreurs de lien symbolique et vous assurer que la structure convertie est générée avec succès.
- Validez le déploiement dans les environnements en examinant les journaux d’exécution de pipeline, en vérifiant les journaux du Dispatcher et en confirmant que les mises à jour de configuration s’appliquent correctement.
- Contactez l’équipe de votre compte Adobe pour demander les informations d’identification de l’API de purge du réseau CDN si vous avez besoin d’effacer le cache programmatique.