FAQ relatives à Cloud Manager

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 ?

Oui. Vous devez ajouter la variable maven-toolchains-plugin avec les paramètres appropriés pour Java 11.

• Ce processus est documenté ici.
• Par 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 ?

Votre version de Cloud Manager AEM peut échouer lorsque vous tentez de passer de Java 8 à 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 découvrir les instructions sur la suppression de ce plug-in, voir ici.

Ma version échoue et affiche une erreur concernant RequireJavaVersion, après le passage de Java 8 à Java 11. Que puis-je faire ?

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 ?

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 ?

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 de 20 secondes.
  • Les chargements de page qui dépassent 20 secondes sont marqués comme des erreurs 504.
• 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.

Consultez le document Comprendre vos résultats de test pour plus d’informations sur les vérifications de qualité.

Puis-je utiliser SNAPSHOT pour la version du projet Maven ?

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 conserver les déploiements ultérieurs alors que 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 une balise pour vous 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 ?

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 appropriée en trois parties, comme 1.0.0. Passez à la version supérieure à chaque déploiement en production.

Cloud Manager ajoute automatiquement sa version aux versions d’évaluation et de production et crée 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 ?

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 ?

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.