AEM as a Cloud Service Developer Console developer-console
AEM as a Cloud Service Developer Console comprend un ensemble d’outils en lecture seule pour le débogage des environnements cloud. Il est accessible par le biais d’un lien spécifique à l’environnement dans Cloud Manager et offre des fonctionnalités permettant d’afficher les lots, les paramètres OSGi, les services et les servlets, etc.
- Le Developer Console AEM (Cloud Service) ne doit pas être confondu avec le Adobe Developer Console. dont le nom est similaire
Accès à AEM Developer Console
Pour accéder au Developer Console AEM et l’utiliser, les autorisations suivantes doivent être accordées à l’Adobe ID du développeur via Adobe Admin Console.
- Assurez-vous que dans le sélecteur d’organisation d’Adobe, l’organisation Adobe associée aux environnements que vous souhaitez inspecter s’affiche dans AEM Developer Console.
- Pour pouvoir se connecter à AEM Developer Console, le développeur doit appartenir à l’un des rôles suivants :
+ Profil de produit Cloud Manager Développeur - Cloud Service : dans ce cas, le développeur voit la liste complète des environnements disponibles sous l’URL AEM Developer Console sélectionnée. Si un environnement de développement ou un RDE a été sélectionné dans Cloud Manager, d’autres environnements de développement ou RDE de ce même programme peuvent apparaître.
+ Profil produit Administrateurs et administratrices AEM sur l’instance de création AEM : dans ce cas, la liste des environnements décrite dans la puce précédente sera limitée aux profils de produit associés auxquels ce rôle est affecté. - La personne chargée du développement doit être membre du profil de produit des Utilisateurs et utilisatrices AEM ou des Administrateurs et administratrices AEM sur l’instance de création et/ou de publication d’AEM.
+ Si cette appartenance n’existe pas, le rejet du Statut expirera avec une erreur 401 Unauthorized (non autorisé).
Effacez les cookies de votre navigateur ainsi que l’état de l’application (stockage local) et reconnectez-vous à AEM Developer Console
Résolution des problèmes d’accès à AEM Developer Console
Lorsque je me connecte, je ne vois pas l’environnement que je recherche.
Vérifiez les éléments suivants :
+ Vous avez sélectionné l’URL AEM Developer Console appropriée en cliquant sur les trois points de l’environnement sélectionné via Cloud Manager et en sélectionnant AEM Developer Console.
+ Vous disposez soit du Profil produit Développeur ou développeuse - Cloud Service du produit Cloud Manager pour afficher la liste complète des environnements, soit vous faites partie du profil produit Administrateurs et administratrices AEM sur l’instance de création AEM pour l’environnement que vous ne trouvez pas.
Erreur 401 Unauthorized (non autorisé) lors du rejet du statut
Pour résoudre le problème non autorisé :
- Assurez-vous que votre utilisateur est membre du profil de produit Adobe IMS approprié (Administrateurs AEM ou Utilisateurs AEM) pour l’instance de produit AEM as a Cloud Service associée à AEM Developer Console.
+ N’oubliez pas que le Developer Console AEM accède à 2 instances de produit Adobe IMS, c’est-à-dire les instances de produit Création et Publication AEM as a Cloud Service. Assurez-vous donc que les profils de produit corrects sont utilisés en fonction du niveau de service auquel l’accès via le Developer Console AEM est nécessaire. - Patientez jusqu’à 30 minutes pour que l’abonnement au profil de produit Adobe IMS se synchronise dans AEM as a Cloud Service.
- Connectez-vous à AEM as a Cloud Service (instance de création ou de publication) et assurez-vous que vos utilisateurs et utilisatrices et groupes sont correctement synchronisés dans AEM.
+ AEM Developer Console exige que votre enregistrement d’utilisateur soit créé dans le niveau de service AEM correspondant pour qu’il s’authentifie à ce niveau de service. - Effacez les cookies de vos navigateurs ainsi que l’état de l’application (stockage local) et reconnectez-vous à AEM Developer Console, en vous assurant que le jeton d’accès utilisé par AEM Developer Console est correct et n’a pas expiré.
Restrictions IP ip-restrictions
L’accès au Developer Console dépend de votre capacité à atteindre l’instance de création. Si votre organisation a configuré une adresse IP placée sur la liste autorisée sur le service de création dans Cloud Manager, vous devez vous connecter à partir d’une adresse IP comprise dans cette plage autorisée.
Par exemple, si l’instance de création est limitée à votre VPN d’entreprise, vous ne pouvez utiliser le Developer Console que lorsque vous êtes connecté à ce VPN.
Accéder à Developer Console
Developer Console est accessible par l’environnement AEM as a Cloud Service via Cloud Manager.
- Accédez à Cloud Manager.
- Ouvrez le Programme qui contient l’environnement AEM as a Cloud Service pour ouvrir Developer Console.
- Recherchez l’Environnement, puis sélectionnez les
.... - Sélectionnez Developer Console dans la liste déroulante.
Ou ouvrez cette URL pour vous connecter : 🔗
Ou utilisez cette commande à partir de l’interface de ligne de commande de Cloud Manager :
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
Sélecteur d’environnement/de programme
Pour utiliser AEM Developer Console, vous devez sélectionner l’environnement et le programme à inspecter.
Les sélecteurs se trouvent dans les coins supérieur gauche et droit de l’interface utilisateur d’AEM Developer Console.
La sélection d’un environnement déclenche une actualisation des données dans AEM Developer Console, et vous verrez les données de l’environnement sélectionné.
Lorsque vous accédez au navigateur de référentiels, l’environnement sélectionné est utilisé pour ouvrir le navigateur de référentiels dans un nouvel onglet.
Les boutons d’actualisation en regard des sélecteurs déclenchent une suppression de la mémoire cache du navigateur pour les appels des programmes/environnements à Cloud Manager.
Vous pouvez l’utiliser si un nouvel environnement a été créé et que vous ne le voyez pas dans la liste des environnements.
La mise à disposition du nouvel environnement dans AEM Developer Console peut encore prendre quelques minutes.
Les voyants d’état indiquent la santé de l’environnement.
- Rouge : indique que l’environnement n’est pas intègre et n’est pas disponible (éventuellement mis en veille).
- Orange : l’environnement peut redémarrer ou se dégrader (certains pods sont temporairement hors service, mais il reste des pods sains disponibles).
- Vert : En cours, tous les pods sont en forme et en bonne santé
Une fois que vous avez sélectionné un environnement, vous pouvez utiliser les onglets pour accéder aux différentes vues d’AEM Developer Console.
Vous pouvez voir le statut de chaque niveau de l’environnement.
Bundles OSGi
- Présentation des lots OSGI déployés dans le type d’environnement sélectionné. Elle permet d’effectuer une recherche de texte intégral.
- Il est utile d’obtenir des informations sur l’état réel des lots dans l’environnement. Vous pouvez obtenir des informations telles que les packages exportés, les packages importés, les services utilisés, etc.
- L’équipe de développement souhaite effectuer une vérification sur l’environnement réel et vérifier si le lot fonctionne comme prévu.
- Exemple de cas d’utilisation : une plage de versions d’une dépendance est spécifiée dans votre lot. Quelque chose ne fonctionne pas dans la dépendance. Vous souhaitez vérifier quelle version de la dépendance est connectée à votre lot. Pour vérifier, accédez aux détails du bundle et utilisez l’importation de bundles/packages pour vérifier quelle version de bundle ou version de package est utilisée au moment de l’exécution. Grâce à ces informations, vous pouvez ajuster votre plage de versions de dépendance Maven ou adapter votre code.
Pour effectuer une recherche, utilisez la barre de recherche. Pour télécharger la liste des lots au format JSON, cliquez sur le bouton Télécharger la liste en haut à droite pour obtenir une image mémoire JSON complète.
Si vous souhaitez obtenir l’image mémoire de publication ou d’aperçu, vous pouvez utiliser le sélecteur d’environnement pour sélectionner l’environnement de publication ou d’aperçu, puis télécharger la liste.
Packages Java
« Packages Java » est utilisé pour empêcher le démarrage des bundles en raison d’imports non résolus ou de classes non résolues dans les scripts (HTL, JSP, etc.). Si les packages Java signalent qu’aucun bundle n’exporte un package Java (ou que la version ne correspond pas à celle importée par un bundle OSGi) :
+ Assurez-vous que la version de la dépendance Maven de l’API AEM de votre projet correspond à la version d’AEM de l’environnement (et, si possible, mettez tout à jour vers la dernière version).
+ Si des dépendances Maven supplémentaires sont utilisées dans le projet Maven :
+ déterminez si une autre API fournie par la dépendance de l’API du SDK AEM peut être utilisée à la place.
+ Si la dépendance supplémentaire est requise, assurez-vous qu’elle est fournie sous la forme d’un bundle OSGi (plutôt que d’un fichier Jar simple) et qu’elle est incorporée dans le package de code de votre projet (ui.apps), de la même manière que le bundle OSGi principal est incorporé dans le package ui.apps.
Cliquez sur un package pour accéder aux détails du package :
Configurations configurations
- Liste consultable des configurations actives dans l’environnement. Vous pouvez voir quelles propriétés sont fournies par les configurations en consultant la page de détails.
- Exemple de cas d’utilisation : un développeur souhaite s’assurer que les configurations qu’il a spécifiées sont réellement présentes dans l’environnement. Si la configuration fait défaut, ils peuvent vérifier le modèle de fonction ou le mode ou dossier d’exécution de la configuration.
Pour plus d’informations sur la configuration des autorisations des utilisateurs, voir Documentation de Cloud Manager.
Servlets servlets
- Une invite de recherche dans laquelle vous pouvez spécifier un chemin avec des sélecteurs et une extension avec GET ou POST. Il fournit ensuite les résultats des servlets par ordre de préférence, ce qui gère la requête dans Sling.
- Exemple de cas d’utilisation : vous disposez d’un servlet OSGI qui doit s’activer lors d’une requête et imprimer la sortie dans la réponse. Cependant, au lieu de la sortie attendue, la réponse renvoie une valeur vide. Vous devez vérifier si un autre servlet est prioritaire sur votre servlet en raison de sélecteurs, de
resourceType, d’extensions ou de classement plus spécifiques. Vous recherchez le chemin d’accès attendu et découvrez qu’un autre servlet est actif avec un rang supérieur. Ensuite, vous décidez si vous pouvez obtenir votre servlet ci-dessus au rang en ajoutant des sélecteurs, par exemple.
Services services
« Composants » répertorie tous les services OSGi.
Les services OSGi aident au débogage en :
+ répertoriant tous les services OSGi d’AEM, ainsi que le bundle OSGi fourni et tous les bundles OSGi qui l’utilisent.
Composants OSGi osgi-components
Les composants aident au débogage en :
+ répertoriant tous les composants OSGi déployés sur AEM as a Cloud Service ;
+ fournissant l’état de chaque composant OSGi, y compris s’ils sont actifs ou non satisfaits ;
+ fournissant des détails sur des références de service non satisfaites qui pourraient empêcher les composants OSGi de devenir actifs ;
+ répertoriant les propriétés OSGi et leurs valeurs liées au composant OSGi.
+ Cela affiche les valeurs réelles injectées via les variables de configuration de l’environnement OSGi.
Intégrations integrations
- Les administrateurs système ont la possibilité de générer, renommer et supprimer des informations d’identification de service et des jetons de développement.
- Vous trouverez plus d’informations à ce sujet à l’adresse suivante : Génération de jetons d’accès pour les API côté serveur.
Référentiel repository
- Ouvre le navigateur de référentiel.
- Remarque : vous devez être en mesure de vous connecter au service AEM pour accéder au navigateur de référentiel. Si vous ne parvenez pas à vous connecter, contactez votre administrateur système pour obtenir l’accès.
- Vous devez accorder l’accès au niveau auquel vous essayez d’accéder. Par exemple, si vous tentez d’accéder au navigateur de référentiel au niveau de publication, vous devez disposer d’un accès (administrateur AEM ou utilisateur AEM) accordé au niveau de publication.
Vidages de statut/requêtes status-dumps-queries
- Une image mémoire de texte intégral ou JSON de l’état actuel des lots, des packages, des configurations, des services, des composants, des tâches Sling ou des définitions Oak.
- Utile en particulier si le développeur a découvert un état inattendu et souhaite communiquer ou documenter cet état pour d’autres développeurs. Le téléchargement de l’image mémoire vous donne un instantané de l’état pour référence ultérieure.
Tâches Sling
« Tâches Sling » répertorie toutes les files d’attente de tâches Sling.
Les tâches Sling aident au débogage en :
+ répertoriant les files d’attente de tâches Sling et de leurs configurations ;
+ fournissant des informations sur le nombre de tâches Sling principales, en file d’attente et traitées, ce qui s’avère utile pour le débogage des problèmes liés aux workflows, aux workflows transitoires et aux autres tâches effectuées par les tâches Sling dans AEM.
Définitions d’Oak
Les index Oak fournissent une image mémoire des nœuds définis sous /oak:index. Gardez à l’esprit que cela n’affiche pas les index fusionnés, ce qui se produit lors de la modification d’un index AEM.
Les index Oak aident au débogage en :
+ répertoriant toutes les définitions d’index Oak qui fournissent des informations sur la manière dont les requêtes de recherche sont exécutées dans AEM. Gardez à l’esprit que les modifications apportées aux index AEM ne sont pas prises en compte ici. Cette vue n’est utile que pour les index qui sont uniquement fournis par AEM ou uniquement fournis par le code personnalisé.
Outil de performance des requêtes
- « Requêtes » permet d’obtenir des informations sur les requêtes de recherche exécutées sur AEM.
- « Requêtes » ne fonctionnent que lorsqu’une capsule spécifique est sélectionnée, car elle ouvre la console web Performances des requêtes de cette capsule, ce qui nécessite que le développeur ou la développeuse ait accès au service AEM.
Les requêtes aident au débogage en :
+ expliquant comment les requêtes sont interprétées, analysées et exécutées par Oak. Ceci est très important pour comprendre pourquoi une requête est lente et comment l’accélérer ;
+ listant les requêtes les plus appréciées s’exécutant dans AEM, avec la possibilité de les expliquer ;
+ listant les requêtes les plus lentes s’exécutant dans AEM, avec la possibilité de les expliquer.
Vous trouverez plus de documentation ici.