Las implementaciones de AEM Cloud Manager DEV fallan debido a errores de XML y ClientLib
En este artículo se explican las causas y los pasos de resolución de los errores de implementación y el aumento de los tiempos de implementación en los entornos DEV de Adobe Experience Manager (AEM) Cloud Manager causados por errores de sintaxis XML y problemas de compilación de la biblioteca de cliente.
Descripción description
Entorno
- Adobe Experience Manager (AEM) Cloud Manager (todas las versiones)
Problema/Síntomas
-
Las implementaciones de DEV tardan mucho más de lo normal (más de dos horas) y, finalmente, fallan durante la fase de implementación.
-
La canalización de la implementación pasa las fases de validación, compilación, prueba de unidades, análisis de código y compilación de imágenes, pero falla en la fase de implementación en DEV.
-
Los registros de implementación muestran errores relacionados con la falta de etiquetas finales XML en paquetes de contenido, como:
El tipo de elemento “content” debe ser terminado por la etiqueta final coincidente "
</content>".El tipo de elemento “header” debe ser terminado por la etiqueta final coincidente "
</header>". -
Las importaciones del paquete de distribución fallan debido a errores de análisis de XML.
-
Biblioteca de cliente (ClientLib) Se producen menos errores de compilación, como variables no definidas (por ejemplo, @white) y mezclas que faltan.
-
Se producen errores de compilación de Java para las clases de modelo personalizadas no resueltas.
-
Anteriormente, estos errores estaban presentes, pero no causaron errores de implementación. Ahora resultan en errores de canalización.
Causa
Se producen errores de implementación debido a errores de sintaxis XML (faltan etiquetas finales), variables o mezclas de bibliotecas de cliente sin resolver y faltan clases de modelos Java personalizados. Los cambios recientes en la canalización o el entorno pueden provocar errores en las implementaciones de estos problemas, incluso si anteriormente no eran bloqueantes.
Resolución resolution
Siga estos pasos para resolver el problema:
- Acceda a los registros de ejecución de la canalización de Cloud Manager para la implementación fallida.
- Identifique todos los errores de análisis XML y de compilación de la biblioteca de cliente.
- Busque los archivos XML a los que se hace referencia, por ejemplo, en
/conf/.../settings/wcm/templates/. - Asegúrese de que todos los elementos XML, como
<content>y<header>, incluyan etiquetas de cierre coincidentes como</content>y</header>. - Valide la estructura XML con un validador XML antes de confirmar los cambios.
- Revise los archivos LESS y CSS para las variables no definidas, como
@whitey@mid-blue, y para las mezclas que faltan, como.label-small-style()y.media(). - Defina las variables y mezclas que faltan, o actualice las importaciones para incluir las definiciones requeridas.
- Vuelva a compilar las bibliotecas de cliente localmente para confirmar que la compilación se ha realizado correctamente.
- Asegúrese de que todas las clases de modelo Sling personalizadas a las que hacen referencia los componentes estén presentes y se importen correctamente en la base de código.
- Resuelva las dependencias que faltan o las referencias de paquete incorrectas.
- Confirme los cambios en el repositorio después de completar las correcciones necesarias.
- Almacene en déclencheur una nueva implementación en Cloud Manager y monitorice la canalización para confirmar que se completa correctamente.