La canalización de AEM as a Cloud Service se ha detenido en estado DE EJECUCIÓN debido a problemas con el índice de Oak/Lucene personalizado
En este artículo se explica cómo resolver situaciones en las que una canalización de implementación de Adobe Experience Manager (AEM) as a Cloud Service permanece atascada en el estado EN EJECUCIÓN debido a problemas con los índices personalizados de Oak/Lucene.
Descripción description
Entorno
Adobe Experience Manager as a Cloud Service (AEMaaCS), todas las versiones con canalizaciones de Cloud Manager.
Problema/Síntomas
- La canalización de implementación de Cloud Manager permanece en estado DE EJECUCIÓN durante un período prolongado y no se completa.
- La comprobación de preparación del entorno está bloqueada, lo que impide que la canalización avance.
- Los registros de trabajos de indexación muestran errores como:
Error while processing an index write operation java.io.IOException: Invalid byte range request for [ /oak:index/cqPageLucene-custom-1] ...
- Errores del sistema de archivos como:
java.nio.file.NoSuchFileException
- Los nodos de índice personalizados, como
/oak:index/cqPageLucene-custom-1y/oak:index/damAssetLucene-11-custom-4, aparecen en el repositorio aunque no estén presentes en la base de código actual. - La eliminación manual de estos nodos de índice en CRXDE es solo temporal, ya que pueden volver a aparecer después de la reimplementación.
Causa
La canalización está bloqueada porque la comprobación de disponibilidad del entorno no puede completarse debido a un índice personalizado Oak/Lucene dañado o incoherente. Esto evita que finalice el trabajo de indexación y deja la canalización atascada en el estado EN EJECUCIÓN. La eliminación manual de nodos de índice no es persistente; la eliminación adecuada requiere actualizar la base de código y utilizar el método de administración de índices admitido.
Resolución resolution
Siga los pasos a continuación para resolver el problema:
- Revise los registros del trabajo de indexación e identifique los errores relacionados con los índices personalizados, como
/oak:index/cqPageLucene-custom-1. Confirme si los nodos de índice existen en la base de código bajoui.apps/src/main/content/jcr_root/_oak_index/o en un archivodiff.json. - Busque en el repositorio definiciones de índices problemáticos, como
cqPageLucene-custom-1odamAssetLucene-11-custom-4. Elimine estas definiciones de_oak_indexo de cualquier paquete de contenido de índice y, a continuación, confirme los cambios. - Expresar todos los cambios de índice personalizados en
/oak:index/diff.index/diff.jsonmediante el modelo de administración de índice simplificada. Implemente el código actualizado mediante Cloud Manager. - Después de limpiar el código base y confirmar que solo existen las personalizaciones previstas en
diff.json, vuelva a implementar mediante Cloud Manager. La canalización debería completarse correctamente si no queda ningún índice dañado. - Si el problema persiste, revise los registros para ver si hay errores en el sistema de archivos o daños en el segmento Lucene. Vuelva a generar el índice afectado eliminando el nodo de tiempo de ejecución problemático y volviendo a implementar.
- Después de la reimplementación, la canalización debe completarse correctamente y el entorno debe marcarse como listo.
Notas
- La plataforma genera nuevos nodos
*-custom-*según sea necesario y recupera automáticamente las versiones anteriores que no se usan con el tiempo. - Evite eliminar nodos de índice manualmente en CRXDE como solución permanente, ya que los nodos se pueden volver a crear durante implementaciones posteriores si el código base o
diff.jsonaún hacen referencia a ellos.