Package Manager working-with-packages

Pakete bieten Ihnen die Möglichkeit, Repository-Inhalte zu importieren und zu exportieren. Sie können Pakete verwenden, um neue Inhalte zu installieren, neue Funktionen zu installieren, Inhalte zwischen Instanzen auszutauschen und Repository-Inhalte zu sichern.

Mithilfe von Package Manager können Sie Pakete zu Entwicklungszwecken zwischen Ihrer AEM-Instanz und Ihrem lokalen Dateisystem übertragen.

Was sind Pakete? what-are-packages

Ein Paket ist eine ZIP-Datei, die Repository-Inhalte in einer serialisierten Form des Dateisystems enthält, die Vault-Serialisierung genannt wird und eine benutzerfreundliche und einfach zu bearbeitende Darstellung von Dateien und Ordnern bietet. Der im Paket enthaltene Inhalt wird mithilfe von Filtern definiert.

Ein Paket enthält auch Vault-Metadaten, einschließlich der Filterdefinitionen und Informationen zur Import-Konfiguration. Zusätzliche Inhaltseigenschaften, die nicht für die Paketextraktion verwendet werden, können mit in das Paket aufgenommen werden, z. B. eine Beschreibung, ein visuelles Bild oder ein Symbol. Diese zusätzlichen Inhaltseigenschaften dienen nur dem Verwender des Inhaltspakets und nur zu Informationszwecken.

Package Manager package-manager

Package Manager verwaltet die Pakete auf Ihrer AEM-Installation. Nachdem Sie die erforderlichen Berechtigungen zugewiesen haben, können Sie Package Manager für verschiedene Aktionen, u. a. zum Konfigurieren, Erstellen, Herunterladen und Installieren von Paketen, verwenden.

Erforderliche Berechtigungen required-permissions

Um Pakete erstellen, ändern, hochladen und installieren zu können, müssen Benutzer über die entsprechenden Berechtigungen für die folgenden Knoten verfügen:

Zugriff auf Package Manager accessing

Sie haben drei Möglichkeiten, auf Package Manager zuzugreifen:

Benutzeroberfläche von Package Manager ui

Package Manager ist in vier Hauptfunktionsbereiche unterteilt:

Wenn Sie im linken Navigationsbereich auf eine Option klicken, wird die Paketliste sofort gefiltert.

Wenn Sie auf einen Paketnamen klicken, wird der Eintrag in der Paketliste erweitert, um weitere Details zum Paket anzuzeigen.

Es gibt eine Reihe von Aktionen, die für ein Paket über die Schaltflächen der Symbolleiste ausgeführt werden können, welche verfügbar sind, wenn die Paketdetails erweitert werden.

Unterhalb der Schaltfläche Mehr stehen weitere Aktionen zur Verfügung.

Paketstatus package-status

Jeder Eintrag in der Paketliste ist mit einem Statusindikator versehen, so dass Sie auf einen Blick den Status des Pakets erkennen können. Wenn Sie den Mauszeiger über den Status bewegen, wird eine QuickInfo mit Details zum Status angezeigt.

Wenn das Paket geändert wurde oder noch nie aufgebaut wurde, wird der Status als Link angezeigt, über den schnell gehandelt werden kann, um das Paket neu zu aufzubauen oder zu installieren.

Paketeinstellungen package-settings

Ein Paket ist im Wesentlichen ein Satz von Filtern und den Repository-Daten, die auf diesen Filtern basieren. Mithilfe der Package Manager-Benutzeroberfläche können Sie auf ein Paket und dann auf die Schaltfläche Bearbeiten klicken, um die Details eines Pakets einschließlich der folgenden Einstellungen anzuzeigen.

Allgemeine Einstellungen general-settings

Sie können eine Vielzahl von Paketeinstellungen bearbeiten, um Informationen wie die Paketbeschreibung, Abhängigkeiten und Anbieterinformationen zu definieren.

Das Dialogfeld Paketeinstellungen ist über die Schaltfläche Bearbeiten beim Erstellen oder Bearbeiten eines Pakets verfügbar. Nachdem Sie Änderungen vorgenommen haben, klicken Sie auf Speichern.

Miniaturansichten von Paketen thumbnails

Eine Miniaturansicht bietet eine schnelle visuelle Darstellung dessen, was das Paket enthält. Dieses wird dann in der Liste der Pakete angezeigt und ermöglicht Ihnen, das Paket oder die Klasse des Pakets auf einfache Weise zu erkennen.

Unter anderem die folgenden Konventionen werden für offizielle Pakete verwendet:

Offizielles Hotfix

Offizielle AEM-Installation der Erweiterung

Offizielles Service Pack

Verwenden Sie ein eindeutiges Symbol für Ihr Paket. Verwenden Sie kein von Adobe verwendetes Symbol erneut.

Paketfilter package-filters

Filter identifizieren die Repository-Knoten, die in das Paket eingeschlossen werden sollen. Eine Filterdefinition legt die folgenden Informationen fest:

Sie können Regeln mithilfe der Schaltfläche + hinzufügen. Sie können Regeln mithilfe der Schaltfläche - entfernen.

Regeln werden entsprechend ihrer Reihenfolge angewendet. Positionieren Sie sie daher mit den Schaltflächen Nach oben und Nach unten wie gewünscht.

Filter können keine oder mehr Regeln enthalten. Wenn keine Regeln definiert sind, enthält das Paket alle Inhalte unter dem Stammpfad.

Sie können eine oder mehrere Filterdefinitionen für ein Paket definieren. Verwenden Sie mehr als einen Filter, um Inhalte von mehreren Stammpfaden einzuschließen.

Beim Erstellen von Regeln definieren Sie einen regulären Ausdruck (auch als regex, regexp oder rationaler Ausdruck bezeichnet), um alle Knoten anzugeben, die ein- bzw. ausgeschlossen werden sollen.

Paketfilter werden meistens definiert, wenn Sie das Paket zum ersten Mal erstellen. Sie können jedoch auch später bearbeitet werden. Danach sollte das Paket neu aufgebaut werden, um seinen Inhalt basierend auf den neuen Filterdefinitionen zu aktualisieren.

Abhängigkeiten dependencies

Erweiterte Einstellungen advanced-settings

Paket-Screenshots package-screenshots

Sie können mehrere Screenshots an Ihr Paket anhängen, um eine visuelle Darstellung des Inhalts zu erhalten.

Paketaktionen package-actions

Es gibt viele Aktionen, die mit einem Paket durchgeführt werden können.

Erstellen eines Pakets creating-a-new-package

Es ist nicht zwingend erforderlich, das Paket sofort nach seiner Erstellung aufzubauen. Ein nicht aufgebautes Paket enthält keinen Inhalt und besteht nur aus den Filterdaten und anderen Metadaten des Pakets.

Aufbauen eines Pakets building-a-package

Ein Paket wird oft gleich beim Erstellen des Pakets aufgebaut, aber Sie können zu einem späteren Zeitpunkt zurückkehren, um das Paket entweder aufzubauen oder neu aufzubauen. Dies kann nützlich sein, wenn sich der Inhalt im Repository geändert hat oder sich die Paketfilter geändert haben.

Bearbeiten eines Pakets edit-package

Nachdem ein Paket in AEM hochgeladen wurde, können Sie seine Einstellungen ändern.

Möglicherweise müssen Sie das Paket neu aufbauen, um seinen Inhalt auf Grundlage der von Ihnen vorgenommenen Änderungen zu aktualisieren.

Neuverpacken eines Pakets rewrapping-a-package

Sobald ein Paket aufgebaut wurde, kann es neu verpackt werden. Beim Neuverpacken werden die Paketinformationen wie Miniaturansicht, Beschreibung usw. geändert, ohne dass der Inhalt des Pakets geändert wird.

Anzeigen anderer Paketversionen other-versions

Da jede Version eines Pakets in der Liste ebenso wie jedes andere Paket angezeigt wird, kann Package Manager andere Versionen eines ausgewählten Pakets finden.

Anzeigen von Paketinhalten und Testen der Installation viewing-package-contents-and-testing-installation

Nach dem Aufbau eines Pakets können Sie dessen Inhalt anzeigen.

Herunterladen von Paketen in das Dateisystem downloading-packages-to-your-file-system

Freigeben eines Pakets share

Package Share war ein zentralisierter öffentlicher Dienst zur Verteilung von Inhaltspaketen. Package Share wurde durch Softwareverteilung abgelöst. Diese Schaltfläche funktioniert nicht mehr.

Hochladen von Paketen vom Dateisystem uploading-packages-from-your-file-system

Der Paketinhalt ist jetzt in AEM vorhanden. Um den Inhalt jedoch verfügbar zu machen, müssen Sie sicherstellen, dass Sie das Paket installieren.

Validieren von Paketen validating-packages

Da Pakete vorhandene Inhalte ändern können, ist es oft nützlich, diese Änderungen vor der Installation zu validieren.

Validierungsoptionen validation-options

Package Manager kann die folgenden Validierungen durchführen:

Validieren von OSGi-Paketimporten osgi-package-imports

Folgendes wird geprüft

Diese Validierung prüft das Paket auf JAR-Dateien (OSGi-Bundles), extrahiert deren Datei manifest.xml (die die versionierten Abhängigkeiten enthält, die für das OSGi-Bundle erforderlich sind) und stellt sicher, dass die AEM-Instanz diese Abhängigkeiten mit den richtigen Versionen exportiert.

Wie die Berichterstellung erfolgt

Eventuelle versionierte Abhängigkeiten, die von der AEM-Instanz nicht erfüllt werden können, werden im Aktivitätsprotokoll von Package Manager aufgeführt.

Fehlerstatus

Wenn Abhängigkeiten nicht erfüllt sind, werden die OSGi-Bundles in dem Paket mit diesen Abhängigkeiten nicht gestartet. Dies führt zu einer fehlerhaften Bereitstellung des Programms, da alle auf dem nicht gestarteten OSGi-Bundle basierenden Prozesse nicht ordnungsgemäß funktionieren.

Fehlerbehebung

Um Fehler aufgrund nicht erfüllter OSGi-Bundles zu beheben, muss die Abhängigkeitsversion in dem Bundle mit nicht erfüllten Importen angepasst werden.

Bestätigen von Überlagerungen overlays

Was wird geprüft?

Diese Validierung ermittelt, ob das zu installierende Paket eine Datei enthält, die in der AEM-Zielinstanz bereits überlagert ist.

Beispiel: Bei einer bestehenden Überlagerung unter /apps/sling/servlet/errorhandler/404.jsp ändert ein Paket, das /libs/sling/servlet/errorhandler/404.jsp enthält, die vorhandene Datei unter /libs/sling/servlet/errorhandler/404.jsp.

Wie die Berichterstellung erfolgt

Solche Überlagerungen werden im Aktivitätsprotokoll von Package Manager beschrieben.

Fehlerstatus

Ein Fehlerstatus bedeutet, dass das Paket versucht, eine bereits überlagerte Datei bereitzustellen. Die Änderungen im Paket werden somit durch die Überlagerung überschrieben (und so „ausgeblendet“) und nicht umgesetzt.

Fehlerbehebung

Zur Behebung dieses Problems muss der Verantwortliche für die Überlagerungsdatei unter /apps die Änderungen an der überlagerten Datei unter /libs überprüfen, die Änderungen nach Bedarf in die Überlagerung ( /apps) integrieren und dann die überlagerte Datei erneut bereitstellen.

Bestätigen von ACLs acls

Was wird geprüft?

Diese Validierung prüft, welche Berechtigungen hinzugefügt werden, wie sie verarbeitet werden (Zusammenführen/Ersetzen) und ob die aktuellen Berechtigungen betroffen sind.

Wie die Berichterstellung erfolgt

Die Berechtigungen werden im Aktivitätsprotokoll von Package Manager beschrieben.

Fehlerstatus

Es können keine expliziten Fehler angegeben werden. Die Validierung gibt lediglich an, ob durch die Installation des Pakets neue ACL-Berechtigungen hinzugefügt oder aktuelle beeinträchtigt werden.

Fehlerbehebung

Anhand der von der Validierung bereitgestellten Informationen können die betroffenen Knoten in CRXDE überprüft und die ACLs nach Bedarf im Paket angepasst werden.

Durchführen der Validierung performing-validation

Die Validierung von Paketen kann auf zwei verschiedene Arten erfolgen:

Führen Sie die Validierung stets nach dem Hochladen und vor dem Installieren eines Pakets durch.

Paketvalidierung über Package Manager via-package-manager

Paketvalidierung über HTTP-POST-Anfrage via-post-request

Die POST-Anfrage hat folgendes Format.

https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls

Der Parameter type kann eine ungeordnete und durch Kommas getrennte Liste aus folgenden Elementen sein:

Der Wert von type ist standardmäßig osgiPackageImports, falls kein anderer Wert ausdrücklich angegeben wird.

Wenn Sie cURL verwenden, führen Sie eine Anweisung ähnlich der folgenden aus:

curl -v -X POST --user admin:admin -F file=@/Users/SomeGuy/Desktop/core.wcm.components.all-1.1.0.zip 'http://localhost:4502/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls'

Bei der Validierung über eine POST-Anfrage wird die Antwort als JSON-Objekt zurückgesendet.

Anzeigen der Paketabdeckung package-coverage

Pakete werden durch ihre Filter definiert. Sie können Package Manager anweisen, Filter eines Pakets auf Ihren vorhandenen Repository-Inhalt anzuwenden, um anzuzeigen, welcher Inhalt des Repositorys von der Filterdefinition des Pakets abgedeckt wird.

Installieren von Paketen installing-packages

Beim Hochladen eines Pakets wird nur der Paketinhalt zum Repository hinzugefügt, das Paket ist jedoch nicht verfügbar. Installieren Sie das hochgeladene Paket, um den Inhalt des Pakets verwenden zu können.

Vor der Installation Ihres Pakets erstellt Package Manager automatisch ein Snapshot-Paket, das den Inhalt enthält, der überschrieben wird. Dieser Snapshot wird wieder installiert, wenn Sie das Paket deinstallieren.

Sobald die Installation abgeschlossen und erfolgreich war, wird die Paketliste aktualisiert und das Wort Installiert im Paketstatus angezeigt.

Neuinstallation von Paketen reinstalling-packages

Bei der Neuinstallation von Paketen werden für ein bereits installiertes Paket die gleichen Schritte durchgeführt, die auch bei der Erstinstallation des Pakets durchgeführt werden.

Dateisystembasiertes Hochladen und Installieren file-system-based-upload-and-installation

Sie können bei der Installation von Paketen ganz auf Package Manager verzichten. AEM kann Pakete erkennen, die an einem bestimmten Speicherort im lokalen Dateisystem des Host-Computers abgelegt werden, und diese automatisch hochladen und installieren.

Wenn die Instanz ausgeführt wird, beginnen das Hochladen und die Installation sofort, wenn Sie sie zum Paket zum Ordner install hinzufügen

Wenn die Instanz nicht ausgeführt wird, werden Pakete, die sich im Ordner install befinden, beim Start in alphabetischer Reihenfolge installiert.

Deinstallieren von Paketen uninstalling-packages

Durch die Deinstallation eines Pakets wird der Inhalt des Repositorys auf den Schnappschuss zurückgesetzt, der von Package Manager vor der Installation automatisch erstellt wurde.

Löschen von Paketen deleting-packages

Beim Löschen eines Pakets werden nur dessen Details aus Package Manager gelöscht. Falls dieses Paket bereits installiert wurde, werden die installierten Inhalte nicht gelöscht.

Replizieren von Paketen replicating-packages

Replizieren Sie den Inhalt eines Pakets, um es auf der Veröffentlichungsinstanz zu installieren.

Software Distribution software-distribution

AEM-Pakete können verwendet werden, um Inhalte über AEM-Umgebungen hinweg zu erstellen und freizugeben.

Softwareverteilung ist ein zentralisierter Dienst, der die Suche und den Download AEM Packages vereinfacht.

Weitere Informationen finden Sie unter Dokumentation zur Software-Verteilung.