le pipeline Cloud Manager se bloque et échoue lorsque le dispatcher de prévisualisation n’est pas prêt
Cet article explique comment résoudre les pipelines de déploiement d’AEM as a Cloud Service qui restent dans un état de départ pendant des heures, puis échouent lorsque le Dispatcher de prévisualisation n’est pas prêt à temps.
Description description
Environnement
- Adobe Experience Manager (AEM) as a Cloud Service
- Pipelines de déploiement Cloud Manager utilisant les configurations du dispatcher avec les mappages de réécriture gérés
Problème/Symptômes
- Le pipeline de déploiement reste à l’état de démarrage ou de préchauffage pendant une période prolongée avant d’échouer.
- Les échecs de démarrage et de vérification de la préparation du Dispatcher sont affichés dans les journaux liés à
content/dam/rewrites/redirects. - Cloud Manager affiche un message d’échec de déploiement générique après un long délai.
The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.
- Les étapes de création et de qualité du code se terminent correctement, mais le déploiement ne progresse pas normalement par la suite.
- Le problème peut se produire même lorsque la même branche ou le même code ont été déployés avec succès lors d’exécutions précédentes.
- Cela est plus probable lorsque le projet utilise des mappages de réécriture gérés et que le démarrage de l’aperçu du Dispatcher est retardé.
Conditions de reproduction
- Tentative de déploiement de code (même précédemment réussi) dans l’environnement de développement à l’aide de Cloud Manager.
- L’intégrité du Dispatcher de prévisualisation ou des services de prévisualisation associés ne s’améliore pas dans le délai prévu.
- Le pipeline échoue après une longue attente ou se termine correctement, mais avec une exécution inhabituellement longue.
Cause
Le pipeline de déploiement se bloque et finit par échouer, car le conteneur de Dispatcher de prévisualisation n’atteint pas le statut Prêt, ce qui fait que Cloud Manager attend qu’un délai d’expiration se produise. La mise à jour de la configuration YAML du Dispatcher pour définir l’indicateur d’attente sur false permet au Dispatcher de prévisualisation de démarrer sans bloquer le pipeline.
Résolution resolution
Pour corriger les retards et les échecs de pipeline causés par le blocage de démarrage de la prévisualisation du Dispatcher sur les mappages de réécriture gérés, procédez comme suit :
- Vérifiez que tous les services d’aperçu, y compris le Dispatcher, sont correctement configurés et peuvent démarrer sans erreurs. Vérifiez les journaux Cloud Manager pour identifier tout échec de vérification de la préparation ou de l’intégrité lié au Dispatcher de prévisualisation.
- Modifiez le fichier YAML de configuration du Dispatcher, tel que
rewrite-maps.yamloumanaged-rewrite-maps.yaml. Vérifiez dans le fichier les entrées de mappage qui peuvent bloquer le démarrage et assurez-vous que l’indicateurwaitest défini surfalsepour toutes les entrées de mappage. Par exemple :
maps:
- name: redirects-301.map
path: /content/dam/rewrites/redirects-301.txt
ttl: 300
wait: false
- name: redirects-302.map
path: /content/dam/rewrites/redirects-302.txt
ttl: 300
wait: false
- Enregistrez et validez les modifications dans votre référentiel, puis réexécutez le pipeline dans Cloud Manager.
- Surveillez l’exécution du pipeline pour confirmer que le Dispatcher de prévisualisation et les services associés atteignent un état intègre en temps opportun au lieu de rester dans un état de démarrage ou de préchauffage prolongé.
- Après un déploiement réussi, vérifiez que le code du Dispatcher a été déployé comme prévu.
- Si le pipeline prend toujours plus de temps que prévu ou échoue, consultez le Dispatcher et les journaux de service de prévisualisation pour d’autres problèmes de préparation, de contrôle de l’intégrité ou de démarrage.