Resolver errores de canalización de AEM as a Cloud Service durante las actualizaciones de índice
En este artículo se explica cómo resolver los errores en la canalización de Cloud Manager de AEM as a Cloud Service que se producen durante el paso de actualización del índice después de implementar definiciones de índice personalizadas o extendidas. La guía cubre causas comunes y pasos procesables para garantizar implementaciones exitosas.
Descripción description
Entorno
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Síntomas
- Errores de canalización que indican problemas al recuperar nuevas definiciones de índice
- Advertencias de validación relacionadas con los archivos de configuración de índice
Causa
Las causas raíz suelen incluir discrepancias entre las definiciones de índice personalizadas y las versiones de índice listas para usar (OOTB) en el entorno de destino, configuraciones de Tika incompletas o no válidas, o prácticas incorrectas de asignación de nombres y versiones de índice.
Resolución resolution
Siga los pasos a continuación para resolver el problema:
- Compare sus definiciones de índice personalizadas con las definiciones de índice OOTB en el entorno de destino. Obtenga la última definición de índice OOTB (por ejemplo, damAssetLucene-14) desde un entorno de AEM as a Cloud Service que ejecute la misma versión o una más reciente que el entorno de destino.
- Combine los cambios personalizados en la definición de OOTB más reciente y asigne un nombre personalizado con versiones adecuado (por ejemplo, damAssetLucene-14-custom-2). No dé por hecho que la versión de OOTB en el entorno de desarrollo coincide con la versión en otros entornos.
- Valide la configuración de Tika en la definición de índice personalizada. Asegúrese de que el subárbol Tika completo esté presente y sea válido, incluido el archivo tika/ folder, config.xml, jcr:content, jcr:data y jcr:mimeType establecido en application/xml. Evite las invalidaciones parciales o los nodos config.xml vacíos.
- Siga las convenciones de nomenclatura de AEM as a Cloud Service para los índices personalizados. Para índices totalmente personalizados, utilice un nombre y una versión personalizados únicos (por ejemplo, -custom-1). Para las extensiones de índices OOTB, utilice el patrón de asignación de nombres y versiones de OOTB. No cambie el nombre de los nodos de índice implementados ni los elimine directamente en el entorno de nube.
- Confirme que todas las definiciones de índice se encuentran en ui.apps/src/main/content/jcr_root/_oak_index y que se incluyen en el paquete de código de la aplicación, no en un paquete de contenido mutable. Asegúrese de que los metadatos del paquete incluyen allowIndexDefinitions=true y noIntermediateSaves=true. Todas las definiciones de índice deben utilizar una configuración de Lucene compatible con la nube y una configuración asincrónica admitida (como
[async],[async, nrt]o[fulltext-async]). - Implemente el paquete revisado en un entorno inferior y compruebe que la implementación se completa correctamente, que están presentes las definiciones de índice esperadas y que las consultas utilizan los índices deseados.
- Para retirar las definiciones de índice antiguas, no cambie el nombre de los nodos de índice ni los elimine directamente. En su lugar, gestione la retirada como un cambio de código independiente a través de Cloud Manager. Al eliminar entradas únicamente de filter.xml, no se eliminan los datos de índice implementados. Utilice una definición de índice compatible posterior para desactivar el índice anterior y hacer que sea apto para la limpieza periódica.
Después de completar estos pasos, vuelva a ejecutar la canalización y compruebe que la implementación se realiza correctamente y que los índices deseados están activos.