AEM as a Cloud Service Developer Console developer-console
AEM as a Cloud Service Developer Console enthält eine Reihe schreibgeschützter Tools zum Debugging von Cloud-Umgebungen. Auf ihn kann über einen Link pro Umgebung in Cloud Manager zugegriffen werden. Er bietet Funktionen zum Anzeigen von Bundles, OSGi-Einstellungen, Services und Servlets und mehr.
- Der AEM Developer Console (Cloud Service) sollte nicht mit dem ähnlich benannten Adobe Developer Console" verwechselt.
Zugriff auf AEM Developer Console
Um auf AEM Developer Console zuzugreifen und sie zu verwenden, müssen Entwicklerinnen und Entwicklern über die Adobe ID von Adobe über die Admin Console die folgenden Berechtigungen erteilt werden.
- Stellen Sie sicher, dass im Adobe Org Switcher die Adobe-Org für die Umgebungen angezeigt wird, die Sie in AEM Developer Console überprüfen möchten.
- Um sich bei AEM Developer Console anmelden zu können, muss der Entwickler Mitglied einer der folgenden Rollen sein:
+ Produktprofil von Cloud Manager Entwickler - Cloud Service: In diesem Fall der Entwickler die vollständige Liste der Umgebungen, die unter der ausgewählten AEM Developer Console-URL verfügbar sind. Wenn in Cloud Manager eine Entwicklungsumgebung oder eine RDE ausgewählt wurde, werden möglicherweise andere Entwicklungsumgebungen oder RDEs in demselben Programm angezeigt.
+ AEM-Administratoren-Produktprofil auf AEM Author: In diesem Fall beschränkt sich die im vorherigen Punkt beschriebene Liste der Umgebungen auf die entsprechenden Produktprofile, denen diese Rolle zugewiesen ist. - Die Entwickelnden müssen Mitglieder des Produktprofils AEM-Benutzer oder AEM-Admins bei AEM Author und/oder Publish sein.
+ Wenn diese Zugehörigkeit nicht vorhanden ist, wird bei den Statusmeldungen eine Zeitüberschreitung mit dem Fehler „401: Nicht autorisiert“ angezeigt.
Löschen Sie die Cookies Ihres Browsers sowie den Anwendungsstatus (lokaler Speicher) und melden Sie sich erneut bei AEM Developer Console an
Fehlerbehebung für den Zugriff auf AEM Developer Console
Wenn ich mich anmelde, sehe ich nicht die Umgebung, nach der ich suche
Vergewissern Sie sich über Folgendes:
+ Sie haben die richtige AEM Developer Console-URL ausgewählt, indem Sie über Cloud Manager auf die drei Punkte für die ausgewählte Umgebung geklickt und AEM Developer Console ausgewählt haben.
+ Sie verfügen entweder über das Produktprofil Entwickler – Cloud Service des Cloud Manager-Produkts, um die vollständige Liste der Umgebungen einsehen zu können, oder Sie sind Teil des Produktprofils AEM-Administratoren auf AEM Author für die Umgebung, die Sie nicht finden.
401 „Nicht autorisiert“-Fehler bei der Statusmeldung
Beheben des nicht autorisierten Problems:
- Stellen Sie sicher, dass Ihre Benutzerin bzw. Ihr Benutzer Mitglied des entsprechenden Adobe IMS-Produktprofils (AEM-Administrierende oder AEM-Benutzende) für die zugehörige AEM as a Cloud Service-Produktinstanz von AEM Developer Console ist.
+ Denken Sie daran, dass AEM Developer Console auf Adobe IMS-Produktinstanzen 2 und die AEM as a Cloud Service-Autoren- und Veröffentlichungsinstanzen zugreifen. Stellen Sie daher sicher, dass die richtigen Produktprofile verwendet werden, je nachdem, welche Service-Ebene den Zugriff über AEM Developer Console erfordert. - Warten Sie bis zu 30 Minuten, bis die Adobe IMS-Produktprofilmitgliedschaft mit AEM as a Cloud Service synchronisiert wird.
- Melden Sie sich bei AEM as a Cloud Service (Author oder Publish) an und stellen Sie sicher, dass die Benutzenden und Gruppen ordnungsgemäß mit AEM synchronisiert wurden.
+ AEM Developer Console erfordert, dass Ihr Benutzerdatensatz in der entsprechenden AEM-Service-Ebene erstellt wird, damit er sich bei dieser Service-Ebene authentifiziert. - Löschen Sie die Cookies Ihres Browsers sowie den Anwendungsstatus (lokaler Speicher) und melden Sie sich erneut bei AEM Developer Console an, um sicherzustellen, dass das von AEM Developer Console verwendete Zugriffstoken korrekt ist und nicht abgelaufen ist.
IP-Einschränkungen ip-restrictions
Der Zugriff auf Developer Console hängt davon ab, ob Sie die Autoreninstanz erreichen können. Wenn Ihr Unternehmen eine IP-Adresse für den Autoren-Service in Cloud Manager konfiguriert hat, müssen Sie die Verbindung über eine IP-Adresse herstellen, die in diesem zulässigen Bereich liegt.
Wenn die Autoreninstanz beispielsweise auf Ihr Unternehmens-VPN beschränkt ist, können Sie die Developer Console nur verwenden, während Sie mit diesem VPN verbunden sind.
Navigieren zur Developer Console
Der Zugriff auf Developer Console erfolgt über eine AEM as a Cloud Service-Umgebung über Cloud Manager.
- Navigieren Sie zu Cloud Manager
- Öffnen Sie das Programm, das die AEM as a Cloud Service-Umgebung enthält, und öffnen Sie Developer Console.
- Suchen Sie die Umgebung und wählen Sie die
.... - Wählen Sie Developer Console aus der Dropdown-Liste aus.
Oder öffnen Sie diese URL, um sich anzumelden: https://experience.adobe.com/skyline-console
Oder verwenden Sie diesen Befehl über die Cloud Manager-CLI:
aio cloudmanager:open-developer-console <ENVIRONMENTID> --programId <PROGRAMID>
Umgebung/Programmauswahl
Um AEM Developer Console verwenden zu können, müssen Sie die Umgebung und das Programm auswählen, die Sie untersuchen möchten.
Die Selektoren befinden sich oben links und rechts in der Benutzeroberfläche von AEM Developer Console.
Bei Auswahl einer Umgebung wird eine Aktualisierung der Daten in AEM Developer Console Trigger, und die Daten für die ausgewählte Umgebung werden angezeigt.
Wenn Sie zum Repository-Browser wechseln, wird die ausgewählte Umgebung verwendet, um den Repository-Browser in einer neuen Registerkarte zu öffnen.
Über die Aktualisierungsschaltflächen neben dem Selektoren-Trigger wird der Browsercache für die Programme/Umgebungsaufrufe an Cloud Manager gelöscht.
Sie können diese Option verwenden, wenn eine neue Umgebung erstellt wurde und sie nicht in der Liste der Umgebungen angezeigt wird.
Es kann noch einige Minuten dauern, bis die neue Umgebung in AEM Developer Console verfügbar ist.
Die Statusleuchten zeigen den Zustand der Umgebung an.
- Rot: Gibt an, dass die Umgebung nicht gesund und nicht verfügbar ist (möglicherweise in den Ruhezustand versetzt).
- Orange: Die Umgebung wird möglicherweise neu gestartet oder beeinträchtigt (einige der Pods sind vorübergehend ausgefallen, aber es sind weiterhin gesunde Pods verfügbar).
- Grün: Laufen, alle Pods sind in Ordnung
Nachdem Sie eine Umgebung ausgewählt haben, können Sie über die Registerkarten zu den verschiedenen Ansichten der AEM Developer Console navigieren.
Sie können den Status der einzelnen Ebenen der Umgebung sehen.
OSGi-Pakete
- Eine Übersicht über die OSGi-Pakete, die im ausgewählten Umgebungstyp bereitgestellt werden. Sie unterstützt eine Volltextsuche.
- Dies ist hilfreich, um Informationen über den tatsächlichen Status von Paketen in der Umgebung zu erhalten. Sie können Informationen wie exportierte Pakete, importierte Pakete, verwendete Dienste und mehr erhalten.
- Entwicklerinnen und Entwickler möchten die tatsächliche Umgebung verifizieren und prüfen, ob das Paket wie erwartet funktioniert.
- Anwendungsbeispiel: In Ihrem Paket ist ein Versionsbereich einer Abhängigkeit angegeben. Etwas läuft schief in der Abhängigkeit. Sie möchten überprüfen, welche Version der Abhängigkeit mit Ihrem Paket verknüpft ist. Hierfür navigieren Sie zu den Bundle-Details und prüfen bei den importierten Bundles/Paketen, welche Bundle-Version oder Paketversion zur Laufzeit verwendet wird. Mit diesen Informationen können Sie den Versionsbereich Ihrer Maven-Abhängigkeiten anpassen oder Ihren Code ändern.
Verwenden Sie zum Suchen die Suchleiste. Um die Liste der Bundles als JSON herunterzuladen, klicken Sie oben rechts auf die Schaltfläche Liste herunterladen , um einen vollständigen JSON-Dump zu erhalten.
Wenn Sie den Veröffentlichungs- oder Vorschau-Dump abrufen möchten, können Sie den Umgebungsselektor verwenden, um die Veröffentlichungs- oder Vorschau-Umgebung auszuwählen und dann die Liste herunterzuladen.
Java-Pakete
„Java-Pakete“ wird zur Fehlerbehebung bei Bundles verwendet, die aufgrund nicht aufgelöster Importe oder nicht aufgelöster Klassen in Skripten (HTL, JSP usw.) nicht gestartet werden. Wenn „Java-Pakete“ meldet, dass keine Bundles ein Java-Paket exportieren (oder die Version nicht mit der von einem OSGi-Bundle importierten übereinstimmt):
+ Stellen Sie sicher, dass die Version der AEM-API-Maven-Abhängigkeit Ihres Projekts mit der AEM-Version der Umgebung übereinstimmt (und aktualisieren Sie nach Möglichkeit alles auf die neueste Version).
+ Wenn zusätzliche Maven-Abhängigkeiten im Maven-Projekt verwendet werden
+ Bestimmen Sie, ob stattdessen eine alternative API verwendet werden kann, die von der AEM SDK-API-Abhängigkeit bereitgestellt wird.
+ Wenn die zusätzliche Abhängigkeit erforderlich ist, stellen Sie sicher, dass sie als OSGi-Bundle (anstatt als einfache JAR-Datei) bereitgestellt wird und in das Code-Paket (ui.apps) Ihres Projekts eingebettet ist, ähnlich wie das Kern-OSGi-Bundle im Paket ui.apps eingebettet ist.
Wenn Sie auf ein Paket klicken, gelangen Sie zu einem Paketdetail:
Konfigurationen configurations
- Eine durchsuchbare Liste der Konfigurationen, die in der Umgebung aktiv sind. Welche Eigenschaften durch die Konfigurationen bereitgestellt werden, können Sie auf der Detailseite sehen.
- Anwendungsbeispiel: Ein Mitglied des Entwicklungs-Teams möchte sicherstellen, dass die angegebenen Konfigurationen tatsächlich in der Umgebung vorhanden sind. Wenn die Konfiguration fehlt, kann es das Funktionsmodell oder den Konfigurationsausführungsmodus oder -ordner überprüfen.
Weitere Informationen zum Einrichten von Anwenderberechtigungen finden Sie in der Dokumentation für Cloud Manager.
Servlets servlets
- Ein Such-Prompt, in den Sie einen Pfad mit Selektoren und eine Erweiterung mit GET oder POST angeben können. Anschließend werden die Ergebnisse der Servlets in der Reihenfolge ihrer Präferenz bereitgestellt, die die Anfrage in Sling verarbeitet.
- Anwendungsbeispiel: Sie verfügen über ein OSGi-Servlet, das bei einer Anfrage aktiviert wird und den Output in der Antwort ausgibt. Anstelle des erwarteten Outputs wird jedoch eine leere Antwort zurückgegeben. Sie müssen überprüfen, ob ein anderes Servlet aufgrund von spezifischeren Selektoren,
resourceType, Erweiterungen oder Rankings Vorrang vor Ihrem Servlet hat. Sie suchen nach dem erwarteten Pfad und finden heraus, dass ein anderes Servlet mit einem höheren Rang aktiv ist. Anschließend entscheiden Sie, ob Sie Ihr Servlet im Rang höher einstufen können, indem Sie beispielsweise Selektoren hinzufügen.
Dienste services
Hier werden alle OSGi-Dienste aufgelistet.
OSGi-Dienste helfen beim Debugging durch:
+ Auflisten aller OSGi-Dienste in AEM zusammen mit dem bereitgestellten OSGi-Paket sowie allen OSGi-Paketen, die es nutzen
OSGi-Komponenten osgi-components
„Komponenten“ hilft beim Debugging durch:
+ Auflisten aller OSGi-Komponenten, die auf AEM as a Cloud Service bereitgestellt werden
+ Angeben des Status jeder OSGi-Komponente, einschließlich dessen, ob sie aktiv oder nicht erfüllt sind
+ Bereitstellen von Details zu nicht aufgelösten Dienstreferenzen, die verhindern, dass OSGi-Komponenten aktiv werden
+ Auflisten von OSGi-Eigenschaften und deren Werten, die an die OSGi-Komponente gebunden sind.
+ Dadurch werden die tatsächlichen Werte angezeigt, die über Konfigurationsvariablen der OSGi-Umgebung injiziert werden.
Integrationen integrations
- Systemadministratoren können Service-Anmeldeinformationen und Entwickler-Token generieren, umbenennen und löschen.
- Weitere Informationen hierzu finden Sie hier: Generieren von Zugriffstoken für Server-seitige APIs.
Repository repository
- Öffnet den Repository-Browser.
- Hinweis: Sie müssen sich beim AEM-Service anmelden, um auf den Repository-Browser zugreifen zu können. Wenn Sie sich nicht anmelden können, wenden Sie sich an Ihren Systemadministrator, um Zugriff zu erhalten.
- Sie benötigen Zugriff auf die Ebene, auf die Sie zugreifen möchten. Wenn Sie beispielsweise versuchen, auf den Repository-Browser auf der Veröffentlichungsebene zuzugreifen, benötigen Sie Zugriff (AEM-Administrator oder AEM-Benutzer) auf der Veröffentlichungsebene.
Status-Dumps/Abfragen status-dumps-queries
- Ein Volltext- oder JSON-Dump des aktuellen Status von Bundles, Paketen, Konfigurationen, Diensten, Komponenten, Sling-Aufträgen oder Oak-Definitionen.
- Dies ist besonders nützlich, wenn das Entwicklungs-Team einen unerwarteten Status entdeckt hat und diesen Status für andere Entwickelnde kommunizieren oder dokumentieren möchte. Durch Herunterladen des Speicher-Dumps erhalten Sie einen Status-Schnappschuss zur künftigen Referenz.
Sling-Aufträge
Mit „Sling-Vorgänge“ werden alle Warteschlangen für Sling-Aufträge aufgelistet.
Sling-Aufträge helfen beim Debugging durch:
+ Auflistung der Sling-Auftragswarteschlangen und deren Konfigurationen
+ Bereitstellung von Einblicken in die Anzahl der aktiven, in der Warteschlange befindlichen und verarbeiteten Sling-Aufträge, was beim Debugging von Problemen mit Workflows, Übergangs-Workflows und anderen durch Sling-Aufträge in AEM durchgeführten Arbeiten hilfreich ist.
Oak-Definitionen
Oak-Indizes bieten eine Kopie der Knoten, die unter /oak:index definiert sind. Beachten Sie, dass hier keine zusammengeführten Indizes angezeigt werden, die auftreten, wenn ein AEM-Index geändert wird.
Oak-Indizes helfen beim Debugging durch:
+ Auflisten aller Oak-Index-Definitionen, was Einblicke in die Ausführung von Suchanfragen in AEM bietet. Denken Sie daran, dass Änderungen an AEM-Indizes hier nicht widergespiegelt werden. Diese Ansicht ist nur für Indizes hilfreich, die ausschließlich von AEM oder vom benutzerspezifischen Code bereitgestellt werden.
Abfrageleistungs-Tool
- „Abfragen“ bietet Einblicke darin, welche Suchanfragen wie auf AEM ausgeführt werden.
- „Abfragen“ funktioniert nur, wenn ein bestimmter Pod ausgewählt ist, da die Web-Konsole „Abfrageleistung“ dieses Pods geöffnet wird. Daher müssen Entwicklungspersonen Zugriff haben, um sich beim AEM-Dienst anzumelden.
„Abfragen“ erleichtert das Debugging durch:
+ Erläutern der Interpretation, Analyse und Ausführung von Abfragen durch Oak. Dies ist sehr wichtig, wenn Sie nachverfolgen möchten, warum eine Abfrage langsam ist, um zu verstehen, wie sie beschleunigt werden kann.
+ Auflisten der beliebtesten Abfragen, die in AEM ausgeführt werden, mit der Möglichkeit, sie zu erläutern.
+ Auflisten der langsamsten Abfragen, die in AEM ausgeführt werden, mit der Möglichkeit, sie zu erläutern.
Weitere Dokumentationen finden Sie hier.