Pakketbeheer working-with-packages
Pakketten maken het importeren en exporteren van inhoud in de opslagplaats mogelijk. U kunt pakketten gebruiken om nieuwe inhoud te installeren, nieuwe functionaliteit te installeren, inhoud over te brengen tussen instanties, en file bewaarplaats inhoud.
Met Package Manager kunt u pakketten overbrengen tussen uw AEM en uw lokale bestandssysteem voor ontwikkelingsdoeleinden.
Wat zijn pakketten? what-are-packages
Een pakket is een gecomprimeerd bestand met opslagplaats-inhoud in serialisatie van het bestandssysteem, zogenaamde vault serialization, waarmee bestanden en mappen eenvoudig kunnen worden weergegeven en bewerkt. Inhoud in het pakket wordt met filters gedefinieerd.
Een pakket bevat ook vault meta-informatie, met inbegrip van de filterdefinities en de informatie van de de invoerconfiguratie. Extra eigenschappen van inhoud, die niet worden gebruikt voor het uitpakken van pakketten, kunnen in het pakket worden opgenomen, zoals een beschrijving, een visuele afbeelding of een pictogram. Deze eigenschappen voor extra inhoud zijn alleen bedoeld voor de consument van het inhoudspakket en alleen ter informatie.
Pakketbeheer package-manager
Pakketbeheer beheert de pakketten op de AEM installatie. Nadat u de noodzakelijke toestemmingenhebt toegewezen kunt u de Manager van het Pakket voor diverse acties, met inbegrip van het vormen, het bouwen, het downloaden, en het installeren van uw pakketten gebruiken.
Vereiste machtigingen required-permissions
Gebruikers moeten over de juiste machtigingen beschikken voor het maken, wijzigen, uploaden en installeren van pakketten:
- Volledige rechten behalve verwijderen op
/etc/packages
- The node that contains the package contents
Pakketbeheer openen accessing
U kunt tot de Manager van het Pakket op drie manieren toegang hebben:
- Van het AEM belangrijkste menu > Hulpmiddelen > Plaatsing > Pakketten
- Van CRXDE Litegebruikend de hoogste schakelaarbar
- Direct via
http://<host>:<port>/crx/packmgr/
Gebruikersinterface pakketbeheer ui
Pakketbeheer is verdeeld in vier belangrijke functionele gebieden:
-
Linkerpaneel van de Navigatie - dit paneel laat u filteren en de lijst van pakketten sorteren.
-
Lijst van het Pakket - dit is de lijst van pakketten op uw instantie gefiltreerd en gesorteerd per selecties in het Linkerpaneel van de Navigatie.
-
Logboek van de Activiteit - Dit paneel wordt geminimaliseerd eerst en breidt zich uit om de activiteit van de Manager van het Pakket zoals te detailleren wanneer een pakket wordt gebouwd of geïnstalleerd. Er zijn extra knoppen op het tabblad Activiteitenlog voor:
- Duidelijk Logboek
- tonen/verbergen
-
Toolbar - de toolbar bevat vernieuwt knopen voor het Linkerpaneel van de Navigatie en de lijst van het Pakket en knopen voor het zoeken, het creëren, en het uploaden van pakketten.
Wanneer u op een optie in het linkernavigatievenster klikt, wordt de pakketlijst direct gefilterd.
Wanneer u op een pakketnaam klikt, wordt het item in de pakketlijst uitgebreid en worden meer details over het pakket weergegeven.
Er is een aantal acties dat op een pakket via de beschikbare toolbarknopen kan worden ondernomen wanneer het pakketdetail wordt uitgebreid.
De verdere acties zijn beschikbaar onder Meer knoop.
Pakketstatus package-status
Elk item in de pakketlijst heeft een statusindicator waarmee u in één oogopslag de status van het pakket kunt zien. Als u de muisaanwijzer boven de status houdt, wordt knopinfo met de details van de status weergegeven.
Als het pakket is gewijzigd of nooit is gemaakt, wordt de status weergegeven als een koppeling waarmee u snel actie kunt ondernemen om het pakket opnieuw samen te stellen of te installeren.
Pakketinstellingen package-settings
Een pakket is in wezen een set filters en de gegevens in de opslagplaats op basis van die filters. Gebruikend de Manager UI van het Pakket, kunt u een pakket klikken en dan uitgeven knoop om de details van een pakket met inbegrip van de volgende montages te bekijken.
Algemene instellingen general-settings
U kunt diverse pakketinstellingen bewerken om informatie te definiëren, zoals de pakketbeschrijving, afhankelijkheden en providerdetails.
De dialoog van de Montages van het Pakket is beschikbaar via geeft knoop uit wanneer creërendof uitgevendeen pakket. Nadat om het even welke veranderingen worden aangebracht, klik sparen.
Miniaturen pakket thumbnails
Een miniatuur geeft snel een visuele referentie van wat het pakket bevat. Dit wordt vervolgens weergegeven in de pakketlijst en kan u helpen het pakket of de klasse van het pakket gemakkelijk te identificeren.
Hieronder volgen voorbeelden van conventies voor officiële pakketten:
Officiële hotfix
Officiële AEM installatie van de extensie
Officieel servicepakket
Gebruik een uniek pictogram voor uw pakket. Gebruik een pictogram dat door de Adobe wordt gebruikt niet opnieuw.
Pakketfilters package-filters
Filters identificeren de knooppunten in de opslagplaats die in het pakket moeten worden opgenomen. A Definitie van de Filter specificeert de volgende informatie:
- De Weg van de Wortel van de te omvatten inhoud
- Regels die specifieke knopen onder de wortelweg omvatten of uitsluiten
Voeg regels toe gebruikend + knoop. Verwijder regels met de knop - .
De regels worden toegepast volgens hun orde zodat plaats hen zoals vereist gebruikend Omhoog en Omlaag pijlknopen.
Filters kunnen nul of meer regels bevatten. Als er geen regels zijn gedefinieerd, bevat het pakket alle inhoud onder het hoofdpad.
U kunt een of meer filterdefinities definiëren voor een pakket. Gebruik meerdere filters om inhoud van meerdere hoofdpaden op te nemen.
Wanneer u regels maakt, definieert u een reguliere expressie (ook wel regex, regexp of rationele expressie genoemd) om alle knooppunten op te geven die u wilt opnemen in of uitsluiten.
De filters van het pakket worden het vaakst bepaald wanneer u eerst het pakket creeert. Deze kunnen echter ook later worden bewerkt. Vervolgens moet het pakket opnieuw worden samengesteld om de inhoud bij te werken op basis van de nieuwe filterdefinities.
Afhankelijkheden dependencies
6.5
groupId:name:version
groupId:name:version
Geavanceerde instellingen advanced-settings
WKND Media Group
https://wknd.site
https://wknd.site/package/
opnieuw beginnen worden geïnstalleerd - AEM moet na het installeren van het pakket opnieuw worden begonnen
overschrijft - Overschrijf ACLs in de bewaarplaats
Samenvoegen - fusie beide reeksen ACLs
MergePreserve - de toegangscontrole van de fusie in de inhoud met het pakket door de toegangsbeheeringangen van hoofden toe te voegen die niet in de inhoud
duidelijk zijn - ACLs
Schermafbeeldingen verpakken package-screenshots
U kunt meerdere schermafbeeldingen aan het pakket toevoegen om een visuele weergave van de weergave van de inhoud te bieden.
Pakkethandelingen package-actions
Er zijn vele acties die op een pakket kunnen worden ondernomen.
Een pakket maken creating-a-new-package
-
Klik Create Pakket.
note tip TIP Als uw instantie vele pakketten heeft, zou er een omslagstructuur op zijn plaats kunnen zijn. In dergelijke gevallen is het eenvoudiger om naar de vereiste doelmap te navigeren voordat u het nieuwe pakket maakt. -
In de Nieuwe dialoog van het Pakket, ga de volgende gebieden in:
-
Naam van het Pakket - selecteer een beschrijvende naam om u (en anderen) gemakkelijk te helpen de inhoud van het pakket identificeren.
-
Versie - dit is een tekstgebied voor u om op een versie te wijzen. Deze wordt aan de pakketnaam toegevoegd om de naam van het ZIP-bestand te vormen.
-
Groep - dit is de naam van de doelgroep (of omslag). Met groepen kunt u uw pakketten ordenen. Er wordt een map voor de groep gemaakt als deze nog niet bestaat. Als u de groepsnaam leeg laat, wordt het pakket gemaakt in de hoofdpakketlijst.
-
-
Klik OK om het pakket tot stand te brengen.
-
AEM geeft het nieuwe pakket boven aan de lijst met pakketten weer.
-
Klik uitgeven om de pakketinhoud te bepalen. klik sparen nadat u wordt gebeëindigd het uitgeven van de montages.
-
U kunt nu bouwenuw pakket.
Het is niet verplicht om het pakket onmiddellijk na het maken ervan te bouwen. Een ongebouwd pakket bevat geen inhoud en bestaat alleen uit de filtergegevens en andere metagegevens van het pakket.
Een pakket maken building-a-package
Een pakket wordt vaak gebouwd tezelfdertijd aangezien u het pakketcreeert, maar u kunt op een recentere punt terugkeren om of het pakket te bouwen of opnieuw te bouwen. Dit kan nuttig zijn als de inhoud in de opslagplaats is gewijzigd of de pakketfilters zijn gewijzigd.
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Klik bouwen. Er wordt een dialoogvenster weergegeven waarin u moet bevestigen dat u het pakket wilt maken, aangezien bestaande pakketinhoud wordt overschreven.
-
Klik OK. AEM bouwt het pakket en geeft alle inhoud weer die aan het pakket is toegevoegd, zoals dit gebeurt in de lijst met activiteiten. Na voltooiing AEM wordt bevestigd dat het pakket is gemaakt en (wanneer u het dialoogvenster sluit) worden de gegevens in de pakketlijst bijgewerkt.
Een pakket bewerken edit-package
Nadat een pakket is geüpload naar AEM, kunt u de instellingen wijzigen.
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Klik uitgeven en werk de Montages van het Pakket zoals vereist bij.
-
Klik sparen om te bewaren.
U kunt het pakket 🔗 moeten herbouwen om zijn inhoud bij te werken die op de veranderingen wordt gebaseerd u aanbracht.
Een pakket opnieuw inpakken rewrapping-a-package
Nadat een pakket is gemaakt, kan het opnieuw worden verpakt. Wanneer u de pakketgegevens opnieuw inpakt, worden deze zonder miniatuur, beschrijving, enzovoort gewijzigd, zonder dat de pakketinhoud wordt gewijzigd.
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Klik uitgeven en werk de Montages van het Pakket zoals vereist bij.
-
Klik sparen om te bewaren.
-
Klik Meer > Terugloop en een dialoog zal om bevestiging vragen.
Andere pakketversies weergeven other-versions
Omdat elke versie van een pakket in de lijst verschijnt zoals elk ander pakket, kan de Manager van het Pakket andere versies van een geselecteerd pakket vinden.
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Klik Meer > Andere Versies en een dialoog opent met een lijst van andere versies van het zelfde pakket met statusinformatie.
Inhoud van pakket weergeven en installatie testen viewing-package-contents-and-testing-installation
Nadat een pakket is samengesteld, kunt u de inhoud bekijken.
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Om de inhoud te bekijken, klik Meer > Inhoud, en de Manager van het Pakket maakt een lijst van de volledige inhoud van het pakket in het activiteitenlogboek.
-
Om een droge looppas van de installatie uit te voeren klik Meer > de Test installeert en de rapporten van de Manager van het Pakket in het activiteitenlogboek de resultaten alsof de installatie werd uitgevoerd.
Pakketten naar uw bestandssysteem downloaden downloading-packages-to-your-file-system
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Klik de knoop van de Download of de verbonden dossiernaam van het pakket in het gebied van pakketdetails.
-
AEM downloadt het pakket naar uw computer.
Een pakket delen share
Het Aandeel van het pakket was een gecentraliseerde openbare dienst om inhoudspakketten te verspreiden. Het Aandeel van het pakket is vervangen door Distributie van de Softwareen deze knoop werkt niet meer.
Pakketten uploaden vanuit uw bestandssysteem uploading-packages-from-your-file-system
-
Selecteer de groepsmap waarin u het pakket wilt uploaden.
-
Klik uploadt Pakket knoop.
-
Geef de benodigde informatie over het geüploade pakket.
- Pakket - gebruik doorbladert… knoop om het vereiste pakket van uw lokaal dossiersysteem te selecteren.
- de Kracht uploadt - als een pakket met deze naam reeds bestaat, dwingt deze optie uploadt en het bestaande pakket beschrijft.
-
Klik O.K. en het geselecteerde pakket wordt geupload en de pakketlijst wordt dienovereenkomstig bijgewerkt.
De pakketinhoud bestaat nu op AEM, maar om de inhoud voor gebruik beschikbaar te maken, ben zeker om het pakket 🔗 te installeren.
Pakketten valideren validating-packages
Omdat pakketten bestaande inhoud kunnen wijzigen, is het vaak handig om deze wijzigingen te valideren voordat u ze installeert.
Validatieopties validation-options
Pakketbeheer kan de volgende validaties uitvoeren:
OSGi-pakketinvoer valideren osgi-package-imports
wat wordt gecontroleerd
Deze bevestiging inspecteert het pakket voor alle JAR dossiers (bundels OSGi), haalt hun manifest.xml
uit (die de versioned gebiedsdelen bevat waarop genoemde bundel OSGi) vertrouwt), en verifieert de AEM instantie uitvoert genoemde gebiedsdelen met de correcte versies.
hoe het wordt gemeld
Om het even welke versioned gebiedsdelen die niet door de AEM instantie kunnen worden tevredengesteld zijn vermeld in het Logboek van de Activiteit van de Manager van het Pakket.
de Staten van de Fout
Als de gebiedsdelen ontevreden zijn, dan zullen de bundels OSGi in het pakket met die gebiedsdelen niet beginnen. Dit resulteert in een gebroken toepassingsplaatsing aangezien om het even wat die op de unstarted bundel OSGi baseert zal beurtelings niet behoorlijk functioneren.
Resolutie van de Fout
Om fouten wegens ontevreden bundels op te lossen OSGi, moet de gebiedsdeelversie in de bundel met ontevreden invoer worden aangepast.
Bedekkingen valideren overlays
wat wordt gecontroleerd
Deze validatie bepaalt of het pakket dat wordt geïnstalleerd een bestand bevat dat al wordt bedekt in de AEM.
Als u bijvoorbeeld een bestaande overlay van /apps/sling/servlet/errorhandler/404.jsp
gebruikt, een pakket dat /libs/sling/servlet/errorhandler/404.jsp
bevat, zodat het bestaande bestand van /libs/sling/servlet/errorhandler/404.jsp
wordt gewijzigd.
hoe het wordt uitgevoerd
Dergelijke overlays worden beschreven in het activiteitenlogboek van Package Manager.
de Staten van de Fout
Een foutstatus houdt in dat het pakket probeert een bestand te implementeren dat al is bedekt. De wijzigingen in het pakket worden dus overschreven (en dus "verborgen") door de bedekking en worden niet van kracht.
Resolutie van de Fout
Om dit probleem op te lossen, moet de beheerder van het overlaybestand in /apps
de wijzigingen in het overlay-bestand in /libs
controleren en de wijzigingen naar wens opnemen in de overlay ( /apps
) en het overlay-bestand opnieuw gebruiken.
ACLs bevestigen acls
wat wordt gecontroleerd
Deze bevestiging controleert welke toestemmingen worden toegevoegd, hoe zij zullen worden behandeld (samenvoegen/vervangen), en als de huidige toestemmingen zullen worden beïnvloed.
hoe het wordt gemeld
De toestemmingen worden beschreven in het Logboek van de Activiteit van de Manager van het Pakket.
de Staten van de Fout
Er kunnen geen expliciete fouten worden opgegeven. De bevestiging wijst eenvoudig erop of om het even welke nieuwe ACL toestemmingen zullen worden toegevoegd of beïnvloed door het pakket te installeren.
Resolutie van de Fout
Gebruikend de informatie die door de bevestiging wordt verstrekt, kunnen de beïnvloede knopen in CRXDE worden herzien en ACLs kan in het pakket aanpassen zoals nodig.
Validatie uitvoeren performing-validation
De validatie van pakketten kan op twee verschillende manieren worden uitgevoerd:
Validatie moet altijd plaatsvinden na het uploaden van het pakket, maar voordat het wordt geïnstalleerd.
Pakketvalidatie via pakketbeheer via-package-manager
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Om het pakket te bevestigen, klik Meer > bevestigen,
-
In het modale dialoogvakje dat dan verschijnt, gebruik checkboxes om het type (de) bevestiging te selecteren en met de bevestiging te beginnen door te klikken bevestigt.
-
De gekozen validatie(s) worden dan uitgevoerd en de resultaten worden weergegeven in het activiteitenlog van Package Manager.
Pakketvalidatie via HTTP POST Request via-post-request
Het verzoek van de POST heeft de volgende vorm.
https://<host>:<port>/crx/packmgr/service.jsp?cmd=validate&type=osgiPackageImports,overlays,acls
De parameter type
kan elke door komma's gescheiden, ongeordende lijst zijn die bestaat uit:
osgiPackageImports
overlays
acls
De waarde van type
wordt standaard ingesteld op osgiPackageImports
als dit niet expliciet wordt doorgegeven.
Wanneer u cURL gebruikt, voert u een instructie uit die vergelijkbaar is met het volgende:
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'
Bij validatie via een aanvraag voor een POST wordt het antwoord teruggestuurd als een JSON-object.
Pakketdekking weergeven package-coverage
Pakketten worden gedefinieerd door hun filters. U kunt Package Manager filters van een pakket op uw bestaande opslagplaats inhoud laten toepassen om te tonen welke inhoud van de bewaarplaats door de filterdefinitie van het pakket wordt behandeld.
-
Open de pakketdetails uit de pakketlijst door op de pakketnaam te klikken.
-
Klik Meer > Dekking.
-
De dekkingsdetails worden vermeld in het activiteitenlog.
Pakketten installeren installing-packages
Wanneer u een pakket uploadt, wordt alleen de pakketinhoud aan de opslagplaats toegevoegd, maar deze is niet toegankelijk. Installeer het geüploade pakket om de inhoud van het pakket te gebruiken.
Voordat u het pakket installeert, maakt Package Manager automatisch een pakket met momentopnamen dat de inhoud bevat die wordt overschreven. Deze momentopname wordt opnieuw geïnstalleerd als u het pakket verwijdert.
- Als u digitale elementen installeert, moet u:
Deactiveer eerst de WorkflowLauncher.
Gebruik de het menuoptie van Componenten van de console OSGi om te deactiverencom.day.cq.workflow.launcher.impl.WorkflowLauncherImpl.
- Vervolgens activeert u de WorkflowLauncher opnieuw wanneer de installatie is voltooid.
-
Open in de pakketlijst de pakketdetails van het pakket dat u wilt installeren door op de pakketnaam te klikken.
-
Of klik installeer knoop in de puntdetails of installeer verbinding in de pakketstatus.
-
In een dialoogvenster wordt bevestiging aangevraagd en kunnen aanvullende opties worden opgegeven.
- Extraheer slechts - Extraheer het pakket slechts zodat geen momentopname wordt gecreeerd en daarom zal uninstall niet mogelijk zijn
- sparen Drempel - Aantal transiënte knopen tot de automatische besparing wordt teweeggebracht (verhoging als u gezamenlijke wijzigingsuitzonderingen ontmoet)
- trekt Subpackages - laat automatische extractie van subpakketten toe
- Behandeling van het Toegangsbeheer - specificeert hoe de toegangsbeheerinformatie die in het pakket wordt bepaald wordt behandeld wanneer het pakket geïnstalleerd is (de opties zijn het zelfde als geavanceerde pakketmontages)
- Afhandeling van Afhankelijkheden - specificeer hoe de gebiedsdelen tijdens installatie worden behandeld
-
Klik installeren.
-
In het activiteitenlog wordt de voortgang van de installatie beschreven.
Zodra de installatie volledig en succesvol is, wordt de pakketlijst bijgewerkt en het woord Geïnstalleerde verschijnt in de pakketstatus.
Pakketten opnieuw installeren reinstalling-packages
Het opnieuw installeren van pakketten voert de zelfde stappen op een reeds geïnstalleerd pakket uit dat wanneer eerst het pakket installeert.
Uploaden en installeren op basis van bestandssysteem file-system-based-upload-and-installation
U kunt pakketbeheer volledig verlaten wanneer het installeren van pakketten. AEM kan pakketten detecteren die op een specifieke locatie in het lokale bestandssysteem van de hostcomputer zijn geplaatst en deze automatisch uploaden en installeren.
-
Onder de AEM installatiemap bevindt zich een
crx-quicksart
-map naast de map jar enlicense.properties
. Maak een map met de naaminstall
ondercrx-quickstart
. Dit leidt tot het pad<aem-home>/crx-quickstart/install
. -
Voeg in deze map uw pakketten toe. Deze worden automatisch geüpload en geïnstalleerd op uw exemplaar.
-
Nadat het uploaden en installeren is voltooid, kunt u de pakketten in Package Manager zien alsof u de interface van Package Manager hebt gebruikt om ze te installeren.
Als de instantie actief is, worden het uploaden en de installatie onmiddellijk gestart wanneer u het aan het pakket aan de map install
toevoegt
Als de instantie niet wordt uitgevoerd, worden pakketten die in de map install
zijn geplaatst, bij het opstarten in alfabetische volgorde geïnstalleerd.
Pakketten verwijderen uninstalling-packages
Als u het pakket verwijdert, wordt de inhoud van de opslagplaats teruggezet naar de momentopname die vóór de installatie automatisch door Package Manager is gemaakt.
-
Open de pakketdetails van het pakket dat u uit de pakketlijst wilt verwijderen door op de pakketnaam te klikken.
-
Klik Meer > desinstalleert, om de inhoud van dit pakket uit de bewaarplaats te verwijderen.
-
In een dialoogvenster wordt bevestiging gevraagd en worden alle aangebrachte wijzigingen vermeld.
-
Het pakket wordt verwijderd en de momentopname wordt toegepast. De voortgang van het proces wordt weergegeven in het activiteitenlog.
Pakketten verwijderen deleting-packages
Als u een pakket verwijdert, worden alleen de gegevens verwijderd uit Pakketbeheer. Als dit pakket al is geïnstalleerd, wordt de geïnstalleerde inhoud niet verwijderd.
-
Open de pakketdetails van het pakket dat u uit de pakketlijst wilt verwijderen door op de pakketnaam te klikken.
-
Pakketbeheer vraagt om bevestiging dat u het pakket wilt verwijderen. Klik O.K. om de schrapping te bevestigen.
-
De pakketinformatie wordt verwijderd en de details worden vermeld in het activiteitenlog.
Pakketten repliceren replicating-packages
Kopieer de inhoud van een pakket en installeer het op de publicatie-instantie.
-
Open de pakketdetails van het pakket dat u wilt repliceren uit de pakketlijst door op de pakketnaam te klikken.
-
Klik Meer > Herhalen.
-
Het pakket wordt gerepliceerd en de details worden gerapporteerd in het activiteitenlog.
Softwaredistributie software-distribution
AEM Pakketten kunnen worden gebruikt om inhoud te creëren en te delen over AEM milieu's.
de Distributie van de Softwareis de gecentraliseerde dienst die wordt ontworpen om het onderzoek en de download van AEM pakketten te vereenvoudigen.
Voor meer informatie, zie de documentatie van de Distributie van de Software.