Struktur von AEM-Projekten
- Themen:
- Entwicklung
Erstellt für:
- Admin
- Entwickler
TIPIn diesem Artikel werden die Änderungen erläutert, die erforderlich sind, damit Adobe Experience Manager Maven-Projekte mit AEM as a Cloud Service kompatibel sind, indem sichergestellt wird, dass sie die Aufteilung in veränderliche und unveränderliche Inhalte berücksichtigen. Darüber hinaus werden Abhängigkeiten festgelegt, um nicht widersprüchliche, deterministische Implementierungen zu erstellen, und sie werden in einer bereitstellbaren Struktur verpackt.
AEM-Anwendungsbereitstellungen müssen aus einem einzigen AEM-Paket bestehen. Dieses Paket sollte wiederum Unterpakete enthalten, die alles umfassen, was das Programm benötigt, um zu funktionieren, einschließlich Code, Konfiguration und unterstützenden Basisinhalten.
AEM erfordert eine Trennung von Inhalt und Code. Dies bedeutet, dass ein einzelnes Inhaltspaket nicht sowohl für /apps als auch für zur Laufzeit schreibbare Bereiche des Repositorys bereitstellen kann (z. B./content, /conf, /home oder alles, was nicht /apps ist). Stattdessen muss die Anwendung Code und Inhalt in separaten Pakete für die Bereitstellung in AEM voneinander trennen.
Die in diesem Dokument beschriebene Paketstruktur ist mit lokalen Entwicklungsbereitstellungen und AEM Cloud Service-Bereitstellungen kompatibel.
TIPVeränderliche und nicht veränderliche Bereiche des Repositorys
Die Bereiche /apps und /libs von AEM gelten als unveränderlich, weil sie nach dem Start (d. h. zur Laufzeit) nicht mehr geändert (erstellt, aktualisiert, gelöscht) werden können. Jeder Versuch, einen unveränderlichen Bereich zur Laufzeit zu ändern, schlägt fehl.
Alle weiteren Komponenten im Repository (z. B. /content, /conf, /var, /etc, /oak:index, /system, /tmp usw.) sind veränderliche Bereiche, d. h. sie können zur Laufzeit geändert werden.
WARNING/libs nicht geändert werden. Nur der AEM-Produkt-Code darf für /libs bereitstellen.Oak-Indizes
Oak-Indizes (/oak:index) werden vom AEM as a Cloud Service-Bereitstellungsprozess verwaltet. Dies liegt daran, dass Cloud Manager warten muss, bis ein neuer Index bereitgestellt und vollständig neu indiziert wird, bevor zum neuen Code-Bild gewechselt wird.
Aus diesem Grund müssen Oak-Indizes, obwohl sie zur Laufzeit veränderbar sind, als Code bereitgestellt werden, damit sie installiert werden können, bevor veränderbare Pakete installiert werden. Daher sind /oak:index-Konfigurationen Teil des Code-Pakets und nicht Teil des Inhaltspakets, wie unten beschrieben.
TIPEmpfohlene Paketstruktur
Dieses Diagramm bietet einen Überblick über die empfohlene Projektstruktur und die empfohlenen Artefakte zur Paketbereitstellung.
Die empfohlene Bereitstellungsstruktur für Programme lautet wie folgt:
Code-Pakete/OSGi-Pakete
-
Die Jar-Datei des OSGi-Pakets wird generiert und direkt in das gesamte Projekt eingebettet.
-
Das
ui.apps-Paket enthält den ganzen bereitzustellenden Code und wird nur für/appsbereitgestellt. Zu den gebräuchlichen Elementen desui.apps-Pakets gehören unter anderem:- Komponentendefinitionen und HTL-Skripte
/apps/my-app/components
- JavaScript und CSS (über Client-Bibliotheken)
/apps/my-app/clientlibs
- Überlagerungen von
/libs/apps/cq,/apps/dam/, und so weiter.
- Kontextabhängige Ausweichkonfigurationen
/apps/settings
- ACLs (Berechtigungen)
- Alle
rep:policyfür einen Pfad unter/apps
- Alle
- Vorkompilierte Paket-Skripte
- Komponentendefinitionen und HTL-Skripte
NOTEInhaltspakete
-
Das
ui.content-Paket enthält alle Inhalte und Konfigurationen. Das Inhaltspaket umfasst alle Knotendefinitionen, die nicht in denui.apps- oderui.config-Paketen enthalten sind, bzw. alles, was nicht in/appsoder/oak:indexenthalten ist. Zu den gebräuchlichen Elementen desui.content-Pakets gehören unter anderem:- Kontextabhängige Konfigurationen
/conf
- Erforderliche, komplexe Inhaltsstrukturen (d. h. Erstellung von Inhalten, die auf in Repo Init definierten grundlegenden Inhaltsstrukturen aufbauen und diese erweitern).
/content,/content/damund so weiter.
- Geregelte Tagging-Taxonomien
/content/cq:tags
- Ältere ETC-Knoten (idealerweise migrieren Sie diese an Nicht-ETC-Speicherorte)
/etc
- Kontextabhängige Konfigurationen
Container-Pakete
-
Das
all-Paket ist ein Container-Paket, das NUR bereitstellbare Artefakte, die JAR-Datei des OSGi-Pakets sowie dieui.apps-,ui.config- undui.content-Pakete als Einbettungen enthält. Dasall-Paket darf keinen eigenen Inhalt oder Code haben, sondern muss die Bereitstellung an das Repository an seine Unterpakete oder JAR-Dateien des OSGi-Pakets delegieren.Pakete werden jetzt mit der eingebetteten Konfiguration des FileVault Package Maven-Plug-ins anstatt mit der
<subPackages>-Konfiguration eingebunden.Bei komplexen Experience Manager-Bereitstellungen ist es möglicherweise wünschenswert, mehrere
ui.apps-,ui.config- undui.content-Projekte/-Pakete zu erstellen, die bestimmte Sites oder Mandanten in AEM darstellen. Wenn diese Vorgehensweise gewählt wird, stellen Sie sicher, dass die Aufteilung zwischen veränderlichen und unveränderlichen Inhalten eingehalten wird und die erforderlichen Inhaltspakete und JAR-Dateien des OSGi-Pakets imall-Container-Inhaltspaket als Unterpakete eingebettet werden.Beispielsweise könnte eine komplexe Struktur eines Inhaltspakets für die Bereitstellung wie folgt aussehen:
-
Inhaltspaket
allbettet die folgenden Pakete ein, um ein einzelnes Bereitstellungsartefakt zu erstellencommon.ui.appsstellt Code bereit, der sowohl für Site A als auch für Site B erforderlich istsite-a.coreJar-Datei des OSGi-Pakets, erforderlich für Site Asite-a.ui.appsstellt Code bereit, der für Site A erforderlich istsite-a.ui.configstellt OSGi-Konfigurationen bereit, die für Site A erforderlich sindsite-a.ui.contentstellt Inhalte und Konfigurationen bereit, die für Site A erforderlich sindsite-b.coreJar-Datei des OSGi-Pakets, erforderlich für Site Bsite-b.ui.appsstellt Code bereit, der für Site B erforderlich istsite-b.ui.configstellt OSGi-Konfigurationen bereit, die für Site B erforderlich sindsite-b.ui.contentstellt Inhalte und Konfigurationen bereit, die für Site B erforderlich sind
-
-
Das
ui.config-Paket enthält alle OSGi-Konfigurationen:-
Gilt als Code und gehört zu OSGi-Bundles, enthält jedoch keine regulären Inhaltsknoten. Daher wird es als Container-Paket markiert
-
Organisatorischer Ordner mit für den Ausführungsmodus spezifischen OSGi-Konfigurationsdefinitionen
/apps/my-app/osgiconfig
-
Allgemeiner OSGi-Konfigurationsordner mit standardmäßigen OSGi-Konfigurationen, die für alle Bereitstellungsziele für AEM as a Cloud Service gelten
/apps/my-app/osgiconfig/config
-
Für den Ausführungsmodus spezifische OSGi-Konfigurationsordner mit standardmäßigen OSGi-Konfigurationen, die für alle Bereitstellungsziele für AEM as a Cloud Service gelten
/apps/my-app/osgiconfig/config.<author|publish>.<dev|stage|prod>
-
Repo Init OSGi-Konfigurationsskripte
-
Repo Init ist die empfohlene Methode zum Bereitstellen (veränderlicher) Inhalte, die logischerweise Teil des AEM-Programms sind. Die Repo Init OSGi-Konfigurationen sollten wie oben beschrieben im entsprechenden
config.<runmode>-Ordner platziert und zur Definition folgender Elemente verwendet werden:- Grundlegende Inhaltsstrukturen
- Benutzer
- Service-Benutzer
- Gruppen
- ACLs (Berechtigungen)
-
-
Zusätzliche Anwendungspakete
Wenn andere AEM-Projekte, die selbst aus eigenen Code- und Inhaltspaketen bestehen, von der AEM-Bereitstellung verwendet werden, sollten ihre Container-Pakete in das all-Paket des Projekts eingebettet werden.
Beispielsweise könnte ein AEM-Projekt, das zwei anbieterspezifische AEM-Programme enthält, wie folgt aussehen:
-
Inhaltspaket
allbettet die folgenden Pakete ein, um ein einzelnes Bereitstellungsartefakt zu erstellencoreJar-Datei des OSGi-Pakets, erforderlich für das AEM-Programmui.appsstellt Code bereit, der für das AEM-Programm erforderlich istui.configstellt OSGi-Konfigurationen bereit, die für das AEM-Programm erforderlich sindui.contentstellt Inhalte und Konfigurationen bereit, die für das AEM-Programm erforderlich sindvendor-x.allstellt alle erforderlichen Elemente (Code und Inhalt) bereit, die für das Programm von Anbieter X benötigt werdenvendor-y.allstellt alle erforderlichen Elemente (Code und Inhalt) bereit, die für das Programm von Anbieter Y benötigt werden
Pakettypen
Die Pakete sind mit ihrem deklarierten Pakettyp zu kennzeichnen. Mithilfe von Pakettypen lässt sich der Zweck und die Bereitstellung eines Pakets verdeutlichen.
- Container-Pakete müssen ihren
packageTypeaufcontainereinstellen. Container-Pakete dürfen keine Standardknoten enthalten. Nur OSGi-Bundles, -Konfigurationen und -Unterpakete sind zulässig. Container in AEM as a Cloud Service dürfen keine Installations-Hooks verwenden. - (Unveränderliche) Code-Pakete müssen
packageTypeaufapplicationsetzen. - (Veränderliche) Inhaltspakete müssen
packageTypeaufcontentsetzen.
Weitere Informationen finden Sie in der Dokumentation zu Apache Jackrabbit FileVault - Package Maven-Plug-in, Apache Jackrabbit-Pakettypen und dem Konfigurations-Snippet für FileVault Mavent unten.
TIPMarkieren von Paketen für die Bereitstellung durch Adobe Cloud Manager
Standardmäßig sammelt Adobe Cloud Manager alle vom Maven-Build erstellten Pakete. Da jedoch das Container-Paket (all) das einzige Implementierungsartefakt ist, das alle Code- und Inhaltspakete enthält, müssen Sie sicherstellen, dass nur das Containter-Paket (all) bereitgestellt wird. Um dies sicherzustellen, müssen andere Pakete, die der Maven-Build generiert, mit der FileVault Content Package Maven Plug-in-Konfiguration von <properties><cloudManagerTarget>none</cloudManageTarget></properties> gekennzeichnet werden.
TIPRepo Init
Repo Init enthält Anweisungen oder Skripte, mit denen JCR-Strukturen definiert werden, von allgemeinen Knotenstrukturen wie Ordnerbäumen bis hin zu Benutzenden, Dienstbenutzenden, Gruppen und ACL-Definitionen.
Die Hauptvorteile von Repo Init sind, dass sie implizite Berechtigungen zum Ausführen aller Aktionen haben, die von ihren Skripten definiert werden. Außerdem werden solche Skripte frühzeitig im Bereitstellungslebenszyklus aufgerufen, um sicherzustellen, dass alle erforderlichen JCR-Strukturen bereits vorhanden sind, wenn der Code ausgeführt wird.
Während Repo Init-Skripte selbst als Skripte im ui.config-Projekt vorhanden sind, können und sollten sie zum Definieren der folgenden veränderbaren Strukturen verwendet werden:
- Grundlegende Inhaltsstrukturen
- Service-Benutzer
- Benutzer
- Gruppen
- ACLs
Repo Init-Skripte werden als scripts-Einträge von RepositoryInitializer-OSGi-Werkskonfigurationen gespeichert. Daher können sie implizit vom Ausführungsmodus angesprochen werden, wodurch Unterschiede zwischen den Repo Init-Skripten der AEM-Authoring- und AEM-Publishing-Dienste oder sogar zwischen Umgebungen (Entwicklung, Staging und Produktion) berücksichtigt werden.
Repo Init-OSGi-Konfigurationen werden am besten im .config OSGi-Konfigurationsformat geschrieben, da sie mehrere Zeilen unterstützen. Dies stellt eine Ausnahme bei den Best Practices dar, .cfg.json zur Definition von OSGi-Konfigurationen zu verwenden.
Beim Definieren von Benutzenden und Gruppen werden nur Gruppen als Teil der Anwendung und als integraler Bestandteil ihrer Funktion betrachtet. Sie definieren Organisationsbenutzende und -gruppen weiterhin zur Laufzeit in AEM. Wenn beispielsweise ein benutzerdefinierter Workflow einer benannten Gruppe Arbeit zuweist, definieren Sie diese Gruppe über Repo Init in der AEM-Anwendung. Wenn die Gruppierung jedoch nur organisatorisch ist, z. B. „Heikes Team“ und „Erwins Team“, werden diese Gruppen am besten zur Laufzeit in AEM definiert und verwaltet.
TIPscripts definiert werden. Die references-Konfiguration funktioniert sonst nicht.Das vollständige Vokabular für Repo Init-Skripte ist in der Apache Sling Repo Init-Dokumentation verfügbar.
TIPRepository-Strukturpaket
Für Code-Pakete muss das FileVault Maven-Plug-in so konfiguriert werden, dass auf ein <repositoryStructurePackage> verwiesen wird, das die Richtigkeit struktureller Abhängigkeiten erzwingt (um sicherzustellen, dass ein Code-Paket nicht über ein anderes installiert wird). Sie können Ihr eigenes Repository-Strukturpaket für Ihr Projekt erstellen.
Dies ist nur für Code-Pakete erforderlich, d. h. für alle Pakete, die mit <packageType>application</packageType> gekennzeichnet sind.
Informationen zum Erstellen eines Repository-Strukturpakets für Ihr Programm finden Sie unter Entwickeln eines Repository-Strukturpakets.
Beachten Sie, dass dieses Repository-Strukturpaket für Inhaltspakete (<packageType>content</packageType>) nicht erforderlich ist.
TIPEinbetten von Unterpaketen in das Container-Paket
Inhalts- oder Code-Pakete werden in einem speziellen „Side-Car“-Ordner abgelegt und können mithilfe der <embeddeds>-Konfiguration des FileVault Maven-Plug-ins entweder auf AEM Author, AEM Publish oder beiden installiert werden. Verwenden Sie nicht die <subPackages>-Konfiguration.
Häufige Anwendungsfälle sind:
- ACLs/Berechtigungen, die sich zwischen AEM Author- und AEM Publish-Benutzern unterscheiden
- Konfigurationen, die nur zur Unterstützung von Aktivitäten in AEM Author verwendet werden
- Code, wie z.B. Integrationen mit Backoffice-Systemen, die nur auf in AEM Author laufen müssen
Um AEM Author, AEM Publish oder beides als Ziel festzulegen, wird das Paket in das all-Container-Paket an einem bestimmten Ordnerspeicherort im folgenden Format eingebettet:
/apps/<app-name>-packages/(content|application|container)/install(.author|.publish)?
Eine Aufschlüsselung dieser Ordnerstruktur:
-
Der Ordner der ersten Ebene muss
/appssein. -
Der Ordner der zweiten Ebene stellt das Programm dar, wobei
-packagesan den Ordnernamen angehängt wird. Häufig gibt es nur einen einzigen Ordner der zweiten Ebene, unter dem alle Unterpakete eingebettet sind. Es können jedoch beliebig viele Ordner der zweiten Ebene erstellt werden, um die logische Struktur des Programms bestmöglich darzustellen:/apps/my-app-packages/apps/my-other-app-packages/apps/vendor-packages
WARNINGEingebettete Ordner mit Unterpaketen werden standardmäßig mit dem Suffix von-packagesbenannt. Mit dieser Benennung wird sichergestellt, dass der Implementierungs-Code und die Inhaltspakete nicht in den Zielordnern von Unterpaket-/apps/<app-name>/...bereitgestellt werden, was zu destruktivem und zyklischem Installationsverhalten führen würde. -
Der Ordner der dritten Ebene muss
application,contentodercontainer- Der
application-Ordner enthält Code-Pakete - Der
content-Ordner enthält Inhaltspakete - Der
container-Ordner enthält alle zusätzlichen Programmpakete, die ggf. im AEM-Programm enthalten sind.
Der Name dieses Ordners entspricht den Pakettypen der darin enthaltenen Pakete.
- Der
-
Der Ordner der vierten Ebene enthält die Unterpakete und muss einer der folgenden sein:
installzur Installation sowohl auf AEM Author als auch auf AEM Publishinstall.authorzur Installation nur auf AEM Authorinstall.publishzur Installation nur auf AEM Publish
Nurinstall.authorundinstall.publishwerden als Ziele unterstützt. Andere Ausführungsmodi werden nicht unterstützt.
Beispielsweise kann eine Bereitstellung, die AEM Author- und Publish-spezifische Pakete enthält, wie folgt aussehen:
-
Container-Paket
allbettet die folgenden Pakete ein, um ein einzelnes Bereitstellungsartefakt zu erstellenui.appseingebettet in/apps/my-app-packages/application/installstellt Code für AEM Author und AEM Publish bereitui.apps.authoreingebettet in/apps/my-app-packages/application/install.authorstellt Code nur für AEM Author bereitui.contenteingebettet in/apps/my-app-packages/content/installstellt Inhalte und Konfiguration für AEM Author und AEM Publish bereitui.content.publisheingebettet in/apps/my-app-packages/content/install.publishstellt Inhalte und Konfiguration nur für AEM Publish bereit
TIPFilterdefinition des Container-Pakets
Aufgrund der Einbettung von Code und Inhalts-Unterpaketen in das Container-Paket müssen die eingebetteten Zielpfade zur Datei filter.xml des Container-Projekts hinzugefügt werden. Dadurch wird sichergestellt, dass beim Build die eingebetteten Pakete im Container-Paket enthalten sind.
Fügen Sie einfach die <filter root="/apps/<my-app>-packages"/>-Einträge für alle Ordner der zweiten Ebene hinzu, die bereitzustellende Unterpakete enthalten.
TIPEinbetten von Drittanbieter-Paketen
Alle Pakete müssen über das öffentliche Maven-Artefakt-Repository von Adobe oder ein öffentlich zugängliches, referenzierbares Maven-Artefakt-Repository von Drittanbietern verfügbar sein.
Wenn sich die Pakete von Drittanbietern im öffentlichen Maven-Artefakt-Repository von Adobe befinden, ist für Adobe Cloud Manager keine weitere Konfiguration erforderlich, um die Artefakte aufzulösen.
Wenn sich die Pakete von Drittanbietern in einem öffentlichen Maven-Artefakt-Repository von Drittanbietern befinden, muss dieses Repository in der pom.xml des Projekts registriert und gemäß der oben beschriebenen Methode eingebettet werden.
Anwendungen/Connectoren von Drittanbietern sollten mit ihrem all-Paket als Container im Container-Paket (all) Ihres Projekts eingebettet werden.
Das Hinzufügen von Maven-Abhängigkeiten folgt den Standardpraktiken von Maven, und das Einbetten von Artefakten von Drittanbietern (Code- und Inhaltspakete) wird oben beschrieben.
TIPPaketabhängigkeiten zwischen den ui.apps von ui.content-Paketen
Um eine ordnungsgemäße Installation der Pakete sicherzustellen, wird empfohlen, Abhängigkeiten zwischen Paketen zu erstellen.
Die allgemeine Regel ist, dass Pakete mit veränderlichem Inhalt (ui.content) vom unveränderlichen Code (ui.apps) abhängen sollten, der die Wiedergabe und Verwendung des veränderlichen Inhalts unterstützt.
Eine wichtige Ausnahme von dieser allgemeinen Regel ist, wenn das unveränderliche Code-Paket (ui.apps oder jedes andere) nur OSGi-Bundles enthält. Ist dies der Fall sollte kein AEM-Paket eine Abhängigkeit angeben. Der Grund dafür ist, dass unveränderliche Code-Pakete, die nur OSGi-Bundles enthalten, nicht bei AEM Package Manager registriert sind. Daher hat jedes AEM Paket, das davon abhängig ist, eine nicht erfüllte Abhängigkeit und kann nicht installiert werden.
TIPDie üblichen Muster für Abhängigkeiten von Inhaltspaketen sind:
Abhängigkeiten von einfachen Bereitstellungspaketen
Im einfachen Fall hängt das veränderliche Inhaltspaket ui.content vom unveränderlichen Code-Paket ui.apps ab.
-
allhat keine Abhängigkeitenui.appshat keine Abhängigkeitenui.contenthängt vonui.appsab
Abhängigkeiten von komplexen Bereitstellungspaketen
Komplexe Bereitstellungen gehen über den einfachen Fall hinaus und legen Abhängigkeiten zwischen den entsprechenden veränderbaren Inhalten und unveränderlichen Code-Paketen fest. Abhängigkeiten können bei Bedarf auch zwischen unveränderlichen Code-Paketen festgelegt werden.
-
allhat keine Abhängigkeitencommon.ui.apps.commonhat keine Abhängigkeitensite-a.ui.appshängt voncommon.ui.appsabsite-a.ui.contenthängt vonsite-a.ui.appsabsite-b.ui.appshängt voncommon.ui.appsabsite-b.ui.contenthängt vonsite-b.ui.appsab
Lokale Entwicklung und Bereitstellung
Die in diesem Artikel beschriebenen Projektstrukturen und -organisationen sind mit AEM-Instanzen für die lokale Entwicklung vollständig kompatibel.
POM-XML-Snippets
Im Folgenden finden Sie Maven pom.xml-Konfigurations-Snippets, die zu Maven-Projekten hinzugefügt werden können, um sie an die oben genannten Empfehlungen anzupassen.
Pakettypen
Code- und Inhaltspakete, die als Unterpakete bereitgestellt werden, müssen je nachdem, was sie enthalten, einen Pakettyp Anwendung oder Inhalt deklarieren.
Container-Pakettypen
Das Container-Projekt all/pom.xml deklariert keinen <packageType>.
(Unveränderliche) Code-Pakettypen
Code-Pakete müssen ihren packageType auf application setzen.
In der ui.apps/pom.xml deklariert die <packageType>application</packageType>-Build-Konfigurationsanweisung der filevault-package-maven-plugin-Plug-in-Deklaration den Pakettyp.
...
<build>
<plugins>
<plugin>
<groupId>org.apache.jackrabbit</groupId>
<artifactId>filevault-package-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
<group>${project.groupId}</group>
<name>my-app.ui.apps</name>
<packageType>application</packageType>
<accessControlHandling>merge</accessControlHandling>
<properties>
<cloudManagerTarget>none</cloudManagerTarget>
</properties>
</configuration>
</plugin>
...
(Veränderliche) Code-Pakettypen
Inhaltspakete müssen ihren packageType auf content setzen.
In der ui.content/pom.xml deklariert die <packageType>content</packageType>-Build-Konfigurationsanweisung der filevault-package-maven-plugin-Plug-in-Deklaration den Pakettyp.
...
<build>
<plugins>
<plugin>
<groupId>org.apache.jackrabbit</groupId>
<artifactId>filevault-package-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
<group>${project.groupId}</group>
<name>my-app.ui.content</name>
<packageType>content</packageType>
<accessControlHandling>merge</accessControlHandling>
<properties>
<cloudManagerTarget>none</cloudManagerTarget>
</properties>
</configuration>
</plugin>
...
Markieren von Paketen für die Bereitstellung über Adobe Cloud Manager
Fügen Sie in jedem Projekt, das ein Paket generiert, mit Ausnahme des Container-Projekts (all), <cloudManagerTarget>none</cloudManagerTarget> der <properties>-Konfiguration der filevault-package-maven-plugin-Plug-in-Deklaration hinzu, um sicherzustellen, dass sie nicht von Adobe Cloud Manager bereitgestellt werden. Das Container-Paket (all) sollte das Einzelpaket sein, das über Cloud Manager bereitgestellt wird. Dadurch werden alle erforderlichen Code- und Inhaltspakete eingebettet.
...
<build>
<plugins>
<plugin>
<groupId>org.apache.jackrabbit</groupId>
<artifactId>filevault-package-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
...
<properties>
<cloudManagerTarget>none</cloudManagerTarget>
</properties>
</configuration>
</plugin>
...
Repo Init
Repo Init-Skripte, die die Repo Init-Skripte enthalten, werden in der RepositoryInitializer-OSGi-Werkskonfiguration über die scripts-Eigenschaft definiert. Da diese Skripte in OSGi-Konfigurationen definiert sind, können sie mithilfe der üblichen ../config.<runmode>-Ordnersemantik problemlos vom Ausführungsmodus erfasst werden.
Da es sich bei Skripten normalerweise um mehrzeilige Deklarationen handelt, ist es einfacher, sie in der .config-Datei zu definieren als dem auf JSON-basierenden Format .cfg.json.
/apps/my-app/config.author/org.apache.sling.jcr.repoinit.RepositoryInitializer-author.config
scripts=["
create service user my-data-reader-service
set ACL on /var/my-data
allow jcr:read for my-data-reader-service
end
create path (sling:Folder) /conf/my-app/settings
"]
Die scripts-OSGi-Eigenschaft enthält Anweisungen, die in der Repo Init-Sprache von Apache Sling definiert sind.
Repository-Strukturpaket
Fügen Sie in ui.apps/pom.xml und allen anderen pom.xml, die ein Code-Paket (<packageType>application</packageType>) deklarieren, die folgende Repository-Strukturpaketkonfiguration zum FileVault Maven-Plug-in hinzu. Sie können Ihr eigenes Repository-Strukturpaket für Ihr Projekt erstellen.
...
<build>
<plugins>
<plugin>
<groupId>org.apache.jackrabbit</groupId>
<artifactId>filevault-package-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
...
<repositoryStructurePackages>
<repositoryStructurePackage>
<groupId>${project.groupId}</groupId>
<artifactId>ui.apps.structure</artifactId>
<version>${project.version}</version>
</repositoryStructurePackage>
</repositoryStructurePackages>
</configuration>
</plugin>
...
Einbetten von Unterpaketen in das Container-Paket
Fügen Sie in all/pom.xml der Plug-in-Deklaration filevault-package-maven-plugin die folgenden <embeddeds>-Anweisungen hinzu. Denken Sie daran, nicht die <subPackages>-Konfiguration zu verwenden. Der Grund dafür ist, dass sie die Unterpakete in /etc/packages anstelle von /apps/my-app-packages/<application|content|container>/install(.author|.publish)? einbezieht.
...
<plugin>
<groupId>org.apache.jackrabbit</groupId>
<artifactId>filevault-package-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
...
<embeddeds>
<!-- Include the application's ui.apps and ui.content packages -->
<!-- Ensure the artifactIds are correct -->
<!-- OSGi Bundle Jar file that deploys to BOTH AEM Author and AEM Publish -->
<embedded>
<groupId>${project.groupId}</groupId>
<artifactId>my-app.core</artifactId>
<type>jar</type>
<target>/apps/my-app-packages/application/install</target>
</embedded>
<!-- Code package that deploys to BOTH AEM Author and AEM Publish -->
<embedded>
<groupId>${project.groupId}</groupId>
<artifactId>my-app.ui.apps</artifactId>
<type>zip</type>
<target>/apps/my-app-packages/application/install</target>
</embedded>
<!-- OSGi configuration code package that deploys to BOTH AEM Author and AEM Publish -->
<embedded>
<groupId>${project.groupId}</groupId>
<artifactId>my-app.ui.config</artifactId>
<type>zip</type>
<target>/apps/my-app-packages/application/install</target>
</embedded>
<!-- Code package that deploys ONLY to AEM Author -->
<embedded>
<groupId>${project.groupId}</groupId>
<artifactId>my-app.ui.apps.author</artifactId>
<type>zip</type>
<target>/apps/my-app-packages/application/install.author</target>
</embedded>
<!-- Content package that deploys to BOTH AEM Author and AEM Publish -->
<embedded>
<groupId>${project.groupId}</groupId>
<artifactId>my-app.ui.content</artifactId>
<type>zip</type>
<target>/apps/my-app-packages/content/install</target>
</embedded>
<!-- Content package that deploys ONLY to AEM Publish -->
<embedded>
<groupId>${project.groupId}</groupId>
<artifactId>my-app.ui.content.publish-only</artifactId>
<type>zip</type>
<target>/apps/my-app-packages/content/install.publish</target>
</embedded>
<!-- Include any other extra packages -->
<embedded>
<groupId>com.vendor.x</groupId>
<artifactId>vendor.plug-in.all</artifactId>
<type>zip</type>
<target>/apps/vendor-packages/container/install</target>
</embedded>
<embeddeds>
</configuration>
</plugin>
...
Filterdefinition des Container-Pakets
Sie müssen in der filter.xml (all/src/main/content/jcr_root/META-INF/vault/definition/filter.xml) des all-Projekts alle -packages-Ordner einschließen, die Unterpakete enthalten, die bereitgestellt werden sollen:
<filter root="/apps/my-app-packages"/>
Wenn mehrere /apps/*-packages in den eingebetteten Zielen verwendet werden, müssen sie hier alle aufgezählt werden.
Maven-Repositorys von Drittanbietern
WARNINGFügen Sie in der pom.xml des Reaktorprojekts alle erforderlichen öffentlichen Maven-Repository-Anweisungen von Drittanbietern hinzu. Die vollständige <repository>-Konfiguration sollte beim Repository-Drittanbieter erhältlich sein.
<repositories>
...
<repository>
<id>3rd-party-repository</id>
<name>Public Third-Party Repository</name>
<url>https://repo.3rdparty.example.com/...</url>
<releases>
<enabled>true</enabled>
<updatePolicy>never</updatePolicy>
</releases>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
...
</repositories>
Paketabhängigkeiten zwischen den ui.apps von ui.content-Paketen
Fügen Sie in ui.content/pom.xml der filevault-package-maven-plugin-Plug-in-Deklaration die folgenden <dependencies>-Anweisungen hinzu.
...
<plugin>
<groupId>org.apache.jackrabbit</groupId>
<artifactId>filevault-package-maven-plugin</artifactId>
<extensions>true</extensions>
<configuration>
...
<dependencies>
<!-- Declare the content package dependency in the ui.content/pom.xml on the ui.apps project -->
<dependency>
<groupId${project.groupId}</groupId>
<artifactId>my-app.ui.apps</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
...
</configuration>
</plugin>
...
Bereinigen des Zielordners des Container-Projekts
Fügen Sie in all/pom.xml das Plug-in maven-clean-plugin hinzu, das das Zielverzeichnis vor einem Maven-Build bereinigt.
<plugins>
...
<plugin>
<artifactId>maven-clean-plugin</artifactId>
<executions>
<execution>
<id>auto-clean</id>
<!-- Run at the beginning of the build rather than the default, which is after the build is done -->
<phase>initialize</phase>
<goals>
<goal>clean</goal>
</goals>
</execution>
</executions>
</plugin>
...
</plugins>