Pakethanteraren working-with-packages

Med paket kan du importera och exportera databasinnehåll. Du kan använda paket för att installera nytt innehåll, överföra innehåll mellan instanser och säkerhetskopiera databasinnehåll.

Med Package Manager kan du överföra paket mellan AEM och det lokala filsystemet i utvecklingssyfte.

Vad är paket? what-are-packages

Ett paket är en ZIP-fil som innehåller databasinnehåll i ett filsystemsserialiseringsformat, som kallas vaultserialisering, och som ger en lättanvänd och lättredigerad representation av filer och mappar. Innehåll som ingår i paketet definieras med hjälp av filter.

Ett paket innehåller även vaultmetainformation, inklusive filterdefinitioner och importkonfigurationsinformation. Ytterligare innehållsegenskaper, som inte används för paketextrahering, kan inkluderas i paketet, till exempel en beskrivning, en visuell bild eller en ikon. Dessa extra innehållsegenskaper är endast avsedda för innehållspaketkonsumenten och för informationsändamål.

Paket i AEM as a Cloud Service aemaacs-packages

Innehållspaket som skapas för AEM as a Cloud Service-program måste ha en ren separation mellan oföränderligt och muterbart innehåll. Pakethanteraren kan därför bara användas för att hantera paket som innehåller innehåll. All kod måste distribueras via Cloud Manager.

Mer information om hur du hanterar paket för AEMaaCS finns i Distribuera till AEM as a Cloud Service i användarhandboken för distribution.

Paketstorlek package-size

Adobe rekommenderar att du inte skapar stora paket. Detta för att undvika timeoutproblem vid överföring och hämtning av paket.

Som regel bör ett paket skickas i sin helhet inom 60 sekunder. Detta ger följande formel som vägledning.

MaxPackageSize (in MB) = ConnectionSpeed (in MB/s) * 60 s

Eftersom nätverkstrafiken varierar och alltid är mindre än det annonserade maximala teoretiska värdet kan du testa med ett hastighetstest online.

Internet-hastigheter är nästan alltid olika för överföringar och nedladdningar. Om du måste både överföra och hämta paket bör du använda det lägre värdet (vanligen överföringshastigheten) i beräkningen.

Exempel example

Med ett testverktyg för Internet-hastighet ser jag att min nuvarande överföringshastighet är cirka 100 Mbit/s.

100 Mbps = 12.5 MB/s
12.5 MB/s * 60 s = 750 MB

Alla paket jag skapar bör därför vara mindre än 750 MB.

Pakethanteraren package-manager

Pakethanteraren hanterar paketen i AEM. När du har tilldelat de nödvändiga behörigheterna kan du använda Package Manager för olika åtgärder, bland annat för att konfigurera, bygga, hämta och installera dina paket.

Nödvändiga behörigheter required-permissions

För att kunna skapa, ändra, överföra och installera paket måste användarna ha rätt behörighet på följande noder:

Åtkomst till Package Manager accessing

Du kommer åt Package Manager på tre sätt:

Pakethanterarens användargränssnitt ui

Pakethanteraren är uppdelad i fyra huvudsakliga funktionsområden:

Om du klickar på ett alternativ i den vänstra navigeringspanelen filtreras paketlistan omedelbart.

När du klickar på ett paketnamn expanderas posten i paketlistan så att du får mer information om paketet.

Det finns ett antal åtgärder som kan utföras på ett paket via de verktygsfältsknappar som är tillgängliga när paketdetaljen expanderas.

Ytterligare åtgärder är tillgängliga under knappen Mer.

Paketstatus package-status

Varje post i paketlistan har en statusindikator som gör att du snabbt kan se paketets status. När du hovrar över statusen visas verktygstipset med statusinformation.

Om paketet har ändrats eller aldrig byggts visas statusen som en länk för att vidta snabba åtgärder för att återskapa eller installera paketet.

Paketinställningar package-settings

Ett paket är i princip en uppsättning filter och databasdata som baseras på dessa filter. Med hjälp av pakethanterarens gränssnitt kan du klicka på ett paket och sedan på knappen Redigera för att visa information om ett paket, inklusive följande inställningar.

Allmänna inställningar general-settings

Du kan redigera olika paketinställningar för att definiera information som paketbeskrivning, beroenden och providerinformation.

Dialogrutan Paketinställningar är tillgänglig via knappen Redigera när du skapar eller redigerar ett paket. Klicka på Spara när ändringarna har gjorts.

Paketfilter package-filters

Filter identifierar databasnoderna som ska inkluderas i paketet. En filterdefinition anger följande information:

Lägg till regler med knappen +. Ta bort regler med knappen -.

Regler tillämpas i den ordning de har, så att de kan placeras efter behov med pilknapparna Upp och Ned .

Filter kan innehålla noll eller flera regler. När inga regler har definierats innehåller paketet allt innehåll under rotsökvägen.

Du kan definiera en eller flera filterdefinitioner för ett paket. Använd mer än ett filter för att inkludera innehåll från flera rotsökvägar.

När du skapar regler definierar du ett reguljärt uttryck (kallas även regex, regexp eller rationellt uttryck) för att ange alla noder som du vill ta med eller exkludera.

Paketfilter definieras oftast när du först skapar paketet. De kan dock även redigeras senare, och därefter bör paketet byggas om för att uppdatera innehållet baserat på de nya filterdefinitionerna.

Beroenden dependencies

Avancerade inställningar advanced-settings

Paketskärmbilder package-screenshots

Du kan bifoga flera skärmbilder till ditt paket för att få en visuell representation av hur innehållet ser ut.

Paketåtgärder package-actions

Det finns många åtgärder som kan utföras på ett paket.

Skapa ett paket creating-a-new-package

Det är inte obligatoriskt att omedelbart skapa paketet efter att det har skapats. Ett obyggt paket innehåller inget innehåll och består endast av filterdata och andra metadata för paketet.

Skapa ett paket building-a-package

Ett paket byggs ofta samtidigt som du skapar paketet, men du kan gå tillbaka vid ett senare tillfälle för att antingen skapa eller återskapa paketet. Detta kan vara användbart om innehållet i databasen har ändrats eller om paketfiltren har ändrats.

Redigera ett paket edit-package

När ett paket har överförts till AEM kan du ändra dess inställningar.

Du kan behöva återskapa paketet för att uppdatera innehållet baserat på dina ändringar.

Rewrapping a Package rewrapping-a-package

När ett paket har byggts kan det paketeras om. När du gör om en paketering ändras paketinformationen utan miniatyrbild, beskrivning och så vidare, utan att paketinnehållet ändras.

Visa andra paketversioner other-versions

Eftersom alla versioner av ett paket visas i listan som alla andra paket, kan pakethanteraren hitta andra versioner av ett valt paket.

Innehåll och testinstallation för visning av paket viewing-package-contents-and-testing-installation

När du har skapat ett paket kan du visa innehållet.

Hämtar paket till filsystemet downloading-packages-to-your-file-system

Överför paket från filsystemet uploading-packages-from-your-file-system

Paketinnehållet finns nu på AEM, men för att göra innehållet tillgängligt måste du installera paketet.

Verifierar paket validating-packages

Eftersom paket kan ändra befintligt innehåll är det ofta användbart att validera dessa ändringar innan du installerar.

Valideringsalternativ validation-options

Pakethanteraren kan utföra följande valideringar:

Validera OSGi-paketimporter osgi-package-imports

Vad är markerat

Den här valideringen undersöker paketet för alla JAR-filer (OSGi-paket), extraherar deras manifest.xml (som innehåller de versionshanteringsberoenden som OSGi-paketet är beroende av) och verifierar den AEM instansen exporterar dessa beroenden med rätt versioner.

Så här rapporteras det

Alla versionshanteringsberoenden som inte kan uppfyllas av den AEM instansen visas i aktivitetsloggen för Package Manager.

Fellägen

Om beroenden inte uppfylls startar inte OSGi-paketen med dessa beroenden. Detta resulterar i en trasig programdistribution eftersom allt som förlitar sig på det ostartade OSGi-paketet i sin tur inte fungerar som det ska.

Fellösning

För att åtgärda fel på grund av att OSGi-paket inte är nöjda måste beroendeversionen i paketet med otillfredsställande importer justeras.

Validera övertäckningar overlays

Vad är markerat

Valideringen avgör om det paket som installeras innehåller en fil som redan finns i AEM.

Med en befintlig övertäckning på /apps/sling/servlet/errorhandler/404.jsp, till exempel, ett paket som innehåller /libs/sling/servlet/errorhandler/404.jsp, så att den ändrar den befintliga filen på /libs/sling/servlet/errorhandler/404.jsp.

Så här rapporteras det

Alla sådana övertäckningar beskrivs i aktivitetsloggen för Package Manager.

Fellägen

Ett feltillstånd innebär att paketet försöker distribuera en fil som redan är överlagrad, vilket innebär att ändringarna i paketet åsidosätts (och därmed"döljs") av övertäckningen och inte börjar gälla.

Fellösning

För att lösa det här problemet måste den som ansvarar för övertäckningsfilen i /apps granska ändringarna i den överliggande filen i /libs och införliva ändringarna efter behov i övertäckningen ( /apps) och distribuera den överliggande filen på nytt.

Validera åtkomstkontrollistor acls

Vad är markerat

Valideringen kontrollerar vilka behörigheter som läggs till, hur de hanteras (sammanfoga/ersätt) och om de aktuella behörigheterna påverkas.

Så här rapporteras det

Behörigheterna beskrivs i aktivitetsloggen för Package Manager.

Fellägen

Inga explicita fel kan anges. Valideringen anger helt enkelt om nya ACL-behörigheter läggs till eller påverkas av att paketet installeras.

Fellösning

Med hjälp av den information som valideringen ger kan de påverkade noderna granskas i CRXDE och åtkomstkontrollistorna kan justeras i paketet efter behov.

Utför validering performing-validation

Paketvalidering kan göras på två olika sätt:

Validering ska alltid ske efter att paketet har överförts, men innan det installeras.

Paketvalidering via Package Manager via-package-manager

Paketvalidering via HTTP-POST-begäran via-post-request

Begäran om POST har följande format.

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

Parametern type kan vara en kommaavgränsad, osorterad lista som består av:

Värdet för type är som standard osgiPackageImports om det inte skickas explicit.

När du använder cURL kör du en programsats som liknar följande:

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'

Vid validering via POST skickas svaret tillbaka som ett JSON-objekt.

Täckning för visningspaket package-coverage

Paket definieras av sina filter. Du kan låta Pakethanteraren tillämpa filter från ett paket på det befintliga databasinnehållet för att visa vilket innehåll i databasen som omfattas av paketets filterdefinition.

Installerar paket installing-packages

När du överför ett paket läggs bara paketinnehållet till i databasen, men det är inte tillgängligt. Du måste installera det överförda paketet för att kunna använda paketets innehåll.

Innan du installerar paketet skapas ett ögonblicksbildspaket som innehåller det överskrivna innehållet automatiskt i Package Manager. Den här ögonblicksbilden installeras om du avinstallerar paketet.

När installationen är klar och slutförd uppdateras paketlistan och ordet Installed visas i paketstatusen.

Paket installeras om reinstalling-packages

När du installerar om paket utförs samma steg på ett redan installerat paket som bearbetas när paketet installeras.

Filsystembaserad överföring och installation file-system-based-upload-and-installation

Du kan helt och hållet avstå från Package Manager när du installerar paket. AEM kan identifiera paket som har placerats på en viss plats i värddatorns lokala filsystem och överföra och installera dem automatiskt.

Om instansen körs börjar överföringen och installationen omedelbart när du lägger till den i paketet i mappen install

Om instansen inte körs installeras paket som placeras i mappen install vid start i alfabetisk ordning.

Avinstallerar paket uninstalling-packages

När du avinstallerar paketet återställs innehållet i databasen till ögonblicksbilden som gjorts automatiskt av Package Manager före installationen.

Tar bort paket deleting-packages

Om du tar bort ett paket tas endast dess information bort från Pakethanteraren. Om det här paketet redan har installerats tas det installerade innehållet inte bort.

Replikerar paket replicating-packages

Replikera innehållet i ett paket för att installera det på publiceringsinstansen.

Programvarudistribution software-distribution

AEM kan användas för att skapa och dela innehåll i AEMaaCS-miljöer.

Programvarudistribution innehåller AEM paket som kan användas på den lokala utvecklingen AEM SDK. AEM som tillhandahålls vid programvarudistribution får inte installeras i AEMaaCS-molnmiljöer om inte Adobe Support uttryckligen har godkänt detta.

Mer information finns i dokumentationen för programdistribution.