Depuración de la compilación y las implementaciones de AEM as a Cloud Service
Adobe Cloud Manager facilita la compilación del código y las implementaciones en AEM as a Cloud Service. Pueden producirse errores durante los pasos del proceso de generación, que requieren acciones para resolverlos. Esta guía explica cómo comprender los errores comunes de en la implementación y cómo abordarlos mejor.
Validación
El paso de validación simplemente garantiza que las configuraciones básicas de Cloud Manager sean válidas. Los errores de validación comunes incluyen:
El entorno está en un estado no válido
- Mensaje de error: El entorno está en un estado no válido.
- Causa: El entorno de destino de la canalización se encuentra en un estado de transición en el que no puede aceptar nuevas compilaciones.
- Resolución: Espere a que el estado se resuelva en un estado en ejecución (o actualización disponible). Si se elimina el entorno, vuelva a crearlo o elija un entorno diferente al que compilar.
No se encuentra el entorno asociado a la canalización
- Mensaje de error: El entorno está marcado como eliminado.
- Causa: Se ha eliminado el entorno que la canalización está configurada para usar.
Incluso si se vuelve a crear un nuevo entorno con el mismo nombre, Cloud Manager no vuelve a asociar automáticamente la canalización a ese entorno con el mismo nombre. - Resolución: Edite la configuración de la canalización y vuelva a seleccionar el entorno en el que desea realizar la implementación.
No se encuentra la rama Git asociada a la canalización
- Mensaje de error: Canalización no válida: XXXXXX. Motivo=No se encuentra Branch=xxxx en el repositorio.
- Causa: Se ha eliminado la rama Git que la canalización está configurada para usar.
- Resolución: Vuelva a crear la rama Git que falta con el mismo nombre o vuelva a configurar la canalización para que se genere a partir de una rama diferente existente.
Prueba de compilación y unidad
La fase Prueba de generación y unidad realiza una generación Maven (mvn clean package) del proyecto desprotegido de la rama Git configurada de la canalización.
Los errores identificados en esta fase deben ser reproducibles generando el proyecto localmente, con las siguientes excepciones:
-
Se usa una dependencia Maven no disponible en Maven Central, y el repositorio Maven que contiene la dependencia es:
- No accesible desde Cloud Manager, como un repositorio Maven interno privado, o el repositorio Maven requiere autenticación y se han proporcionado credenciales incorrectas.
- No se registró explícitamente en
pom.xmldel proyecto. Tenga en cuenta que, no se recomienda incluir repositorios Maven, ya que aumenta los tiempos de compilación.
-
Las pruebas unitarias fallan debido a problemas de sincronización. Esto puede ocurrir cuando las pruebas unitarias son sensibles al tiempo. Un indicador seguro se basa en
.sleep(..)en el código de prueba. -
El uso de complementos de Maven no compatibles.
Escaneado de códigos
AEM La digitalización de código realiza un análisis de código estático mediante una combinación de prácticas recomendadas específicas de Java y de la aplicación de código de la aplicación.
El análisis del código provoca un error de compilación si existen vulnerabilidades de seguridad críticas en el código. Las infracciones menores se pueden anular, pero se recomienda corregirlas. Tenga en cuenta que el análisis de código es imperfecto y puede dar como resultado falsos positivos.
Para resolver los problemas de digitalización de código, descargue el informe en formato CSV proporcionado por Cloud Manager mediante el botón Descargar detalles y revise las entradas.
Para obtener más información, consulte reglas específicas de la de Cloud Manager AEM reglas de digitalización de código específicas de la aplicación personalizada de la documentación de AEM.
Generar imágenes
AEM La creación de imagen es responsable de combinar los artefactos de código creados en el paso Generar y prueba de unidad con la versión de la aplicación para formar un único artefacto que se puede implementar.
AEM Aunque se encuentran problemas de compilación y compilación de código durante las pruebas de compilación y unidad, puede haber problemas de configuración o estructurales identificados al intentar combinar el artefacto de compilación personalizada con la versión de la versión de la.
Duplicar configuraciones de OSGi
AEM Cuando varias configuraciones de OSGi se resuelven mediante el modo de ejecución para el entorno de segmentación de datos, el paso Generar imagen falla con el siguiente error:
[ERROR] Unable to convert content-package [/tmp/packages/enduser.all-1.0-SNAPSHOT.zip]:
Configuration 'com.example.ExampleComponent' already defined in Feature Model 'com.example.groupId:example.all:slingosgifeature:xxxxx:X.X',
set the 'mergeConfigurations' flag to 'true' if you want to merge multiple configurations with same PID
Causa 1
- AEM Causa: El paquete completo del proyecto de la, contiene varios paquetes de código y la misma configuración OSGi la proporciona más de uno de los paquetes de código, lo que da como resultado un conflicto, y el paso Generar imagen no puede decidir cuál debe usarse, lo que provoca que se produzca un error en la compilación. Tenga en cuenta que esto no se aplica a las configuraciones de fábrica de OSGi, siempre y cuando tengan nombres únicos.
- AEM Resolución: Revise todos los paquetes de código (incluidos los paquetes de código de terceros incluidos) que se están implementando como parte de la aplicación de, buscando configuraciones de OSGi duplicadas que se resuelvan, a través del modo de ejecución, en el entorno de destino. AEM La guía del mensaje de error "set the mergeConfigurations flag to true" no es posible en as a Cloud Service y debe ignorarse.
Causa 2
- AEM Causa: El proyecto de incluye incorrectamente el mismo paquete de código dos veces, lo que da como resultado la duplicación de cualquier configuración OSGi contenida en dicho paquete.
- Resolución: Revise todos los pom.xml de paquetes incrustados en el proyecto all y asegúrese de que tienen
filevault-package-maven-pluginconfiguración establecida en<cloudManagerTarget>none</cloudManagerTarget>.
Script de repoinit mal formado
Los scripts de repoinit definen el contenido de línea de base, los usuarios, las ACL, etc. En AEM as a Cloud Service AEM, los scripts de repoinit se aplican durante la compilación de la imagen, pero en el inicio rápido local del SDK de la aplicación se aplican cuando se activa la configuración de fábrica de repoinit de OSGi. AEM Debido a esto, los scripts de Repoinit pueden fallar silenciosamente (con registro) en el inicio rápido local del SDK de la aplicación, pero hacen que el paso Generar imagen falle, lo que detiene la implementación.
- Causa: Un script de repoinit tiene un formato incorrecto. Esto puede dejar el repositorio en un estado incompleto, ya que los scripts de repoinit después del script que falla no se ejecutan en el repositorio.
- AEM Resolución: Revise el inicio rápido local del SDK de cuando se implemente la configuración OSGi del script de repoinit para determinar si se producen errores y cuáles se producen.
Dependencia de contenido de repoinit no satisfecha
Los scripts de repoinit definen el contenido de línea de base, los usuarios, las ACL, etc. AEM En el inicio rápido local del SDK de la, los scripts repoinit se aplican cuando se activa la configuración de fábrica de repoinit OSGi, o en otras palabras, después de que el repositorio esté activo y pueda haber sufrido cambios de contenido directamente o a través de paquetes de contenido. En AEM as a Cloud Service, los scripts de repoinit se aplican durante la generación de imágenes en un repositorio del que puede no depender el script repoinit.
- Causa: Un script de repoinit depende de contenido que no existe.
- Resolución: Asegúrese de que el contenido del script repoinit depende de que exista. A menudo, esto indica un script de repoinit inadecuadamente definido al que le faltan directivas que definen estas estructuras de contenido que faltan, pero que son obligatorias. AEM AEM Esto se puede reproducir localmente eliminando el Jar, desempaquetándolo, agregando la configuración OSGi de repoinit que contiene el script de repoinit a la carpeta de instalación e iniciando el proceso de instalación de la. AEM El error se presentará en el error.log del inicio rápido local del SDK de la.
La versión de los componentes principales de la aplicación es mayor que la versión implementada
AEM Este problema solo afecta a los entornos que no son de producción y que NO se actualizan automáticamente a la última versión de la versión de la versión de la versión.
AEM as a Cloud Service AEM incluye automáticamente la última versión de los componentes principales en cada versión de los componentes principales, es decir, después de actualizar un entorno de AEM as a Cloud Service, de forma automática o manual, se le implementa la última versión de los componentes principales.
Es posible que el paso Generar imagen falle cuando:
- La aplicación de implementación actualiza la versión de dependencia Maven de los componentes principales en el proyecto
core(paquete OSGi) - A continuación, la aplicación de implementación se implementa en un entorno AEM as a Cloud Service AEM de zona protegida (que no sea de producción) que no se ha actualizado para utilizar una versión de que contenga esa nueva versión de componentes principales.
Para evitar este error, siempre que haya una actualización disponible del entorno de AEM as a Cloud Service, incluya la actualización como parte de la siguiente generación o implementación y asegúrese siempre de que las actualizaciones se incluyan después de incrementar la versión de los componentes principales en la base de código de la aplicación.
-
Síntomas:
El paso Generar imagen falla con un informe de ERROR que indica que el proyectocoreno pudo importar los paquetes decom.adobe.cq.wcm.core.components...en intervalos de versiones específicos.code language-none [ERROR] Bundle com.example.core:0.0.3-SNAPSHOT is importing package(s) Package com.adobe.cq.wcm.core.components.models;version=[12.13,13) in start level 20 but no bundle is exporting these for that start level in the required version range. [ERROR] Analyser detected errors on feature 'com.adobe.granite:aem-ethos-app-image:slingosgifeature:aem-runtime-application-publish-dev:1.0.0-SNAPSHOT'. See log output for error messages. [INFO] ------------------------------------------------------------------------ [INFO] BUILD FAILURE [INFO] ------------------------------------------------------------------------ -
Causa: El paquete OSGi de la aplicación (definido en el proyecto
core) importa las clases Java de la dependencia principal de los componentes principales en un nivel de versión diferente al que se implementa en AEM as a Cloud Service. -
Resolución:
- Con Git, revierta a una confirmación de trabajo que exista antes del incremento de la versión del componente principal. Envíe esta confirmación a una rama de Git de Cloud Manager y realice una actualización del entorno desde esta rama. Esto actualizará AEM as a Cloud Service AEM a la última versión de la, que incluirá la versión posterior de los componentes principales. Una vez que AEM as a Cloud Service AEM se actualice a la última versión de la versión de la, que tendrá la última versión de componentes principales, vuelva a implementar el código que falló originalmente.
- AEM AEM Para reproducir este problema localmente, asegúrese de que la versión del SDK de la sea la misma versión de la versión que utiliza el entorno de AEM as a Cloud Service.
Creación de un caso de soporte de Adobe
Si los enfoques de solución de problemas anteriores no resuelven el problema, cree un caso de soporte de Adobe a través de:
-
Adobe Admin Console > Pestaña Asistencia > Crear caso
Si es miembro de varias organizaciones de Adobe, asegúrese de que la organización de Adobe que tiene una canalización con errores esté seleccionada en el conmutador de organizaciones de Adobe antes de crear el caso.
Implementar en
AEM El paso Implementar en es responsable de tomar el artefacto de código generado en Generar imagen, inicia nuevos servicios de Autor y Publish AEM que lo utilizan y, una vez finalizado correctamente, elimina cualquier servicio antiguo de Autor y Publish de la. Los paquetes de contenido mutable y los índices también se instalan y actualizan en este paso.
Familiarícese con los registros de AEM as a Cloud Service antes de depurar el paso Implementar en. El registro aemerror contiene información sobre el inicio y el cierre de los pods que puede ser relevante para la implementación en problemas. Tenga en cuenta que el registro disponible a través del botón Descargar registro en el paso Implementar en de Cloud Manager no es el registro aemerror y no contiene información detallada relativa al inicio de las aplicaciones.
Las tres razones principales por las que el paso Implementar en puede fallar:
La canalización de Cloud Manager AEM tiene una versión antigua de la
-
Causa: Una canalización de Cloud Manager AEM contiene una versión anterior a la implementada en el entorno de destino, que es más antigua que la versión de la que se implementa en el entorno de destino. AEM Esto puede ocurrir cuando se reutiliza una canalización y se dirige a un nuevo entorno que ejecuta una versión posterior de la misma AEM AEM Esto se puede identificar comprobando si la versión del entorno en la que se realiza el envío es mayor que la versión de la canalización que se ha creado para el envío de la lista de versiones de la canalización.
-
Resolución:
- Si el entorno de destino tiene una actualización disponible, seleccione Actualizar en las acciones del entorno y, a continuación, vuelva a ejecutar la compilación.
- AEM Si el entorno de destino no tiene una actualización disponible, significa que está ejecutando la última versión de la aplicación de. Para resolver esto, elimine la canalización y vuelva a crearla.
Tiempo de espera de Cloud Manager
AEM El código que se ejecuta durante el inicio del servicio de implementación recién implementado tarda tanto tiempo que Cloud Manager agota el tiempo de espera antes de que se complete la implementación. En estos casos, la implementación puede tener éxito, incluso aunque se haya notificado el estado Error en Cloud Manager.
- AEM Causa: El código personalizado puede ejecutar operaciones, como consultas grandes o travesías de contenido, desencadenadas al principio del paquete OSGi o de los ciclos de vida del componente, lo que retrasa significativamente el tiempo de inicio de la actividad de la aplicación.
- AEM Resolución: Revise la implementación para el código que se ejecuta al principio del ciclo de vida del paquete OSGi, y revise los registros de
aemerrorpara los servicios de Autor y Publish alrededor del momento del error (hora de registro en GMT) tal y como se muestra en Cloud Manager, y busque los mensajes de registro que indiquen cualquier proceso de registro personalizado que se esté ejecutando.
Código o configuración no compatibles
La mayoría de las infracciones de código y configuración se capturan anteriormente en la compilación, pero es posible que el código personalizado o la configuración sean incompatibles con AEM as a Cloud Service y no se detecten hasta que se ejecuten en el contenedor.
-
AEM Causa: El código personalizado puede invocar operaciones largas, como consultas grandes o ventas transversales de contenido, desencadenadas al principio del paquete OSGi o de los ciclos de vida del componente, lo que retrasa significativamente el tiempo de inicio de la actividad de la aplicación.
-
AEM Resolución: Revise los registros de
aemerrorpara los servicios de Autor y Publish de la hora (hora del registro en GMT) de la falla, tal y como muestra Cloud Manager.- Revise los registros para ver si hay ERRORES producidos por las clases Java proporcionadas por la aplicación personalizada. Si se encuentra algún problema, resuelva, inserte el código corregido y vuelva a compilar la canalización.
- AEM Revise los registros para ver si hay ALGÚN ERROR notificado por aspectos de la aplicación personalizada con los que esté ampliando o interactuando e investigue dichos errores; es posible que estos errores no se atribuyan directamente a clases Java. Si se encuentra algún problema, resuelva, inserte el código corregido y vuelva a compilar la canalización.
Inclusión de /var en el paquete de contenido
/var es mutable y contiene una variedad de contenido transitorio en tiempo de ejecución. Incluyendo /var en paquetes de contenido (p. ej. ui.content) implementado mediante Cloud Manager puede provocar errores en el paso Implementación.
Este problema es difícil de identificar, ya que no provoca un error en la implementación inicial, solo en implementaciones posteriores. Los síntomas notables incluyen:
- AEM La implementación inicial se realiza correctamente; sin embargo, el contenido mutable nuevo o modificado, que forma parte de la implementación, no parece existir en el servicio de Publish de la.
- AEM Se ha bloqueado la activación o desactivación de contenido en el autor de la
- Las implementaciones posteriores fallan en el paso Implementar en y el paso Implementar en falla después de aproximadamente 60 minutos.
Para validar este problema, la causa del comportamiento fallido es:
-
Determinando que al menos un paquete de contenido que forma parte de la implementación escribe en
/var. -
Compruebe que la cola de distribución principal (en negrita) está bloqueada en:
-
AEM Autor de la > Herramientas > Implementación > Distribución
-
-
En las implementaciones posteriores que produzcan errores, descargue los registros "Implementar en" de Cloud Manager con el botón Descargar registro:
… y compruebe que haya aproximadamente 60 minutos entre las instrucciones de registro:
code language-none 2020-01-01T01:01:02+0000 Begin deployment in aem-program-x-env-y-dev [CorrelationId: 1234]… y …
code language-none 2020-01-01T02:04:10+0000 Failed deployment in aem-program-x-env-y-devTenga en cuenta que este registro no contendrá estos indicadores en las implementaciones iniciales que informan como exitosas, sino solo en implementaciones fallidas posteriores.
-
AEM AEM Causa: El usuario del servicio de replicación de la que se usó para implementar paquetes de contenido en el servicio de Publish AEM no puede escribir en
/varen el servicio de replicación de la aplicación de Publish. AEM Esto provoca que la implementación del paquete de contenido en el servicio de Publish de la falle. -
Resolución: Las siguientes maneras de resolver estos problemas se enumeran en el orden de preferencia:
- Si los recursos de
/varno son necesarios, quite los recursos de/varde los paquetes de contenido que se implementan como parte de la aplicación. - Si los recursos de
/varson necesarios, defina las estructuras de nodos mediante repoinit. AEM AEM Los scripts Repoinit se pueden dirigir a los modos de ejecución de OSGi para que se dirijan a los autores de la, a los Publish o a ambos. - AEM AEM AEM Si los recursos de
/varsolo son necesarios para el autor de la y no se pueden modelar razonablemente con repoinit, muévalos a un paquete de contenido discreto que solo esté instalado en el autor de la misma o por incrustarlo en el paqueteallde una carpeta de modo de ejecución de la instancia de autor o de ejecución (<target>/apps/example-packages/content/install.author</target>). - Proporcione ACL apropiados al usuario de servicio
sling-distribution-importertal como se describe en este Adobe KB.
- Si los recursos de
Creación de un caso de soporte de Adobe
Si los enfoques de solución de problemas anteriores no resuelven el problema, cree un caso de soporte de Adobe a través de:
-
Adobe Admin Console > Pestaña Asistencia > Crear caso
Si es miembro de varias organizaciones de Adobe, asegúrese de que la organización de Adobe que tiene una canalización con errores esté seleccionada en el conmutador de organizaciones de Adobe antes de crear el caso.