Complemento Maven del paquete de contenido de Adobe adobe-content-package-maven-plugin

Utilice el complemento Maven del paquete de contenido de Adobe para integrar las tareas de implementación y administración de paquetes en sus proyectos Maven.

La implementación de los paquetes construidos en AEM la realiza el complemento Maven del paquete de contenido de Adobe y permite la automatización de las tareas que se realizan normalmente con AEM Administrador de paquetes

Este documento detalla cómo utilizar Maven para administrar estas tareas. Sin embargo, también es importante comprender cómo se estructuran los proyectos de AEM y sus paquetes.

Paquetes y la estructura del proyecto de AEM aem-project-structure

AEM as a Cloud Service se adhiere a las últimas prácticas recomendadas para la administración de paquetes y la estructura de proyectos implementadas por el último tipo de archivo del proyecto de AEM.

Obtención del complemento Maven del paquete de contenido obtaining-the-content-package-maven-plugin

El complemento está disponible en el Repositorio de Maven Central.

Parámetros y objetivos del complemento Maven del paquete de contenido

Para utilizar el complemento Maven del paquete de contenido, agregue el siguiente elemento de complemento dentro del elemento de compilación del archivo 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>

Para permitir que Maven descargue el complemento, use el perfil proporcionado en la sección Obtención del complemento Maven del paquete de contenido de esta página.

Objetivos del complemento Maven del paquete de contenido goals-of-the-content-package-maven-plugin

Los objetivos y parámetros de objetivo que proporciona el complemento Paquete de contenido se describen en las secciones siguientes. Los parámetros que se describen en la sección Parámetros comunes se pueden utilizar para la mayoría de los objetivos. Los parámetros que se aplican a un objetivo se describen en la sección para ese objetivo.

Prefijo de complemento plugin-prefix

El prefijo del complemento es content-package. Utilice este prefijo para ejecutar un objetivo desde la línea de comandos, como en el siguiente ejemplo:

mvn content-package:build

Prefijo de parámetro parameter-prefix

A menos que se indique lo contrario, los parámetros y objetivos del complemento utilizan el prefijo vault, como en el siguiente ejemplo:

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

Proxy proxies

Los objetivos que utilizan proxies para AEM utilizan la primera configuración de proxy válida que se encuentra en la configuración de Maven. Si no se encuentra ninguna configuración proxy, no se utiliza ningún proxy. Vea el parámetro useProxy en la sección Parámetros comunes.

Parámetros comunes common-parameters

Los parámetros de la tabla siguiente son comunes a todas las metas, excepto cuando se indican en la columna Goals.

generar build

Crea un paquete de contenido que ya está definido en una instancia de AEM.

Parámetros parameters

Todos los parámetros del objetivo de compilación se describen en la sección Parámetros comunes.

instalar install

Instala un paquete en el repositorio. La ejecución de esta meta no requiere un proyecto Maven. El objetivo está enlazado a la fase install del ciclo de vida de la compilación de Maven.

Parámetros parameters-1

Además de los siguientes parámetros, consulte las descripciones en la sección Parámetros comunes.

ls ls

Enumera los paquetes implementados en Administrador de paquetes.

Parámetros parameters-2

Todos los parámetros del objetivo ls se describen en la sección Parámetros comunes.

rm rm

Quita un paquete de Administrador de paquetes.

Parámetros parameters-3

Todos los parámetros del objetivo rm se describen en la sección Parámetros comunes.

desinstalar uninstall

Desinstala un paquete. El paquete permanece en el servidor en estado desinstalado.

Parámetros parameters-4

Todos los parámetros del objetivo de desinstalación se describen en la sección Parámetros comunes.

help help

Parámetros parameters-6

Inclusión de una imagen en miniatura o un archivo de propiedades en el paquete including-a-thumbnail-image-or-properties-file-in-the-package

Reemplace los archivos de configuración predeterminados del paquete para personalizar las propiedades del paquete. Por ejemplo, incluya una imagen en miniatura para distinguir el paquete en Administrador de paquetes.

Los archivos de origen se pueden encontrar en cualquier lugar del sistema de archivos. En el archivo POM, defina los recursos de compilación para copiar los archivos de origen en target/vault-work/META-INF para incluirlos en el paquete.

El siguiente código POM agrega los archivos de la carpeta META-INF del origen del proyecto al paquete:

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

El siguiente código POM agrega solo una imagen en miniatura al paquete. La imagen en miniatura debe llamarse thumbnail.png y debe encontrarse en la carpeta META-INF/vault/definition del paquete. En este ejemplo, el archivo de origen se encuentra en la carpeta /src/main/content/META-INF/vault/definition del proyecto:

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

Uso del tipo de archivo del proyecto AEM para generar proyectos AEM using-archetypes

El último tipo de archivo del proyecto de AEM implementa la estructura de paquetes de prácticas recomendadas para implementaciones locales y de AMS, y se recomienda para todos los proyectos de AEM.