Plug-in Adobe Content Package Maven

Use o plug-in Adobe Content Package Maven para integrar tarefas de implantação e gerenciamento de pacotes aos seus projetos Maven.

A implantação dos pacotes construídos no AEM é realizada pelo plug-in Adobe Content Package Maven e permite a automação de tarefas normalmente executadas usando AEM Gerenciador de pacotes:

• Crie novos pacotes a partir de arquivos no sistema de arquivos.
• Instale e desinstale pacotes no AEM.
• Crie pacotes que já estão definidos no AEM.
• Obtenha uma lista de pacotes instalados no AEM.
• Remova um pacote do AEM.

Este documento detalha como usar o Maven para gerenciar essas tarefas. No entanto, também é importante compreender a forma como AEM projetos e respectivos pacotes são estruturados.

Pacotes e a estrutura AEM do projeto

AEM as a Cloud Service segue as práticas recomendadas mais recentes para o gerenciamento de pacotes e a estrutura do projeto, conforme implementado pelo Arquétipo de projeto AEM mais recente.

Obter o plug-in Content Package Maven

O plug-in está disponível no Repositório Central Maven.

Metas e parâmetros do plug-in do Maven para pacote de conteúdo

Para usar o plug-in Content Package Maven , adicione o seguinte elemento de plug-in dentro do elemento build do seu arquivo 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 o Maven baixe o plug-in, use o perfil fornecido no Obter o plug-in Content Package Maven nesta página.

Metas do plug-in do Content Package Maven

As metas e os parâmetros de meta fornecidos pelo plug-in Pacote de conteúdo são descritos nas seções a seguir. Os parâmetros descritos na seção Parâmetros comuns podem ser usados para a maioria das metas. Os parâmetros que se aplicam a uma meta são descritos na seção para essa meta.

Prefixo do plug-in

O prefixo do plug-in é content-package. Use esse prefixo para executar uma meta da linha de comando, como no exemplo a seguir:

mvn content-package:build

Prefixo do parâmetro

Salvo indicação em contrário, as metas e os parâmetros do plug-in usam a variável vault como no exemplo a seguir:

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

Proxies

Metas que usam proxies para AEM usam a primeira configuração de proxy válida encontrada nas configurações de Maven. Se nenhuma configuração de proxy for encontrada, nenhum proxy será usado. Consulte a useProxy no Parâmetros comuns seção.

Parâmetros comuns

Os parâmetros na tabela a seguir são comuns a todas as metas, exceto quando anotados na variável Metas coluna.

build

Cria um pacote de conteúdo que já está definido em uma instância de AEM.

Parâmetros

Todos os parâmetros para a meta de build são descritos na seção Parâmetros comuns seção.

instalar

Instala um pacote no repositório. A execução dessa meta não requer um projeto Maven. A meta é vinculada à variável install fase do ciclo de vida de compilação Maven.

Parâmetros

Além dos parâmetros a seguir, consulte as descrições no Parâmetros comuns seção.

ls

Lista os pacotes implantados em Gerenciador de pacotes.

Parâmetros

Todos os parâmetros da meta de ls são descritos na seção Parâmetros comuns seção.

rm

Remove um pacote de Gerenciador de pacotes.

Parâmetros

Todos os parâmetros da meta de rm são descritos na seção Parâmetros comuns seção.

desinstalar

Desinstala um pacote. O pacote permanece no servidor no estado desinstalado.

Parâmetros

Todos os parâmetros da meta de desinstalação estão descritos na seção Parâmetros comuns seção.

pacote

Cria um pacote de conteúdo. A configuração padrão do objetivo do pacote inclui o conteúdo do diretório em que os arquivos compilados são salvos. A execução da meta do pacote requer que a fase de compilação tenha sido concluída. A meta do pacote é vinculada à fase do pacote do ciclo de vida da compilação Maven.

Parâmetros

Além dos parâmetros a seguir, consulte a descrição do name no Parâmetros comuns seção.

Uso de filtros

Use o elemento filters para definir o conteúdo do pacote. Os filtros são adicionados ao workspaceFilter no META-INF/vault/filter.xml do pacote.

O exemplo de filtro a seguir mostra a estrutura XML a ser usada:

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

Modo de importação

O mode O elemento define como o conteúdo é afetado pelo repositório quando o pacote é importado. Os seguintes valores podem ser usados:

• Mesclar: O conteúdo no pacote que ainda não está no repositório é adicionado. O conteúdo que está no pacote e no repositório não é alterado. Nenhum conteúdo é removido do repositório.
• Substituir: O conteúdo no pacote que não está no repositório é adicionado ao repositório. O conteúdo no repositório é substituído pelo conteúdo correspondente no pacote. O conteúdo é removido do repositório quando não existe no pacote.
• Atualização: O conteúdo no pacote que não está no repositório é adicionado ao repositório. O conteúdo no repositório é substituído pelo conteúdo correspondente no pacote. O conteúdo existente é removido do repositório.

Quando o filtro contiver mode elemento, o valor padrão de replace é usada.

Ajuda com o

Parâmetros

Inclusão de uma imagem em miniatura ou de um arquivo de propriedades no pacote

Substitua os arquivos de configuração padrão do pacote para personalizar as propriedades do pacote. Por exemplo, inclua uma imagem em miniatura para distinguir o pacote em Gerenciador de pacotes.

Os arquivos de origem podem estar localizados em qualquer lugar no seu sistema de arquivos. No arquivo POM, defina os recursos de criação para copiar os arquivos de origem para o target/vault-work/META-INF para inclusão na embalagem.

O seguinte código POM adiciona os arquivos no META-INF pasta da origem do projeto para o pacote:

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

O código POM a seguir adiciona apenas uma imagem em miniatura ao pacote. A imagem em miniatura deve ser nomeada thumbnail.pnge devem estar localizados na variável META-INF/vault/definition pasta do pacote. Neste exemplo, o arquivo de origem está localizado na variável /src/main/content/META-INF/vault/definition pasta do projeto:

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

Usar o Arquétipo de projeto AEM para gerar projetos AEM

O AEM Project Archetype mais recente implementa a estrutura de pacotes de práticas recomendadas para implementações locais e do AMS e é recomendado para todos os projetos AEM.

Recursos de Business.Adobe.com