Gerenciador de pacotes

Os pacotes permitem a importação e exportação de conteúdo do repositório. Você pode usar pacotes para instalar novo conteúdo, transferir conteúdo entre instâncias e fazer backup do conteúdo do repositório.

Com o Gerenciador de pacotes, você pode transferir pacotes entre a instância do AEM e o sistema de arquivos local para fins de desenvolvimento.

O que são pacotes?

Um pacote é um arquivo zip com conteúdo de repositório no formulário de serialização do sistema de arquivos, chamado serialização de cofre, fornecendo uma representação fácil de usar e de fácil edição de arquivos e pastas. O conteúdo incluído no pacote é definido usando filtros.

Um pacote também contém informações de metadados de cofre, incluindo as definições de filtro e informações de configuração de importação. Propriedades de conteúdo adicionais, que não são usadas para extração de pacote, podem ser incluídas no pacote, como uma descrição, uma imagem visual ou um ícone. Essas propriedades de conteúdo adicionais são para o consumidor do pacote de conteúdo e somente para fins informativos.

Pacotes em AEM as a Cloud Service

Os pacotes de conteúdo criados para AEM aplicativos as a Cloud Service devem ter uma separação limpa entre conteúdo imutável e mutável. Portanto, o Gerenciador de pacotes só pode ser usado para gerenciar pacotes que contêm conteúdo. Qualquer código deve ser implantado por meio do Cloud Manager.

Para obter mais detalhes sobre como gerenciar pacotes para o AEMaaCS, consulte o documento Implantação para AEM as a Cloud Service no guia do usuário de implantação.

Gerenciador de pacotes

O Gerenciador de Pacotes gerencia os pacotes na instalação do AEM. Depois de atribuiu as permissões necessárias você pode usar o Gerenciador de pacotes para várias ações, incluindo configuração, criação, download e instalação dos seus pacotes.

Permissões necessárias

Para criar, modificar, carregar e instalar pacotes, os usuários devem ter as permissões apropriadas nos seguintes nós:

• Direitos completos excluindo exclusão em /etc/packages
• O nó que contém o conteúdo do pacote

Acessar o Gerenciador de Pacotes

Você pode acessar o Gerenciador de pacotes de três maneiras:

1. No menu principal AEM -> Ferramentas -> Implantação -> Pacotes
2. De CRXDE Lite usando a barra do alternador superior
3. Diretamente acessando http://<host>:<port>/crx/packmgr/

Interface do usuário do Gerenciador de pacotes

O Gerenciador de pacotes é dividido em quatro áreas funcionais principais:

• Painel Navegação Esquerdo - Esse painel permite filtrar e classificar a lista de pacotes.
• Lista de pacotes - Esta é a lista de pacotes na sua instância filtrados e classificados por seleções no Painel de Navegação Esquerdo.
• Log de atividades - Esse painel é minimizado no início e é expandido para detalhar a atividade do Gerenciador de pacotes, como quando um pacote é criado ou instalado. Há botões adicionais na guia Log de atividades para:
  • Limpar registro
  • Exibir / Ocultar
• Barra de ferramentas - A barra de ferramentas contém botões de atualização para o Painel de navegação esquerdo e a lista Pacote, bem como botões para pesquisar, criar e carregar pacotes.

Clicar em uma opção no Painel de navegação esquerdo filtra imediatamente a Lista de pacotes.

Clicar em um nome de pacote expande a entrada na Lista de pacotes para mostrar mais detalhes sobre o pacote.

Há várias ações que podem ser executadas em um pacote por meio dos botões da barra de ferramentas disponíveis quando os detalhes do pacote são expandidos.

• Editar
• Criar
• Reinstalar
• Download

Outras ações estão disponíveis abaixo da variável Mais botão.

• Excluir
• Cobertura
• Conteúdo
• Reajustar
• Outras versões
• Desinstalar
• Testar instalação
• Validar
• Replicar

Status do pacote

Cada entrada na lista de pacotes tem um indicador de status para que você saiba rapidamente o status do pacote. Passar o mouse sobre o status revela uma dica de ferramenta com os detalhes do status.

Se o pacote tiver sido alterado ou não tiver sido criado, o status será apresentado como um link para tomar uma ação rápida para reconstruir ou instalar o pacote.

Configurações do pacote

Um pacote é essencialmente um conjunto de filtros e os dados do repositório com base nesses filtros. Usando a interface do usuário do Gerenciador de pacotes, você pode clicar em um pacote e, em seguida, na função Editar para visualizar os detalhes de um pacote, incluindo as configurações a seguir.

• Configurações gerais
• Filtros do pacote
• Dependências do pacote
• Configurações avançadas
• Capturas de tela do pacote

Configurações gerais

É possível editar várias configurações de pacote para definir informações, como descrição do pacote, dependências e detalhes do provedor.

O Configurações do pacote está disponível por meio do Editar botão quando criação ou edição um pacote. Depois de fazer qualquer alteração, clique em Salvar.

Filtros do pacote

Os filtros identificam os nós do repositório a serem incluídos no pacote. A Definição de filtro especifica as seguintes informações:

• O Caminho raiz do conteúdo a ser incluído
• Regras que incluem ou excluem nós específicos abaixo do caminho raiz

Adicionar regras usando o + botão. Remova regras usando o - botão.

As regras são aplicadas de acordo com sua ordem, de forma que sejam posicionadas conforme necessário usando a variável Up e Down botões de seta.

Os filtros podem incluir zero ou mais regras. Quando nenhuma regra é definida, o pacote contém todo o conteúdo abaixo do caminho raiz.

É possível definir uma ou mais definições de filtro para um pacote. Use mais de um filtro para incluir conteúdo de vários caminhos raiz.

Ao criar filtros, você pode definir um caminho ou usar uma expressão regular para especificar todos os nós que deseja incluir ou excluir.

Os filtros de pacote são definidos com mais frequência ao crie o pacote. No entanto, eles também podem ser editados posteriormente, depois disso, o pacote deve ser recriado para atualizar seu conteúdo com base nas novas definições de filtro.

Dependências

Configurações avançadas

Capturas de tela do pacote

Você pode anexar várias capturas de tela ao seu pacote para fornecer uma representação visual de como o conteúdo é exibido.

Ações do pacote

Há muitas ações que podem ser realizadas em um pacote.

Criação de um pacote

1. Acesse o Gerenciador de Pacotes.

2. Clique em Criar pacote.

   DICA

   Se a instância tiver muitos pacotes, pode haver uma estrutura de pastas em vigor. Nesses casos, é mais fácil navegar para a pasta de destino necessária antes de criar o novo pacote.

3. No Novo pacote digite os seguintes campos:

   

   • Nome do pacote - Selecione um nome descritivo para ajudá-lo (e outros) a identificar facilmente o conteúdo do pacote.

   • Versão - Este é um campo textual para que você indique uma versão. Isso é anexado ao nome do pacote para formar o nome do arquivo zip.

   • Grupo - Este é o nome do grupo de destino (ou pasta). Os grupos ajudam a organizar seus pacotes. Uma pasta é criada para o grupo se ele ainda não existir. Se deixar o nome do grupo em branco, ele criará o pacote na lista de pacotes principais.

4. Clique em OK para criar o pacote.

5. AEM lista o novo pacote na parte superior da lista de pacotes.

   

6. Clique em Editar para definir a variável conteúdo do pacote. Clique em Salvar depois que terminar de editar as configurações.

7. Agora você pode Criar seu pacote.

Não é obrigatório construir imediatamente o pacote após a sua criação. Um pacote não criado não contém conteúdo e consiste apenas nos dados de filtro e outros metadados do pacote.

Criação de um pacote

Geralmente, um pacote é criado ao mesmo tempo que você criar o pacote, mas você pode retornar posteriormente para criar ou recriar o pacote. Isso pode ser útil se o conteúdo no repositório tiver sido alterado ou se os filtros do pacote tiverem sido alterados.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Clique em Criar. Uma caixa de diálogo solicita a confirmação de que você deseja criar o pacote, pois qualquer conteúdo existente do pacote será substituído.

4. Clique em OK. AEM cria o pacote, listando todo o conteúdo adicionado ao pacote da mesma forma que faz na lista de atividades. Ao concluir o AEM, você exibe uma confirmação de que o pacote foi criado e (ao fechar a caixa de diálogo) atualiza as informações da lista de pacotes.

Editar um pacote

Depois que um pacote é carregado para o AEM, você pode modificar suas configurações.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Clique em Editar e atualize o Configurações do pacote conforme necessário.

4. Clique em Salvar para salvar.

Pode ser necessário recrie o pacote para atualizar seu conteúdo com base nas alterações feitas.

Reembrulhar um pacote

Depois que um pacote é criado, ele pode ser reembutido. Rewrapping altera as informações do pacote sem precisar, como miniatura, descrição etc., sem alterar o conteúdo do pacote.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Clique em Editar e atualize o Configurações do pacote conforme necessário.

4. Clique em Salvar para salvar.

5. Clique em Mais -> Reembrulhar e uma caixa de diálogo pedirá confirmação.

Exibição de outras versões de pacote

Como cada versão de um pacote é exibida na lista como qualquer outro pacote, o Gerenciador de pacotes pode encontrar outras versões de um pacote selecionado.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Clique em Mais -> Outras versões e uma caixa de diálogo é aberta com uma lista de outras versões do mesmo pacote com informações de status.

Visualização do conteúdo do pacote e teste da instalação

Após a criação de um pacote, é possível visualizar o conteúdo.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Para exibir o conteúdo, clique em Mais -> Conteúdo e o Gerenciador de pacotes lista todo o conteúdo do pacote no log de atividades.

   

4. Para executar uma simulação de instalação, clique em Mais -> Instalar teste O e o Gerenciador de pacotes informam no registro de atividades os resultados como se a instalação tivesse sido executada.

   

Fazendo download de pacotes no seu sistema de arquivos

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Clique no botão Baixar ou o nome do arquivo vinculado do pacote na área de detalhes do pacote.

4. AEM baixa o pacote no computador.

Fazer upload de pacotes do seu sistema de arquivos

1. Acesse o Gerenciador de Pacotes.

2. Selecione a pasta do grupo na qual deseja que o pacote seja carregado.

3. Clique no botão Fazer upload do pacote botão.

4. Forneça as informações necessárias sobre o pacote carregado.

   

   • Embalagem - Use o Procurar… para selecionar o pacote necessário do sistema de arquivos local.
   • Forçar upload - Se um pacote com esse nome já existir, essa opção força o upload e substitui o pacote existente.

5. Clique em OK e o pacote selecionado é carregado e a lista de pacotes é atualizada adequadamente.

O conteúdo do pacote agora existe em AEM, mas para torná-lo disponível para uso, certifique-se de instale o pacote.

Validação de pacotes

Como os pacotes podem modificar o conteúdo existente, geralmente é útil validar essas alterações antes de instalar.

Opções de validação

O Gerenciador de pacotes pode executar as seguintes validações:

• Importações de pacotes OSGi
• Sobreposições
• ACLs

Validar importações do pacote OSGi

O que está marcado

Essa validação inspeciona o pacote de todos os arquivos JAR (pacotes OSGi), extrai seus manifest.xml (que contém as dependências com versão em que o pacote OSGi depende) e verifica as exportações da instância AEM feitas dependências com as versões corretas.

Como é reportado

Todas as dependências com versão que não possam ser atendidas pela instância de AEM são listadas no Log de atividades do Gerenciador de pacotes.

Estados de erro

Se as dependências não forem atendidas, os pacotes OSGi no pacote com essas dependências não serão iniciados. Isso resulta em uma implantação de aplicativo interrompida, pois qualquer coisa que dependa do pacote OSGi não iniciado, por sua vez, não funcionará corretamente.

Resolução de Erro

Para resolver erros devido a pacotes OSGi insatisfeitos, a versão de dependência no pacote com importações insatisfeitas deve ser ajustada.

Validar sobreposições

O que está marcado

Essa validação determina se o pacote que está sendo instalado contém um arquivo que já está sobreposto na instância de destino AEM.

Por exemplo, considerando uma sobreposição existente em /apps/sling/servlet/errorhandler/404.jsp, um pacote que contém /libs/sling/servlet/errorhandler/404.jsp, de forma que altere o arquivo existente em /libs/sling/servlet/errorhandler/404.jsp.

Como é reportado

Essas sobreposições são descritas no Log de atividades do Gerenciador de pacotes.

Estados de erro

Um estado de erro significa que o pacote está tentando implantar um arquivo que já está sobreposto, portanto, as alterações no pacote serão sobrepostas (e, portanto, "ocultas") pela sobreposição e não terão efeito.

Resolução de Erro

Para resolver esse problema, o mantenedor do arquivo de sobreposição em /apps deve revisar as alterações no arquivo sobreposto em /libs e incorpore as alterações conforme necessário na sobreposição ( /apps) e reimplante o arquivo sobreposto.

Validar ACLs

O que está marcado

Essa validação verifica quais permissões estão sendo adicionadas, como serão tratadas (mesclar/substituir) e se as permissões atuais serão afetadas.

Como é reportado

As permissões são descritas no Log de atividades do Gerenciador de pacotes.

Estados de erro

Não é possível fornecer erros explícitos. A validação simplesmente indica se qualquer nova permissão ACL será adicionada ou afetada pela instalação do pacote.

Resolução de Erro

Usando as informações fornecidas pela validação, os nós afetados podem ser revisados no CRXDE e as ACLs podem estar ajustando no pacote conforme necessário.

Executando validação

A validação dos pacotes pode ser feita de duas maneiras diferentes:

• Por meio da interface do usuário do Gerenciador de pacotes
• Por meio de solicitação HTTP POST, como com cURL

A validação deve sempre ocorrer após o upload do pacote, mas antes da instalação.

Validação de Pacote Via Gerenciador de Pacotes

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Para validar o pacote, clique em Mais -> Validar,

4. Na caixa de diálogo modal que aparece, use as caixas de seleção para selecionar os tipos de validação e iniciar a validação clicando em Validar.

5. As validações escolhidas são executadas e os resultados são exibidos no Log de atividades do Gerenciador de pacotes.

Validação de pacote por solicitação POST HTTP

A solicitação POST assume o seguinte formulário.

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

O type pode ser qualquer lista desordenada, separada por vírgulas, consistindo em:

• osgiPackageImports
• overlays
• acls

O valor de type o padrão é osgiPackageImports se não tiver sido transmitido explicitamente.

Ao usar cURL, execute uma instrução semelhante ao seguinte:

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'

Ao validar por meio da solicitação POST, a resposta é enviada de volta como um objeto JSON.

Visualização da cobertura do pacote

Os pacotes são definidos por seus filtros. Você pode fazer com que o Gerenciador de pacotes aplique filtros de um pacote ao seu conteúdo de repositório existente para mostrar qual conteúdo do repositório é coberto pela definição de filtro do pacote.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote na lista de pacotes clicando no nome do pacote.

3. Clique em Mais -> Cobertura.

4. Os detalhes de cobertura estão listados no Log de atividades.

Instalação de pacotes

Fazer upload de um pacote apenas adiciona o conteúdo do pacote ao repositório, mas ele não está acessível. Você deve instalar o pacote carregado para usar o conteúdo do pacote.

Antes da instalação do seu pacote, o Gerenciador de pacotes cria automaticamente um pacote de instantâneos que contém o conteúdo que será substituído. Esse instantâneo será reinstalado se você desinstalar o pacote.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote que deseja instalar na lista de pacotes clicando no nome do pacote.

3. Clique no botão Instalar nos detalhes do item ou na variável Instalar no status do pacote.

4. Uma caixa de diálogo solicitará a confirmação e permitirá que outras opções sejam especificadas.

   • Extrair somente - Extraia o pacote somente para que nenhum instantâneo seja criado e, portanto, a desinstalação não será possível
   • Salvar limite - Número de nós transitórios até que o salvamento automático seja acionado (aumente se você encontrar exceções de modificação simultâneas)
   • Extrair Subpacotes - Habilitar a extração automática de subpacotes
   • Manuseio de Controle de Acesso - Especifica como as informações de controle de acesso definidas no pacote são tratadas quando o pacote é instalado (as opções são as mesmas do pacote configurações avançadas do pacote)
   • Manuseio de Dependências - Especificar como as dependências são tratadas durante a instalação

5. Clique em Instalar.

6. O registro de atividades detalha o progresso da instalação.

Quando a instalação for concluída e bem-sucedida, a lista de pacotes será atualizada e a palavra Instalado aparece no status do pacote.

Reinstalar pacotes

A reinstalação de pacotes executa as mesmas etapas em um pacote já instalado que são processadas ao instalando inicialmente o pacote.

Upload e instalação baseados no sistema de arquivos

Você pode abandonar completamente o Gerenciador de pacotes ao instalar os pacotes. AEM pode detectar pacotes colocados em um local específico no sistema de arquivos local do computador host e fazer upload e instalação automaticamente.

1. Na pasta de instalação do AEM, há um crx-quicksart ao lado do jar e license.properties arquivo. Crie uma pasta chamada install under crx-quickstart resultando no caminho <aem-home>/crx-quickstart/install.

2. Nesta pasta, adicione seus pacotes. Eles serão carregados e instalados automaticamente na sua instância.

3. Quando o upload e a instalação estiverem concluídos, você poderá ver os pacotes no Gerenciador de pacotes como se tivesse usado a interface do usuário do Gerenciador de Pacotes para instalá-los.

Se a instância estiver em execução, o upload e a instalação começarão imediatamente quando você adicioná-los ao pacote na install pasta

Se a instância não estiver em execução, os pacotes serão colocados no install são instaladas na inicialização em ordem alfabética.

Desinstalação de pacotes

A desinstalação do pacote reverte o conteúdo do repositório para o instantâneo feito automaticamente pelo Gerenciador de pacotes antes da instalação.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote que deseja desinstalar na lista de pacotes clicando no nome do pacote.

3. Clique em Mais -> Desinstalar, para remover o conteúdo deste pacote do repositório.

4. Uma caixa de diálogo solicitará a confirmação e listará todas as alterações feitas.

5. O pacote é removido e o instantâneo é aplicado. O andamento do processo é mostrado no Log de atividades.

Exclusão de pacotes

A exclusão de um pacote exclui somente seus detalhes do Gerenciador de Pacotes. Se este pacote já tiver sido instalado, o conteúdo instalado não será excluído.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote que deseja excluir da lista de pacotes clicando no nome do pacote.

3. AEM solicita a confirmação de que você deseja excluir o pacote. Clique em OK para confirmar a exclusão.

4. As informações do pacote são excluídas e os detalhes são relatados no Log de atividades.

Replicação de pacotes

Replicar o conteúdo de um pacote para instalá-lo na instância de publicação.

1. Acesse o Gerenciador de Pacotes.

2. Abra os detalhes do pacote que deseja replicar da lista de pacotes clicando no nome do pacote.

3. Clique em Mais -> Replicar.

4. O pacote é replicado e os detalhes são relatados no Log de atividades.

Distribuição de software

AEM Pacotes podem ser usados para criar e compartilhar conteúdo em ambientes AEMaaCS.

Distribuição de software O fornece pacotes de AEM para uso no SDK de desenvolvimento local AEM. Os pacotes AEM fornecidos na Distribuição de software não devem ser instalados em ambientes de nuvem AEMaaCS, a menos que seja expressamente aprovado pelo Suporte Adobe.

Para obter mais informações, consulte o Documentação de distribuição de software.