Preguntas frecuentes sobre Cloud Manager cloud-manager-faqs
Este documento proporciona respuestas a las preguntas más frecuentes acerca de Cloud Manager para clientes de AMS.
¿Es posible utilizar Java 11 con generaciones de Cloud Manager? java-11
Sí. Deberá añadir la variable maven-toolchains-plugin
con la configuración correcta para Java 11.
- Este proceso está documentado aquí.
- Para ver un ejemplo, consulte el código del proyecto de ejemplo WKND.
Mi generación falla con un error sobre maven-scr-plugin después de cambiar de Java 8 a Java 11. ¿Qué puedo hacer? maven-src-plugin
Es posible que la generación de AEM Cloud Manager falle al intentar cambiar la generación de Java 8 a 11. Si encuentra el siguiente error, debe eliminar maven-scr-plugin
y convertir todas las anotaciones OSGi a anotaciones OSGi R6.
[main] [ERROR] Failed to execute goal org.apache.felix:maven-scr-plugin:1.26.4:scr (generate-scr-scrdescriptor) on project helloworld.core: /build_root/build/testsite/src/main/java/com/adobe/HelloWorldServiceImpl.java : Unable to load compiled class: com.adobe.HelloWorldServiceImpl: com/adobe/HelloWorldServiceImpl has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0 -> [Help 1]
Para obtener instrucciones sobre cómo quitar este complemento, haga clic aquí.
Mi generación falla con un error sobre RequireJavaVersion después de cambiar de Java 8 a Java 11. ¿Qué puedo hacer? requirejavaversion
Para las compilaciones de Cloud Manager, el maven-enforcer-plugin
puede fallar con este error
[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion
Este es un problema conocido debido a que Cloud Manager utiliza una versión diferente de Java para ejecutar el comando de Maven, en comparación con el código de compilación. Omita requireJavaVersion
de su configuraciones de maven-enforcer-plugin
.
La comprobación de calidad del código ha fallado y nuestra implementación está atascada. ¿Hay alguna manera de saltarse esta comprobación? deployment-stuck
Sí. Todos los errores de calidad del código, excepto las clasificaciones de seguridad, son métricas no críticas. Como tal, se pueden evitar como parte de una canalización de implementación expandiendo los elementos en la interfaz de usuario de los resultados.
Un usuario con la función Administrador de implementación, Administrador de proyectos o Propietario empresarial puede anular los problemas. En tal caso, la canalización continúa. O bien, pueden aceptar los problemas, en cuyo caso la canalización se detiene con un error.
Vea los documentos Puertas de tres niveles al ejecutar una canalización y Configuración de canalizaciones que no son de producción para obtener más información.
Las implementaciones de Cloud Manager fallan en el paso de prueba de rendimiento en los entornos de Adobe Managed Services. ¿Cómo se puede depurar este problema para superar las métricas esenciales? debug-critical-metrics
No hay una respuesta única a esta pregunta. Sin embargo, puede encontrar útiles los siguientes puntos sobre el paso de la prueba de rendimiento:
- Este paso es de rendimiento web. Es decir, es aproximadamente el momento de cargar la página mediante un explorador web.
- Las direcciones URL enumeradas en el archivo .csv resultante se cargan en un explorador Chrome en la infraestructura de Cloud Manager durante la prueba.
- Una métrica común que falla es la tasa de error. Para que una URL supere la prueba, la URL principal debe cargarse con el estado
200
y en menos de20
segundos. Si la carga de una página supera los20
segundos, se marca como un error504
. - Si el sitio requiere autenticación de usuario, consulte el documento Comprensión de los resultados de la prueba para configurar la prueba para autenticarse en el sitio.
Consulte el documento Comprensión de los resultados de la prueba para obtener más información sobre los controles de calidad.
¿Puedo utilizar SNAPSHOT para la versión del proyecto de Maven? snapshot
Sí. Para implementaciones de desarrolladores, los archivos de la rama de Git pom.xml
deben contener -SNAPSHOT
al final del valor <version>
.
Esto permite que la implementación posterior se siga instalando si la versión no ha cambiado. En implementaciones de desarrolladores, no se agrega ni se genera ninguna versión automática para la generación de Maven.
También puede establecer la versión a -SNAPSHOT
para generaciones o implementaciones de fase y producción. Cloud Manager establece automáticamente un número de versión adecuado y crea una etiqueta para usted en Git. Se puede hacer referencia a esta etiqueta más adelante, si es necesario.
Para obtener más información sobre la administración de versiones, consulte estos documentos.
¿Cómo funcionan las versiones de paquetes y los paquetes para las implementaciones de ensayo y producción? staging-production
En las implementaciones de ensayo y producción se genera una versión automática como se documenta aquí.
Para las versiones personalizadas en las implementaciones de fase y producción, establezca una versión de Maven adecuada como 1.0.0
. Actualice la versión cada vez que implemente en la producción.
Cloud Manager añade automáticamente su versión a las compilaciones de ensayo y producción y crea una rama de Git. No se requiere ninguna configuración especial. Si no establece una versión de Maven como se describió anteriormente, la implementación se realiza correctamente y se establece una versión automáticamente.
Mi generación de Maven falla en las implementaciones de Cloud Manager, pero se genera localmente sin errores. ¿Qué está mal? maven-build-fail
Consulte este recurso de Git para obtener más información.
No puedo establecer una variable mediante un comando aio. ¿Qué puedo hacer? set-variable
Puede recibir un error 403 como el siguiente cuando intenta enumerar o establecer variables de canalización a través de comandos aio
.
$ aio cloudmanager:list-pipeline-variables 222
Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)
$ aio cloudmanager:set-pipeline-variables 222 --variable TEST 1
Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)
$ aio cloudmanager:set-environment-variables 1755 --variable TEST 1
setting variables... !
Cannot set variables: https://cloudmanager.adobe.io/api/program/111/environment/222/variables (403 Forbidden)
En este caso, el usuario que ejecuta estos comandos debe añadirse a la función Administrador de implementación en Admin Console.
Consulte Permisos de la API para obtener más información.