FAQ relatives à Cloud Manager cloud-manager-faqs
Ce document répond aux questions les plus fréquemment posées par rapport à Cloud Manager pour les clients AMS.
Est-il possible d’utiliser Java 11 avec les builds de Cloud Manager ? java-11
Oui. Vous devez ajouter la variable maven-toolchains-plugin
avec les paramètres appropriés pour Java 11.
- Ce processus est documenté ici.
- Pour obtenir un exemple, reportez-vous à l’ exemple de code de projet wknd.
Ma version échoue et affiche une erreur concernant maven-scr-plugin, après le passage de Java 8 à Java 11. Que puis-je faire ? maven-src-plugin
Votre build AEM Cloud Manager échoue en cas de tentative de basculement de Java 8 à Java 11. Si vous rencontrez l’erreur ci-dessous, vous devez supprimer maven-scr-plugin
et convertir toutes les annotations OSGi en annotations 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]
Pour obtenir des instructions sur la façon de supprimer ce module externe, voir ici.
Mon build échoue avec une erreur mentionnant RequireJavaVersion après la bascule de Java 8 à Java 11. Que puis-je faire ? requirejavaversion
Pour les versions de Cloud Manager, la variable maven-enforcer-plugin
peut échouer à cause de cette erreur.
[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion
Il s’agit d’un problème connu dû au fait que Cloud Manager utilisait une version différente de Java pour exécuter la commande maven plutôt que de compiler le code. Omettez simplement requireJavaVersion
de vos configurations maven-enforcer-plugin
.
La vérification de la qualité du code a échoué et notre déploiement est bloqué. Y a-t-il un moyen de contourner cette vérification ? deployment-stuck
Oui. Tous les échecs de qualité du code, à l’exception de l’évaluation de la sécurité, ne sont pas des mesures critiques ; ils peuvent donc être contournés, dans le cadre d’un pipeline de déploiement, en développant les éléments dans l’interface utilisateur des résultats.
Un utilisateur ayant un rôle de responsable de déploiement, responsable de projet ou propriétaire d’entreprise peut, au choix, contourner les problèmes, auquel cas le pipeline continue, ou les accepter, auquel cas le pipeline s’arrête avec un échec.
Voir les documents Mur à trois niveaux lors de l’exécution d’un pipeline et Configuration de pipelines hors production pour plus d’informations.
Les déploiements de Cloud Manager échouent à l’étape de test de performances dans les environnements Managed Services d’Adobe. Comment déboguer ceci pour passer les mesures critiques ? debug-critical-metrics
Il n’y a pas de réponse unique à cette question. Voici quelques points importants concernant l’étape du test de performance à garder à l’esprit :
-
Il s’agit d’une étape de performances web, c’est-à-dire le temps de chargement de la page sur un navigateur web.
-
Les URL répertoriées dans le fichier CSV de résultats sont chargées dans un navigateur Chrome, dans l’infrastructure de Cloud Manager, au cours du test.
-
Une des mesures échouant couramment est le taux d’erreur.
- Pour qu’une URL soit transmise, l’URL principale doit se charger avec le statut
200
et en moins de20
secondes. - Les chargements de page qui dépassent
20
secondes sont marqués comme des erreurs504
.
- Pour qu’une URL soit transmise, l’URL principale doit se charger avec le statut
-
Si votre site nécessite l’authentification d’utilisateur, consultez le document Comprendre vos résultats de test pour configurer le test et l’authentifier sur votre site.
Pour plus d’informations sur les contrôles de qualité, voir Compréhension des résultats du test .
Puis-je utiliser SNAPSHOT pour la version du projet Maven ? snapshot
Oui. Pour les déploiements de développeurs, les fichiers pom.xml
de la branche Git doivent contenir -SNAPSHOT
à la fin de la valeur <version>
.
Cela permet de continuer à installer le déploiement suivant lorsque la version n’a pas été modifiée. Pour les déploiements de développeurs, aucune version automatique n’est ajoutée ou générée pour la build maven.
Vous pouvez également définir la version sur -SNAPSHOT
pour les builds ou déploiements d’évaluation et de production. Cloud Manager définit automatiquement un numéro de version approprié et crée pour vous une balise dans git. Cette balise peut être référencée ultérieurement, si nécessaire.
De plus amples détails sur la gestion des versions sont documentés ici.
Comment le contrôle de version des packages et des offres groupées fonctionne-t-il pour les déploiements d’évaluation et de production ? staging-production
Dans les déploiements d’évaluation et de production, une version automatique est générée comme documenté ici.
Pour le contrôle de version personnalisé dans les déploiements d’évaluation et de production, définissez une version maven en trois parties, telle que 1.0.0
. Passez à la version supérieure à chaque déploiement en production.
Cloud Manager ajoute automatiquement sa version aux builds d’évaluation et de production et crée même une branche Git. Aucune configuration spécifique n’est nécessaire. Si vous ne définissez pas de version Maven comme décrit précédemment, le déploiement s’effectuera quand même et une version sera automatiquement définie.
Ma build Maven échoue lors des déploiements de Cloud Manager, mais elle est pourtant créée localement sans la moindre erreur. Quel est le problème ? maven-build-fail
Consultez Ressource Git pour plus de détails.
Je ne parviens pas à définir une variable à l’aide d’une commande AIO. Que puis-je faire ? set-variable
Il se peut que vous receviez une erreur 403, comme celle qui suit, lorsque vous tentez de répertorier ou de définir des variables de pipeline par le biais de commandes 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)
Dans ce cas, l’utilisateur exécutant ces commandes doit être ajouté au rôle Responsable de déploiement dans Admin Console.
Consultez Autorisations d’API pour plus d’informations.