Das AEM as a Cloud Service-SDK aem-as-a-cloud-service-sdk
Das AEM as a Cloud Service-SDK besteht aus den folgenden Artefakten:
- Quickstart-JAR - Die für die lokale Entwicklung verwendete AEM-Laufzeit.
- Java™-API-JAR: die Java™-JAR-/Maven-Abhängigkeit, die alle zulässigen Java™-APIs verfügbar macht, die zur Entwicklung für AEM as a Cloud Service verwendet werden können. Zuvor als UberJar bezeichnet.
- Javadoc-JAR - Die Java-Dokumente für die Java™-API-JAR-Datei.
- Dispatcher Tools: der Satz von Tools, die der lokalen Entwicklung mit Dispatcher dienen. Separate Artefakte für UNIX® und Windows.
Darüber hinaus werden manche Kundinnen und Kunden, die zuvor AEM 6.5 oder frühere Versionen bereitgestellt haben, die unten stehenden Artefakte verwenden. Wenn die lokale Kompilierung mit der Schnellstart-JAR-Datei nicht funktioniert und Sie vermuten, dass sie auf das Entfernen von Benutzeroberflächen aus der von AEM bereitgestellten as a Cloud Service zurückzuführen ist, wenden Sie sich an den Kunden-Support. Sie können feststellen, ob Sie Zugang benötigen. Dies erfordert Änderungen im Backend.
- 6.5 Veraltete Java™-API-JAR - Ein zusätzlicher Satz von Benutzeroberflächen, die seit AEM 6.5 entfernt wurden.
- 6.5 Veraltetes JavaDoc-JAR - Die Java-Dokumente für den zusätzlichen Satz von Schnittstellen.
Erstellen für das SDK building-for-the-sdk
Das AEM as a Cloud Service-SDK wird zum Erstellen und Bereitstellen von benutzerdefiniertem Code verwendet. Siehe die Dokumentation zum AEM-Projektarchetyp. Im Allgemeinen werden die folgenden Schritte ausgeführt:
- Code kompilieren - Source-Code wird kompiliert und generiert die resultierenden Inhaltspakete.
- Artefakte erstellen - Artefakte werden während dieses Prozesses erstellt.
- Bundles analysieren - Bundles werden mit dem Maven Analyzer-Plug-in analysiert, das nach Problemen im Maven-Projekt sucht, z. B. nach fehlenden Abhängigkeiten.
- Artefakte bereitstellen - Artefakte werden auf dem lokalen Server bereitgestellt.
Cloud Manager führt dieselben Schritte bei der Bereitstellung in Cloud-Umgebungen aus. Die lokale Durchführung von Builds ermöglicht eine lokale Entwicklung und Prüfung. Entwickler können Code- oder Strukturprobleme effizient identifizieren, bevor sie sich zur Quell-Code-Verwaltung verpflichten. Dadurch werden Verzögerungen verhindert, die durch das Auslösen von Cloud Manager-Bereitstellungen verursacht werden. Dies kann länger dauern.
Zugriff auf das AEM as a Cloud Service-SDK accessing-the-aem-as-a-cloud-service-sdk
- Sie können das Symbol Über Adobe Experience Manager" von AEM Admin Console, um herauszufinden, welche Version von AEM Sie in der Produktionsumgebung ausführen.
- Die Schnellstart-JAR- und Dispatcher-Tools können als ZIP-Datei vom Software Distribution-Portal heruntergeladen werden. Der Zugriff auf die SDK-Listen ist auf Personen beschränkt, die Umgebungen auf AEM Managed Services oder AEM as a Cloud Service haben.
- Die Java™-API-JAR- und JavaDoc-JAR-Datei können über Maven-Tools heruntergeladen werden, entweder über die Befehlszeile oder mit der von Ihnen bevorzugten IDE.
- Die Maven-Projekt-POMs sollten auf das folgende API-JAR-Paket verweisen. Auch auf die Abhängigkeit von Unterpaketen sollte verwiesen werden.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>2019.11.3006.20191108T223635Z-191201</version>
<scope>provided</scope>
</dependency>
Aktualisieren eines lokalen Projekts mit einer neuen SDK-Version refreshing-a-local-project-with-a-new-skd-version
Wann sollte das lokale Projekt mit einem neuen SDK aktualisiert werden?
Adobe empfiehlt die Aktualisierung nach einer monatlichen Wartungsversion.
Es ist optional, nach jeder täglichen Wartungsversion zu aktualisieren. Kundinnen und Kunden werden darüber informiert, wenn ihre Produktionsinstanz erfolgreich auf eine neue AEM-Version aktualisiert wurde. Bei den täglichen Wartungsversionen ist nicht zu erwarten, dass sich das neue SDK erheblich verändert hat (wenn überhaupt). Adobe empfiehlt jedoch, die lokale AEM-Entwicklungsumgebung gelegentlich mit der neuesten SDK zu aktualisieren und dann das benutzerdefinierte Programm neu zu erstellen und zu testen. Die monatliche Wartungsversion umfasst in der Regel wirkungsvollere Änderungen, sodass Entwicklerinnen und Entwickler umgehend aktualisieren, neu erstellen und testen sollten.
So aktualisieren Sie ein lokales Projekt mit einer neuen SDK-Version:
- Stellen Sie sicher, dass alle nützlichen Inhalte in die Quell-Code-Verwaltung übertragen werden. Oder in einem veränderlichen Inhaltspaket für den späteren Import gespeichert.
- Inhalte lokaler Entwicklungstests müssen separat gespeichert werden, damit sie nicht im Rahmen des Cloud Manager-Pipeline-Build bereitgestellt werden. Der Grund dafür ist, dass sie nur für die lokale Entwicklung verwendet werden.
- Beenden Sie den derzeit laufenden Schnellstart.
- Verschieben Sie den Ordner
crx-quickstart
zur sicheren Aufbewahrung in einen anderen Ordner. - Beachten Sie die neue AEM-Version, die in Cloud Manager vermerkt ist (sie wird verwendet, um die neue Schnellstart-JAR-Version für den weiteren Download zu identifizieren).
- Laden Sie die Schnellstart-JAR-Datei, deren Version mit der AEM-Produktionsversion übereinstimmt, vom Software Distribution-Portal herunter.
- Erstellen Sie einen ganz neuen Ordner und platzieren Sie darin die neue Schnellstart-JAR.
- Starten Sie den neuen Schnellstart mit den gewünschten Ausführungsmodi (entweder Umbenennen der Datei oder Übergeben in Ausführungsmodi über
-r
).
Stellen Sie sicher, dass im Ordner keine Überreste des alten Schnellstarts vorhanden sind. - Erstellen Sie Ihre AEM-Anwendung.
- Stellen Sie Ihre AEM-Anwendung mithilfe von Package Manager auf lokalem AEM bereit.
- Installieren Sie alle veränderlichen Inhaltspakete, die für lokale Umgebungstests mithilfe von Package Manager erforderlich sind.
- Entwickeln Sie nach Bedarf weiter und stellen Sie Änderungen bereit.
Wenn es Inhalte gibt, die mit jeder neuen AEM-Schnellstartversion installiert werden sollen, fügen Sie sie in einem Inhaltspaket und der Quell-Code-Verwaltung des Projekts hinzu. Installieren Sie sie dann jedes Mal.
Adobe empfiehlt, die SDK häufig zu aktualisieren, z. B. alle zwei Wochen. Entsorgen Sie außerdem den vollständigen lokalen Status täglich, damit Sie sich nicht versehentlich auf statusbehaftete Daten in der Anwendung verlassen müssen.
Wenn Sie CryptoSupport für Cloud-Services, die SMTP-Mail-Konfiguration oder die CryptoSupport-API verwenden, werden verschlüsselte Eigenschaften mit einem Schlüssel gesichert. Weitere Informationen finden Sie in der Dokumentation zur CryptoSupport-API. Dieser Schlüssel wird beim ersten Start einer AEM-Umgebung automatisch generiert. Während die Cloud-Implementierung dafür sorgt, dass der umgebungsspezifische CryptoKey automatisch wiederverwendet wird, muss der CryptoKey in die lokale Entwicklungsumgebung injiziert werden.
Standardmäßig ist AEM so konfiguriert, dass die Schlüsseldaten im Datenordner eines Ordners gespeichert werden. Um die Wiederverwendung bei der Entwicklung zu vereinfachen, kann der AEM-Prozess jedoch beim ersten Starten mit "-Dcom.adobe.granite.crypto.file.disable=true
" initialisiert werden. Dieser Prozess generiert die Verschlüsselungsdaten bei "/etc/key
".
Wiederverwenden von Inhaltspaketen, die die verschlüsselten Werte enthalten:
- Wenn Sie die lokale Datei quickstart.jar zum ersten Mal starten, fügen Sie unbedingt den folgenden Parameter hinzu: "
-Dcom.adobe.granite.crypto.file.disable=true
.“ Adobe empfiehlt optional, dass Sie es immer hinzufügen. - Erstellen Sie beim ersten Starten einer Instanz ein Paket, das einen Filter für den Stamm "
/etc/key
" enthält. Dieses Paket enthält das Geheimnis, das in allen Umgebungen wiederverwendet wird, in denen sie wiederverwendet werden sollen. - Exportieren Sie alle veränderlichen Inhalte, die geheime Daten enthalten. Oder suchen Sie die verschlüsselten Werte über
/crx/de
, um sie zum Paket hinzuzufügen, das in allen Installationen wiederverwendet wird. - Installieren Sie das in den Schritten 2 und 3 erstellte Paket jedes Mal, wenn Sie eine neue Instanz starten (entweder um sie durch eine neue Version zu ersetzen oder weil mehrere Entwicklungsumgebungen die Anmeldeinformationen zum Testen gemeinsam nutzen sollen). Auf diese Weise können Sie den Inhalt wiederverwenden, ohne dass eine manuelle Neukonfiguration erforderlich ist. Das liegt daran, dass der CryptoKey jetzt synchronisiert ist.