A instalação do pacote falha em ambientes AEM
A instalação do pacote do AEM falha quando os pacotes incluem caminhos imutáveis, estrutura ZIP inválida, ganchos de instalação ou versões afetadas do SDK. Diagnostique o erro de instalação e siga as etapas de resolução apropriadas para instalar o pacote com êxito.
Descrição description
Ambiente
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Developer App Builder
Problema/Sintomas
- Erro durante o upload indicando que o arquivo não é um pacote de conteúdo válido porque jcr_root está ausente.
- Erros de validação de pacote durante a instalação.
- Instalação bloqueada porque o pacote contém caminhos de repositório imutáveis.
- Os pacotes incorporados dentro de um pacote all não são instalados automaticamente.
- Falhas de download de pacote causadas por nomes de pacote inválidos.
- Falhas de instalação relacionadas a classes de gancho de instalação ausentes.
Causa
As falhas de instalação ocorrem quando a estrutura do pacote é inválida, o pacote inclui caminhos de repositório imutáveis, nomes de pacote contêm caracteres não suportados, ganchos de instalação são usados onde não são suportados ou a implantação depende de uma versão do SDK afetada por uma regressão.
Resolução resolution
Para resolver esse problema, siga estas etapas:
- Identifique o erro de instalação revisando a mensagem ou os logs do Gerenciador de pacotes.
- Se o pacote não for reconhecido como um pacote de conteúdo, verifique se
META-INFejcr_rootexistem no nível superior do arquivo ZIP. Recrie o pacote, se necessário. - Se o pacote contiver caminhos de repositório imutáveis, implante o código por meio do pipeline de implantação apropriado, em vez de instalá-lo diretamente pelo Gerenciador de pacotes.
- Se os pacotes incorporados não forem instalados automaticamente, verifique a versão do SDK e atualize para uma versão do SDK que inclua a correção de regressão.
- Remova os ganchos de instalação ao implantar em ambientes incompatíveis. Para ambientes compatíveis, verifique se todas as dependências necessárias estão instaladas.
- Atualize os nomes de pacote para remover caracteres não suportados e recrie o pacote antes de implantar novamente.
- Valide a instalação confirmando que os erros de instalação não aparecem mais e que os pacotes incorporados são instalados corretamente quando aplicável.
Leitura relacionada
recommendation-more-help
experience-cloud-kcs-help-kbarticles