Lokale AEM-Entwicklung mit dem universellen Editor local-dev-ue
Erfahren Sie, wie der universelle Editor die Bearbeitung lokaler AEM-Instanzen zu Entwicklungszwecken unterstützt.
Überblick overview
Der Dienst „Universeller Editor“ bindet den universellen Editor und das Backend-System zusammen. Um eine lokale Entwicklung für den universellen Editor durchführen zu können, müssen Sie eine lokale Kopie des Dienstes „Universeller Editor“ ausführen. Der Grund hierfür ist Folgender:
- Der offizielle Dienst „Universeller Editor“ von Adobe wird global gehostet, und Ihre lokale AEM-Instanz würde so dem Internet ausgesetzt werden.
- Bei der Entwicklung mit einem lokalen AEM SDK ist der Zugriff auf den Dienst „Universeller Editor“ von Adobe über das Internet nicht möglich.
- Wenn Ihre AEM-Instanz IP-Beschränkungen aufweist und sich der Dienst „Universeller Editor“ von Adobe nicht in einem definierten IP-Bereich befindet, können Sie ihn selbst hosten.
In diesem Dokument wird beschrieben, wie Sie AEM in HTTPS zusammen mit einer lokalen Kopie des Dienstes „Universeller Editor“ ausführen, damit Sie mit dem universellen Editor lokal auf AEM entwickeln können.
Einrichten von AEM für die Ausführung auf HTTPS aem-https
Innerhalb eines äußeren Rahmens, der mit HTTPS gesichert ist, kann kein unsicherer HTTP-Rahmen geladen werden. Der Dienst „Universeller Editor“ wird auf HTTPS ausgeführt, weshalb AEM oder jede andere Remote-Seite auch auf HTTPS ausgeführt werden muss.
Dazu müssen Sie AEM für die Ausführung auf HTTPS einrichten. Zu Entwicklungszwecken können Sie ein selbstsigniertes Zertifikat verwenden.
In diesem Dokument erfahren Sie, wie Sie AEM einrichten, das auf HTTPS ausgeführt wird, einschließlich eines selbstsignierten Zertifikats, das Sie verwenden können.
Installieren des Dienstes „Universeller Editor“ install-ue-service
Der Dienst „Universeller Editor“ ist keine vollständige Kopie des universellen Editors, sondern nur eine Teilmenge seiner Funktionen, um sicherzustellen, dass Aufrufe aus Ihrer lokalen AEM-Umgebung nicht über das Internet weitergeleitet werden, sondern von einem definierten Endpunkt, den Sie steuern.
NodeJS Version 16 ist erforderlich, um eine lokale Kopie des Dienstes „Universeller Editor“ auszuführen.
Der Dienst „Universeller Editor“ ist über die Software-Verteilung verfügbar. In der Dokumentation zur Software-Verteilung finden Sie weitere Informationen zum Zugriff darauf.
Speichern Sie die Datei universal-editor-service.cjs von der Software-Verteilung in Ihrer lokalen Entwicklungsumgebung.
Erstellen eines Zertifikats zum Ausführen des Dienstes „Universeller Editor“ mit HTTPS ue-https
Für den Dienst „Universeller Editor“ ist auch ein Zertifikat erforderlich, das in Ihrer Entwicklungsumgebung auf HTTPS ausgeführt werden kann.
Führen Sie den folgenden Befehl aus.
$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem
Der Befehl generiert eine Datei key.pem und eine Datei certificate.pem. Speichern Sie diese Dateien unter demselben Pfad wie Ihre Datei universal-editor-service.cjs.
Einrichten der Konfiguration des Dienstes „Universeller Editor“ setting-up-service
In NodeJS müssen eine Reihe von Umgebungsvariablen festgelegt sein, damit der Dienst „Universeller Editor“ lokal ausgeführt werden kann.
Erstellen Sie unter demselben Pfad wie die Dateien universal-editor-service.cjs, key.pem und certificate.pem eine Datei .env mit dem folgenden Inhalt.
EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0
Die Variablen haben die folgenden Bedeutungen:
EXPRESS_PORT: Definiert, welchen Port der Dienst „Universeller Editor“ abruft.EXPRESS_PRIVATE: Verweist auf Ihren zuvor erstellten privaten Schlüssel,key.pemEXPRESS_CERT: Verweist auf Ihr zuvor erstelltes Zertifikat,certificate.pemNODE_TLS_REJECT_UNAUTHORIZED=0: Akzeptiert selbstsignierte Zertifikate
Ausführen des Dienstes „Universeller Editor“ running-ue
Führen Sie den folgenden Befehl aus, um den Dienst „Universeller Editor“ zu starten:
$ node ./universal-editor-service.cjs
Er sollte Folgendes an Ihr Terminal ausgeben:
Universal Editor Service listening on port 8000 as HTTPS Server
Stellen Sie sicher, dass der Dienst den HTTPS-Server und nicht den HTTP-Server startet.
Verwenden des lokalen Dienstes „Universeller Editor“ anstatt des globalen Dienstes using-local-ue
Der universelle Editor weiß, welcher Dienst „Universeller Editor“ zum Bearbeiten einer Seite verwendet werden soll, basierend darauf, wie die Seite instrumentiert ist. Dies erfolgt über Meta-Tags auf der Seite, die im universellen Editor geladen wird.
Damit eine Seite mit Ihrem lokalen Dienst „Universeller Editor“ bearbeitet werden kann, muss das folgende Meta-Tag festgelegt sein:
<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">
Nach der Festlegung sollte jeder Inhaltsaktualisierungsaufruf an https://localhost:8000 anstelle des standardmäßigen Dienstes „Universeller Editor“ erfolgen.
https://localhost:8000 zuzugreifen, führt zu einem 404-Fehler. Dies ist das erwartete Verhalten.https://localhost:8000/corslib/LATEST zum Testen des Zugriffs auf Ihren lokalen Dienst „Universeller Editor“. Weitere Informationen finden Sie im nächsten Abschnitt.Bearbeiten einer Seite mit dem lokalen Dienst „Universeller Editor“ editing
Mit dem lokal ausgeführten Dienst „Universeller Editor“ und Ihrer Inhaltsseite, die für die Verwendung des lokalen Dienstes instrumentiert wurde,können Sie jetzt den Editor starten.
- Öffnen Sie in Ihrem Browser
https://localhost:8000/corslib/LATEST. - Weisen Sie Ihren Browser an, um Ihr selbstsigniertes Zertifikat zu akzeptieren.
- Sobald das selbstsignierte Zertifikat als vertrauenswürdig eingestuft wurde, können Sie die Seite mit Ihrem lokalen Dienst „Universeller Editor“ bearbeiten.