Le déploiement de l’index personnalisé échoue lors de la migration SIM dans AEM as a Cloud Service

Cet article explique comment résoudre les échecs de déploiement dans Adobe Experience Manager as a Cloud Service qui se produisent lorsque les index personnalisés sont bloqués dans un état asynchrone temporaire pendant la migration vers la gestion simplifiée des index (SIM). La solution recommandée implique la réinitialisation de l’environnement et la réintroduction incrémentielle d’index personnalisés.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service
  • Gestion simplifiée des index (SIM)

Symptômes

  • Les pipelines de déploiement échouent lors de la migration vers SIM.
  • Les index personnalisés sont bloqués au statut « migration en cours ».
  • Les propriétés d’index incluent async = temp-async,nrt et async-previous = async,nrt.
  • Les messages du journal incluent des erreurs telles que Échec lors de l’application des données d’indexation et Aucun point de contrôle actuel trouvé pour la piste [ asynchrone, nrt].

Cause

Ce problème se produit lorsque plusieurs index personnalisés sont migrés simultanément, ce qui laisse la tâche d’indexation dans un état incohérent qui ne peut pas être résolu automatiquement.

Résolution resolution

Pour résoudre ce problème, procédez comme suit.

  1. Supprimez temporairement les index personnalisés concernés de votre configuration SIM ou commentez leurs entrées dans votre fichier de comparaison d’index.

  2. Dans les environnements de création AEM disposant d’un accès CRXDE, tels que les environnements de développement ou locaux, supprimez les nœuds d’index affectés sous /oak:index pour chaque index personnalisé problématique.

  3. Pour les environnements de publication et de prévisualisation dans AEM as a Cloud Service, où l’accès direct à CRXDE n’est pas disponible, réinitialisez l’environnement à l’aide de Cloud Manager. Remarque : cette action lance l’auteur, la publication et la prévisualisation avec un référentiel propre.

  4. Exécutez un pipeline Cloud Manager qui n’inclut aucun index personnalisé. Vérifiez que l’étape d’indexation s’est terminée sans erreur.

  5. Réintroduisez les index personnalisés de manière incrémentielle via SIM :

    • Ajoutez un index personnalisé à la fois.
    • Exécutez le pipeline Cloud Manager après chaque ajout.
  6. Après chaque déploiement, vérifiez la configuration de l’index sur l’auteur :

    • Vérifiez que l’index a async = [ "async","nrt" ].
    • Vérifiez que l’index ne contient pas de propriété async-previous.
    • Vérifiez qu’il n’existe qu’une seule version active de chaque index personnalisé dans la base de code.
    • Vérifiez que l’index n’est pas laissé dans un état temp-async.
  7. Vérifiez que le pipeline Cloud Manager s’est terminé correctement et que la fonctionnalité affectée fonctionne comme prévu.

Remarques :

  • Les modifications de configuration d’index pour AEM as a Cloud Service doivent être gérées dans le code de base du projet et déployées via Cloud Manager.
  • Lors de la résolution des problèmes de plusieurs index personnalisés, réintroduisez-les un par un pour identifier l’index associé à l’échec de déploiement.
  • Si le déploiement continue d’échouer une fois les index isolés et réintroduits de manière incrémentielle, contactez l’assistance 🔗 via le processus d’assistance standard.

Lecture connexe

recommendation-more-help
experience-cloud-kcs-help-kbarticles