Corrigir falhas na implantação da configuração do dispatcher no AEM
A configuração do Dispatcher falha durante a implantação ou migração devido à estrutura de arquivo incorreta, empacotamento não compatível ou definições desalinhadas de configuração de pipeline e cache. Esses problemas podem impedir a implantação bem-sucedida ou causar comportamento inesperado em ambientes do AEM. Para resolver o problema, corrija a estrutura de configuração, analise o comportamento do pipeline e valide a configuração.
Descrição description
Ambientes
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Managed Services (AMS)
- Cenários de implantação e migração da configuração do Dispatcher
Problema/Sintomas
- A implantação falha quando a configuração do Dispatcher é carregada como um arquivo compactado em vez de pastas brutas
- A migração mostra o erro EPERM: operação não permitida, link simbólico em sistemas Windows
- O pipeline somente do Dispatcher não atualiza as configurações conforme esperado
- O cache não é limpo após a implantação, apesar das atualizações de configuração
Causa
Falhas de implantação ocorrem porque o Cloud Manager requer a estrutura de pastas bruta do Dispatcher, em vez de arquivos compactados. No AMS, as variáveis específicas do ambiente devem ser definidas externamente em vez de serem codificadas. Durante a migração, o Conversor do Dispatcher depende de links simbólicos que podem ser bloqueados por restrições do sistema operacional.
Resolução resolution
Siga estas etapas para resolver o problema
- Verifique se o repositório contém pastas descompactadas do Dispatcher, como
conf.deconf.dispatcher.d, no local correto e remova todos os arquivos zip criados manualmente. - Crie um pipeline no nível da Web dedicado no Cloud Manager e selecione o caminho correto do repositório para que ele implante a configuração do dispatcher de maneira independente, sem acionar implantações completas.
- Revise o comportamento da implantação e confirme se o pipeline selecionado inclui a estrutura de origem do dispatcher e é executado com sucesso com logs atualizados, observando que os pipelines somente do dispatcher são atualizados de forma incremental.
- Aplique métodos compatíveis de limpeza de cache habilitando um terminal de limpeza para AEM as a Cloud Service ou usando scripts personalizados no AMS e confirme as atualizações de cache verificando os carimbos de data e hora do cache do dispatcher.
- Defina variáveis específicas do ambiente no Managed Services usando arquivos de variáveis, inclua-as em configurações de host virtual e verifique se a configuração é resolvida corretamente durante as solicitações.
- Recupere os pacotes de configuração do dispatcher do ambiente quando necessário e confirme se os arquivos extraídos correspondem à estrutura de diretório esperada.
- Execute a conversão do dispatcher com as permissões de sistema apropriadas ou use um ambiente compatível para evitar erros de link simbólico e verifique se a estrutura convertida é gerada com êxito.
- Valide a implantação entre ambientes revisando logs de execução de pipeline, verificando logs do dispatcher e confirmando se as atualizações de configuração se aplicam corretamente.
- Entre em contato com a equipe de conta da Adobe para solicitar credenciais de API de limpeza de CDN, se precisar de limpeza programática do cache.