Solução de falhas de upload/acesso do AEM Package Manager (permissões, rede, URL e restrições de tempo de execução)
Os uploads ou instalações do Gerenciador de pacotes podem falhar quando os pacotes não são exibidos, o acesso é bloqueado ou a instalação retorna uma mensagem indefinida.
Talvez não seja possível abrir o Gerenciador de Pacotes, fazer upload de um pacote, exibir os pacotes carregados ou concluir uma instalação. Em alguns casos, os uploads parecem terminar, mas o pacote não aparece na lista. Em ambientes de nuvem, a instalação também pode falhar quando o pacote contiver conteúdo imutável que não é compatível no tempo de execução.
Causas comuns incluem permissões ausentes, URLs incorretos, restrições de rede, interferência no navegador e pacotes que contêm caminhos imutáveis em ambientes de nuvem. Confirme o caminho de acesso, teste as permissões e o comportamento do navegador e revise os filtros do pacote quanto ao conteúdo não compatível. Use a instalação do pacote de tempo de execução somente para conteúdo mutável e implante conteúdo imutável por meio do pipeline de implantação.
Descrição description
Ambiente:
- Adobe Experience Manager as a Cloud Service
- AEM Managed Services
- Adobe Experience Manager no local
Problema/sintomas:
- Se o Gerenciador de Pacotes não puder ser acessado em
/crx/packmgr, abra a URL correta do Gerenciador de Pacotes para o ambiente de destino e confirme se o/crx/packmgr/index.jspé carregado sem erros de redirecionamento ou acesso. - Se nenhum pacote estiver visível no Gerenciador de pacotes, verifique se outro usuário com o acesso esperado pode visualizar ou carregar pacotes para determinar se o problema está relacionado às permissões.
- Se o upload de um pacote for concluído, mas o pacote não aparecer no Gerenciador de pacotes, atualize a interface e tente novamente com um pequeno pacote de teste para confirmar se o upload está sendo aceito e exibido corretamente.
- Se um upload falhar sem um erro claro, tente a mesma ação de uma rede diferente para determinar se uma restrição de firewall ou proxy está bloqueando a solicitação antes que ela chegue à AEM.
- Se o navegador mostrar um erro indefinido durante a instalação, repita a ação em uma sessão incógnita ou em um navegador compatível diferente para excluir extensão, sessão ou interferência específica do navegador.
- Se um ambiente de nuvem rejeitar o pacote porque ele contém conteúdo de tempo de execução sem suporte, revise os filtros de pacote e confirme se o pacote contém apenas conteúdo mutável destinado à instalação em tempo de execução e não inclui caminhos imutáveis, como
/apps.
Causa raiz:
Essas falhas normalmente são causadas pela falta de permissões nos caminhos de pacotes, uma URL incorreta do Gerenciador de Pacotes, restrições de rede ou firewall, extensões do navegador ou comportamento de sessão que interferem nas solicitações, ferramentas de segurança locais que bloqueiam uploads ou filtros de pacote que incluem caminhos imutáveis, como /apps em ambientes de nuvem.
Resolução resolution
Tente as seguintes etapas:
- Abra a URL correta do Gerenciador de Pacotes para o ambiente de destino e confirme se o
/crx/packmgr/index.jspé carregado sem erros de redirecionamento ou acesso. - Verifique se o usuário afetado tem permissão para criar, fazer upload, exibir e instalar pacotes comparando o resultado com outro usuário que deve ter o mesmo nível de acesso.
- Se o Gerenciador de pacotes não abrir ou se os uploads não forem iniciados, repita a mesma ação de uma rede diferente para determinar se uma restrição de firewall ou proxy está bloqueando a solicitação.
- Se o upload ou a instalação falhar no navegador, repita a ação em uma sessão incógnita ou em um navegador compatível diferente para excluir extensão, sessão ou interferência específica do navegador.
- Se o mesmo upload falhar no ambiente de destino e em um SDK local, revise os controles de segurança locais ou organizacionais, pois a solicitação pode ser bloqueada antes de chegar ao AEM.
- Para ambientes de nuvem, revise os filtros de pacote e confirme se o pacote contém apenas conteúdo mutável destinado à instalação em tempo de execução e não inclui caminhos imutáveis, como
/apps. - Se o pacote incluir conteúdo imutável, implante esse conteúdo por meio do pipeline de implantação, em vez do Gerenciador de pacotes.
- Depois de fazer alterações, faça upload de um pequeno pacote de teste, atualize o Gerenciador de pacotes e confirme se o pacote aparece na lista e é instalado sem novos erros.
Se o problema continuar após essas verificações, envie um tíquete para o Suporte da Adobe quando os uploads falharem em vários navegadores, o Gerenciador de Pacotes estiver inacessível para todos os usuários, outro usuário com acesso semelhante poderá concluir a ação enquanto o usuário afetado não puder, ou os testes mostrarão que a solicitação não chega ao AEM. Inclua capturas de tela, arquivos HAR, registros do console do navegador, o nome do pacote e um resumo dos resultados da solução de problemas.