Plug-in Maven Content Package d’Adobe

Le plug-in Maven Content Package d’Adobe permet d’intégrer les tâches de déploiement et de gestion de modules dans vos projets Maven.

Le déploiement des modules construits sur AEM est effectué par le plug-in Maven Content Package d’Adobe et permet l’automatisation des tâches normalement exécutées à l’aide du Gestionnaire de modules d’AEM :

• Création de modules à partir des fichiers du système de fichiers.
• Installation et désinstallation de modules sur AEM.
• Création de modules déjà définis sur AEM.
• Obtention de la liste des modules installés sur AEM.
• Suppression d’un module d’AEM.

Ce document décrit comment utiliser Maven pour gérer ces tâches. Cependant, il est également important de comprendre comment les projets AEM et leurs modules sont structurés.

Modules et structure de projet AEM

AEM as a Cloud Service adhère aux bonnes pratiques les plus récentes en matière de gestion de modules et de structure de projet, telles qu’elles sont implémentées par le dernier archétype de projet AEM.

Obtention du plug-in Maven Content Package

Le plug-in est disponible à partir du référentiel Maven central.

Objectifs et paramètres du plug-in Maven Content Package

Pour utiliser le module externe Content Package Maven, ajoutez l’élément plugin suivant dans l’élément build du fichier POM :

<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>

Pour que Maven puisse télécharger le module externe, utilisez le profil fourni dans la section Obtention du module externe Content Package Maven de cette page.

Version du plug-in Content Package Maven :

Les objectifs et les paramètres d’objectif fournis par le plug-in Content Package sont décrits dans les sections qui suivent. Les paramètres qui sont décrits dans la section Paramètres communs peuvent être utilisés pour la plupart des objectifs. Les paramètres qui s’appliquent à un objectif sont décrits dans la section consacrée à l’objectif en question.

Préfixe du plug-in

Le préfixe du plug-in est content-package. Utilisez ce préfixe pour exécuter un objectif à partir de la ligne de commande, comme illustré ci-après.

mvn content-package:build

Préfixe des paramètres

Sauf indication contraire, les objectifs et les paramètres du plug-in utilisent le préfixe vault, comme illustré ci-après.

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

Proxys

Les objectifs qui utilisent des proxys pour AEM ont recours à la première configuration de proxy valide dans les paramètres Maven. Si aucune configuration de proxy n’est trouvée, aucun proxy n’est utilisé. Reportez-vous au paramètre useProxy dans la section Paramètres communs.

Paramètres communs

Les paramètres contenus dans le tableau ci-après sont communs à tous les objectifs, sauf si une note indique le contraire dans la colonne Objectifs.

build

Crée un module de contenu déjà défini sur une instance AEM.

Paramètres

Tous les paramètres de l’objectif de build sont décrits dans la section Paramètres communs.

install

Installe un module dans le référentiel. L’exécution de cet objectif ne nécessite pas de projet Maven. L’objectif est lié à la phase install du cycle de vie de compilation Maven.

Paramètres

En plus des paramètres suivants, consultez les descriptions de la section Paramètres communs.

ls

Répertorie les modules déployés dans le Gestionnaire de modules.

Paramètres

Tous les paramètres de l’objectif sont décrits dans la section Paramètres communs.

rm

Supprime un module du Gestionnaire de modules.

Paramètres

Tous les paramètres de l’objectif rm sont décrits dans la section Paramètres communs.

uninstall

Désinstalle un module. Le module reste sur le serveur avec l’état désinstallé.

Paramètres

Tous les paramètres de l’objectif uninstall sont décrits dans la section Paramètres communs.

package

Crée un module de contenu. La configuration par défaut de l’objectif du module comprend le contenu du répertoire dans lequel les fichiers compilés sont enregistrés. L’exécution de l’objectif du module requiert que la phase de création de la compilation soit terminée. L’objectif est lié à la phase de module du cycle de vie de compilation Maven.

Paramètres

Outre les paramètres suivants, consultez la description du paramètre name dans la section Paramètres communs.

Utilisation de l’élément filters

Utilisez l’élément filters pour définir le contenu du module. Les filtres sont ajoutés à l’élément workspaceFilter du fichier META-INF/vault/filter.xml du module.

L’exemple de filtre suivant montre la structure XML à utiliser :

<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>

Mode d’importation

L’élément mode définit l’impact de l’importation du module sur le contenu du référentiel. Les valeurs suivantes peuvent être utilisées :

• Fusionner : le contenu du module ne se trouvant pas encore dans le référentiel est ajouté. Le contenu se trouvant dans le module et le référentiel reste inchangé. Aucun contenu n’est supprimé du référentiel.
• Remplacer : le contenu du module absent du référentiel y est ajouté. Le contenu du référentiel est remplacé par le contenu correspondant du module. Le contenu est supprimé du référentiel lorsqu’il n’existe pas dans le module.
• Mettre à jour : le contenu du module ne se trouvant pas dans le référentiel y est ajouté. Le contenu du référentiel est remplacé par le contenu correspondant du module. Le contenu existant est supprimé du référentiel.

Lorsque le filtre ne contient pas d’élément mode, la valeur replace par défaut est utilisée.

help

Paramètres

Inclusion d’une image de miniature ou d’un fichier de propriétés dans le module

Remplacez les fichiers de configuration du module par défaut afin de personnaliser les propriétés du module. Incluez, par exemple, une image miniature pour différencier le module dans le Gestionnaire de modules.

Les fichiers sources peuvent se trouver n’importe où dans le système de fichiers. Dans le fichier POM, définissez les ressources de création pour copier les fichiers sources dans target/vault-work/META-INF à des fins d’inclusion dans le module.

Le code POM suivant ajoute au module les fichiers du dossier META-INF de la source du projet :

<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>

Le code POM ci-après ajoute uniquement une image miniature au module. L’image miniature doit être appelée thumbnail.png et figurer dans le dossier META-INF/vault/definition du module. Dans cet exemple, le fichier source se trouve dans le dossier /src/main/content/META-INF/vault/definition du projet :

<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>

Utilisation de l’archétype de projet AEM pour générer des projets AEM

Le dernier archétype de projet AEM met en œuvre la structure d’ensemble des bonnes pratiques pour les implémentations On-Premise et AMS et est recommandé pour tous les projets AEM.

Ressources Business.Adobe.com