Adobe Content Package Maven Plugin

Använd pluginen Adobe Content Package Maven för att integrera paketets driftsättnings- och hanteringsuppgifter i dina Maven-projekt.

Distributionen av de konstruerade paketen till AEM utförs av pluginmodulen för innehållspaketet för Adobe och möjliggör automatisering av uppgifter som normalt utförs med AEM Pakethanteraren:

• Skapa nya paket från filer i filsystemet.
• Installera och avinstallera paket på AEM.
• Bygg paket som redan har definierats på AEM.
• Hämta en lista med paket som är installerade på AEM.
• Ta bort ett paket från AEM.

I det här dokumentet beskrivs hur du använder Maven för att hantera dessa uppgifter. Men det är också viktigt att förstå hur AEM projekt och deras paket är strukturerade.

Paket och AEM projektstruktur

AEM as a Cloud Service följer de senaste metoderna för pakethantering och projektstruktur som implementerats av den senaste AEM Project Archetype.

Hämta innehållspaketet Maven Plugin

Plugin-programmet finns på Maven Central Repository.

Innehållspaket Maven Plugin - mål och parametrar

Om du vill använda plugin-programmet Content Package Maven lägger du till följande plugin-element i build-elementet i din POM-fil:

<plugin>
 <groupId>com.day.jcr.vault</groupId>
 <artifactId>content-package-maven-plugin</artifactId>
 <version>1.0.4</version>
 <configuration>
       <!-- parameters and values common to all goals, as required -->
 </configuration>
</plugin>

Om du vill att Maven ska kunna hämta plugin-programmet använder du profilen i Hämta innehållspaketet Maven Plugin på den här sidan.

Mål för Innehållspaketet Maven Plugin

Mål- och målparametrarna som finns i innehållspaketets plugin-program beskrivs i följande avsnitt. Parametrar som beskrivs i avsnittet Vanliga parametrar kan användas för de flesta målen. Parametrar som gäller för ett mål beskrivs i avsnittet för det målet.

Plugin-prefix

Plugin-prefixet är content-package. Använd det här prefixet för att köra ett mål från kommandoraden, som i följande exempel:

mvn content-package:build

Parameterprefix

Om inget annat anges använder målen och parametrarna vault -prefix, som i följande exempel:

mvn content-package:install -Dvault.targetURL="https://192.168.1.100:4502/crx/packmgr/service.jsp"

Proxies

Mål där proxies används för AEM använder den första giltiga proxykonfigurationen som finns i inställningarna för Maven. Om ingen proxykonfiguration hittas används ingen proxy. Se useProxy -parametern i Gemensamma parametrar -avsnitt.

Gemensamma parametrar

Parametrarna i följande tabell är gemensamma för alla mål utom när de anges i Mål kolumn.

bygga

Skapar ett innehållspaket som redan har definierats på en AEM.

Parametrar

Alla parametrar för byggmålet beskrivs i Gemensamma parametrar -avsnitt.

installera

Installerar ett paket i databasen. För att detta mål ska kunna uppnås krävs inget Maven-projekt. Målet är bundet till install Maven byggs livscykel.

Parametrar

Förutom följande parametrar finns beskrivningarna i Gemensamma parametrar -avsnitt.

ls

Visar de paket som distribuerats till Pakethanteraren.

Parametrar

Alla parametrar för ls-målet beskrivs i Gemensamma parametrar -avsnitt.

rm

Tar bort ett paket från Pakethanteraren.

Parametrar

Alla parametrar för RM-målet beskrivs i Gemensamma parametrar -avsnitt.

avinstallera

Avinstallerar ett paket. Paketet finns kvar på servern i avinstallerat läge.

Parametrar

Alla parametrar för avinstallationsmålet beskrivs i Gemensamma parametrar -avsnitt.

package

Skapar ett innehållspaket. Standardkonfigurationen för paketmålet omfattar innehållet i katalogen där kompilerade filer sparas. Körningen av paketmålet kräver att kompileringsfasen har slutförts. Paketmålet är bundet till paketfasen av bygglivscykeln för Maven.

Parametrar

Förutom följande parametrar finns mer information i beskrivningen av name -parametern i Gemensamma parametrar -avsnitt.

Använda filter

Använd elementet filters för att definiera paketinnehållet. Filtren läggs till i workspaceFilter -elementet i META-INF/vault/filter.xml paketets fil.

I följande filterexempel visas XML-strukturen som ska användas:

<filter>
   <root>/apps/myapp</root>
   <mode>merge</mode>
       <includes>
              <include>/apps/myapp/install/</include>
              <include>/apps/myapp/components</include>
       </includes>
       <excludes>
              <exclude>/apps/myapp/config/*</exclude>
       </excludes>
</filter>

Importläge

The mode -elementet definierar hur innehåll i databasen påverkas när paketet importeras. Följande värden kan användas:

• Sammanfoga: Innehåll i paketet som inte redan finns i databasen läggs till. Innehåll som finns både i paketet och i databasen ändras inte. Inget innehåll tas bort från databasen.
• Ersätt: Innehåll i paketet som inte finns i databasen läggs till i databasen. Innehåll i databasen ersätts med matchande innehåll i paketet. Innehåll tas bort från databasen när den inte finns i paketet.
• Uppdatering: Innehåll i paketet som inte finns i databasen läggs till i databasen. Innehåll i databasen ersätts med matchande innehåll i paketet. Befintligt innehåll tas bort från databasen.

När filtret inte innehåller mode element, standardvärdet för replace används.

help

Parametrar

Inkludera en miniatyrbild eller egenskapsfil i paketet

Ersätt standardpaketkonfigurationsfilerna för att anpassa paketegenskaperna. Ta till exempel med en miniatyrbild för att skilja på paketet i Pakethanteraren.

Källfilerna kan finnas var som helst i filsystemet. I POM-filen definierar du byggresurser som kopierar källfilerna till target/vault-work/META-INF för införande i förpackningen.

Följande POM-kod lägger till filerna i META-INF projektkällans mapp till paketet:

<build>
    <resources>
        <!-- vault META-INF resources (thumbnail etc.) -->
        <resource>
            <directory>${basedir}/src/main/content/META-INF</directory>
            <targetPath>../vault-work/META-INF</targetPath>
        </resource>
    </resources>
</build>

Följande POM-kod lägger bara till en miniatyrbild i paketet. Miniatyrbilden måste ha ett namn thumbnail.pngoch måste finnas i META-INF/vault/definition paketets mapp. I det här exemplet finns källfilen i /src/main/content/META-INF/vault/definition projektmapp:

<build>
    <resources>
        <!-- thumbnail only -->
        <resource>
            <directory>${basedir}/src/main/content/META-INF/vault/definition</directory>
            <targetPath>../vault-work/META-INF/vault/definition</targetPath>
        </resource>
    </resources>
</build>

Använda den AEM projekttypen för att generera AEM projekt

Den senaste AEM Project Archetype implementerar paketstrukturen med bästa praxis för både lokala implementeringar och AMS-implementeringar och rekommenderas för alla AEM projekt.

Resurser för Business.Adobe.com