Les déploiements de développement AEM Cloud Manager échouent en raison d’erreurs XML et ClientLib
Cet article explique les causes et les étapes de résolution des échecs de déploiement et de l’augmentation des temps de déploiement dans les environnements de développement Cloud Manager Adobe Experience Manager (AEM), provoqués par des erreurs de syntaxe XML et des problèmes de compilation de bibliothèque cliente.
Description description
Environnement
- Adobe Experience Manager (AEM) Cloud Manager (toutes les versions)
Problème/Symptômes
-
Les déploiements de développement prennent beaucoup plus de temps que d’habitude (plus de deux heures) et échouent finalement lors de l’étape de déploiement.
-
Le pipeline de déploiement passe les étapes de validation, de création, de test unitaire, d’analyse du code et de création d’images, mais échoue à l’étape Déployer vers l’environnement DE DÉVELOPPEMENT .
-
Les journaux de déploiement affichent les erreurs liées aux balises de fin XML manquantes dans les packages de contenu, telles que :
Le type d’élément « content » doit être terminé par la balise de fin correspondante «
</content>».Le type d’élément « header » doit être terminé par la balise de fin correspondante «
</header>». -
Les importations de packages de distribution échouent en raison d’erreurs d’analyse XML.
-
Des erreurs de compilation LESS se produisent dans la bibliothèque cliente (ClientLib), telles que des variables non définies (par exemple, @white) et des mixins manquants.
-
Des erreurs de compilation Java se produisent pour les classes de modèles personnalisés non résolues.
-
Ces erreurs étaient auparavant présentes, mais n’ont pas provoqué d’échecs de déploiement. Ils entraînent désormais des défaillances de pipeline.
Cause
Les échecs de déploiement se produisent en raison d’erreurs de syntaxe XML (balises de fin manquantes), de variables ou de mixins de bibliothèque cliente non résolus et de classes de modèle Java personnalisé manquantes. Des modifications récentes de pipeline ou d’environnement peuvent entraîner l’échec de ces problèmes lors des déploiements, même s’ils n’étaient auparavant pas bloquants.
Résolution resolution
Pour résoudre ce problème, procédez comme suit :
- Accédez aux journaux d’exécution du pipeline Cloud Manager pour le déploiement ayant échoué.
- Identifier toutes les erreurs d’analyse XML et de compilation de bibliothèque cliente.
- Recherchez les fichiers XML référencés, par exemple sous
/conf/.../settings/wcm/templates/. - Assurez-vous que tous les éléments XML, tels que
<content>et<header>, incluent des balises de fermeture correspondantes telles que</content>et</header>. - Validez la structure XML avec un programme de validation XML avant de valider les modifications.
- Vérifiez les fichiers LESS et CSS pour les variables non définies, telles que
@whiteet@mid-blue, et les mixins manquants, tels que.label-small-style()et.media(). - Définissez les variables et mixins manquants ou mettez à jour les imports pour inclure les définitions requises.
- Recréez les bibliothèques clientes localement pour confirmer la réussite de la compilation.
- Assurez-vous que toutes les classes de modèles Sling personnalisées référencées par les composants sont présentes et correctement importées dans la base de code.
- Résolvez les dépendances manquantes ou les références de package incorrectes.
- Validez les modifications dans le référentiel une fois que vous avez effectué les corrections nécessaires.
- Déclenchez un nouveau déploiement dans Cloud Manager et surveillez le pipeline pour confirmer qu’il s’est terminé avec succès.