Pipeline AEM as a Cloud Service bloqué en état D’EXÉCUTION en raison de problèmes d’index Oak/Lucene personnalisés

Dernière mise à jour : 30 août 2026

Cet article explique comment résoudre les situations où un pipeline de déploiement Adobe Experience Manager (AEM) as a Cloud Service reste bloqué en état D’EXÉCUTION en raison de problèmes liés aux index Oak/Lucene personnalisés.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS), toutes les versions utilisant les pipelines Cloud Manager.

Problème/Symptômes

Le pipeline de déploiement de Cloud Manager reste à l’état EN COURS d’EXÉCUTION pendant une période prolongée et ne se termine pas.
La vérification de la préparation de l’environnement est bloquée, ce qui empêche la progression du pipeline.
Les journaux des tâches d’indexation affichent des erreurs telles que :

Error while processing an index write operation java.io.IOException: Invalid byte range request for [ /oak:index/cqPageLucene-custom-1] ...

Erreurs de système de fichiers telles que :

java.nio.file.NoSuchFileException

Les nœuds d’index personnalisés, tels que /oak:index/cqPageLucene-custom-1 et /oak:index/damAssetLucene-11-custom-4, apparaissent dans le référentiel même s’ils ne sont pas présents dans la base de code actuelle.
La suppression manuelle de ces nœuds d’index dans CRXDE n’est que temporaire, car ils peuvent réapparaître après le redéploiement.

Cause

Le pipeline est bloqué, car la vérification de la préparation de l’environnement ne peut pas se terminer en raison d’un index personnalisé Oak/Lucene corrompu ou incohérent. Cela empêche la tâche d’indexation de se terminer, laissant le pipeline bloqué à l’état EN COURS D’EXÉCUTION. La suppression manuelle des nœuds d’index n’est pas persistante ; une suppression correcte nécessite la mise à jour de la base de code et l’utilisation de l’approche de gestion des index prise en charge.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

Consultez les journaux des tâches d’indexation et identifiez les erreurs liées aux index personnalisés, tels que les /oak:index/cqPageLucene-custom-1. Vérifiez si les nœuds d’index existent dans la base de code sous ui.apps/src/main/content/jcr_root/_oak_index/ ou dans un fichier diff.json.
Recherchez dans le référentiel des définitions des index problématiques, tels que cqPageLucene-custom-1 ou damAssetLucene-11-custom-4. Supprimez ces définitions de _oak_index ou de tout package de contenu d’index, puis validez les modifications.
Exprimez toutes les modifications d’index personnalisées dans /oak:index/diff.index/diff.json à l’aide du modèle de gestion simplifiée des index . Déployez le code mis à jour via Cloud Manager.
Après avoir nettoyé la base de code et confirmé que seules les personnalisations prévues existent dans diff.json, redéployez via Cloud Manager. Le pipeline doit se terminer correctement si aucune corruption d’index ne subsiste.
Si le problème persiste, consultez les journaux pour rechercher des erreurs de système de fichiers ou une corruption du segment Lucene. Recréez l’index affecté en supprimant le nœud d’exécution problématique et en procédant à un redéploiement.
Après le redéploiement, le pipeline doit se terminer correctement et l’environnement doit être marqué comme prêt.

Notes

La plateforme génère de nouveaux nœuds *-custom-* selon les besoins et supprime automatiquement les anciennes versions inutilisées au fil du temps.
Évitez de supprimer manuellement les nœuds d’index dans CRXDE en tant que solution permanente, car les nœuds peuvent être recréés lors de déploiements ultérieurs si la base de code ou le diff.json les référence toujours.

Lecture connexe

Recherche et indexation de contenu

recommendation-more-help

experience-cloud-kcs-help-kbarticles