Pakketbeheer
- Onderwerpen:
- Beheren
- Ontwikkelen
Gemaakt voor:
- Beheerder
Pakketten maken het importeren en exporteren van inhoud in de opslagplaats mogelijk. U kunt pakketten gebruiken om nieuwe inhoud te installeren, inhoud tussen instanties over te brengen, en file bewaarplaats inhoud.
Met Package Manager kunt u pakketten overbrengen tussen uw AEM en uw lokale bestandssysteem voor ontwikkelingsdoeleinden.
Wat zijn pakketten?
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.
NOTEPakketten in AEM as a Cloud Service
Inhoudspakketten die voor AEM as a Cloud Service-toepassingen worden gemaakt, moeten een duidelijke scheiding hebben tussen onveranderbare en muteerbare inhoud. Daarom kan de Manager van het Pakket slechts worden gebruikt om pakketten te beheren die inhoud bevatten. Alle code moet worden geïmplementeerd via Cloud Manager.
NOTE/apps wordt opgeslagen) moet worden opgesteld gebruikend uw pijpleiding CI/CD in Cloud Manager.
IMPORTANTVoor meer details op hoe te om pakketten voor AEMaaCS te beheren, zie het Opstellen aan AEM as a Cloud Servicein het opstellen van gebruikersgids.
Pakketgrootte
Adobe raadt u aan geen grote pakketten te maken. Zo voorkomt u time-outproblemen bij het uploaden en downloaden van pakketten.
In het algemeen moet een pakket in zijn geheel binnen 60 seconden worden verzonden. Dit verstrekt de volgende formule als gids.
MaxPackageSize (in MB) = ConnectionSpeed (in MB/s) * 60 s
Aangezien het netwerkverkeer variabel is en altijd kleiner is dan de geadverteerde maximale theoretische waarde, kunt u proberen een online testtool voor de snelheid van internetverbinding te gebruiken.
Internetsnelheden zijn bijna altijd verschillend voor uploads en downloads. Ervan uitgaande dat u pakketten moet uploaden en downloaden, moet u de lagere waarde (gewoonlijk uploadsnelheid) gebruiken in uw berekening.
Voorbeeld
Gebruikend een hulpmiddel van de de snelheidstest van Internet, zie ik dat mijn huidige uploadsnelheid ongeveer 100 Mbps is.
100 Mbps = 12.5 MB/s
12.5 MB/s * 60 s = 750 MB
Alle pakketten die ik maak, moeten dus kleiner zijn dan 750 MB.
NOTEPakketbeheer
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
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
CAUTIONPakketbeheer openen
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
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
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
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
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.
Pakketfilters
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 pakketcreeert. U kunt ze echter ook later bewerken, waarna het pakket opnieuw moet worden samengesteld om de inhoud bij te werken op basis van de nieuwe filterdefinities.
TIPTIPAfhankelijkheden
AEMaaCSgroupId:name:versiongroupId:name:versionGeavanceerde instellingen
WKND Media Grouphttps://wknd.sitehttps://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
U kunt meerdere schermafbeeldingen aan het pakket toevoegen om een visuele weergave van de weergave van de inhoud te bieden.
Pakkethandelingen
Er zijn vele acties die op een pakket kunnen worden ondernomen.
Een pakket maken
-
Klik Create Pakket.
TIPAls 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 pakketinhoudte 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.
TIPEen pakket maken
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, omdat 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.
TIPEen pakket bewerken
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
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
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
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
-
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.
TIPPakketten uploaden vanuit uw bestandssysteem
-
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.
TIPPakketten valideren
Omdat pakketten bestaande inhoud kunnen wijzigen, is het vaak handig om deze wijzigingen te valideren voordat u ze installeert.
Validatieopties
Pakketbeheer kan de volgende validaties uitvoeren:
OSGi-pakketinvoer valideren
NOTEwat 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
NOTEwat 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 gemeld
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.
NOTEACLs bevestigen
wat wordt gecontroleerd
Deze validatie controleert welke machtigingen worden toegevoegd, hoe deze worden verwerkt (samenvoegen/vervangen) en of de huidige machtigingen 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 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.
CAUTIONValidatie uitvoeren
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
-
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
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:
osgiPackageImportsoverlaysacls
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
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
Wanneer u een pakket uploadt, wordt alleen de pakketinhoud aan de opslagplaats toegevoegd, maar deze is niet toegankelijk. U moet het geüploade pakket installeren om de inhoud van het pakket te kunnen gebruiken.
CAUTIONVoordat u het pakket installeert, maakt Package Manager automatisch een pakket met momentopnamen dat de overschreven inhoud bevat. Deze momentopname wordt opnieuw geïnstalleerd als u uw pakket verwijdert.
-
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
Het opnieuw installeren van pakketten voert de zelfde stappen op een reeds geïnstalleerd pakket uit dat wanneer eerst het pakketinstalleert.
Uploaden en installeren op basis van bestandssysteem
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 naaminstallondercrx-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
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
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.
-
AEM vraagt om bevestiging dat u het pakket wilt schrappen. Klik O.K. om de schrapping te bevestigen.
-
De pakketinformatie wordt verwijderd en de details worden vermeld in het activiteitenlog.
Pakketten repliceren
Kopieer de inhoud van een pakket en installeer het op de publicatie-instantie.
-
Open de pakketdetails van het pakket u van de pakketlijst wilt herhalen door de pakketnaam te klikken.
-
Klik Meer > Herhalen.
-
Het pakket wordt gerepliceerd en de details worden gerapporteerd in het activiteitenlog.
Softwaredistributie
AEM pakketten kunnen worden gebruikt om inhoud te maken en te delen in AEMaaCS-omgevingen.
de Distributie van de Softwareverstrekt AEM pakketten voor gebruik op de lokale ontwikkeling AEM SDK. AEM pakketten die op softwaredistributie worden geleverd, mogen niet worden geïnstalleerd in AEMaaCS-cloudomgevingen, tenzij dit uitdrukkelijk wordt goedgekeurd door ondersteuning voor Adoben.
Voor meer informatie, zie de documentatie van de Distributie van de Software.