O pipeline do Cloud Manager é interrompido e falha quando o dispatcher de visualização não está pronto

Última atualização: 6 de agosto de 2026

Este artigo explica como resolver pipelines de implantação do AEM as a Cloud Service que permanecem em um estado inicial por horas e falham quando o dispatcher de visualização não fica pronto a tempo.

Descrição description

Ambiente

Adobe Experience Manager (AEM) as a Cloud Service
Pipelines de implantação do Cloud Manager usando configurações do dispatcher com mapas de regravação gerenciados

Problema/Sintomas

O pipeline de implantação permanece em um estado inicial ou de aquecimento por um período estendido antes de falhar.
As falhas nas verificações de inicialização e disponibilidade do dispatcher são vistas nos logs relacionados a content/dam/rewrites/redirects.
O Cloud Manager mostra uma mensagem de falha de implantação genérica após um grande atraso.

The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.

As etapas de compilação e qualidade do código foram concluídas com êxito, mas a implantação não avança normalmente depois.
O problema pode ocorrer mesmo quando a mesma ramificação ou código foi implantado com êxito em execuções anteriores.
Isso é mais provável quando o projeto usa mapas de regravação gerenciados e a inicialização do Dispatcher de visualização está atrasada.

Condições de reprodução

Tentativa de implantar código (mesmo código anteriormente bem-sucedido) no ambiente de desenvolvimento usando o Cloud Manager.
O Dispatcher de visualização ou os serviços de visualização relacionados não se tornam íntegros dentro do período esperado.
O pipeline falha após uma longa espera ou é concluído com sucesso, mas com um tempo de execução excepcionalmente longo.

Causa

O pipeline de implantação trava e eventualmente falha porque o contêiner do dispatcher de visualização não atinge um estado pronto, fazendo com que o Cloud Manager aguarde até que ocorra um tempo limite. Atualizar a configuração YAML do Dispatcher para definir o sinalizador de espera como falso permite que o Dispatcher de visualização seja iniciado sem bloquear o pipeline.

Resolução resolution

Para corrigir atrasos e falhas de pipeline causadas pelo bloqueio de pré-visualização da inicialização do Dispatcher em mapas de regravação gerenciados, siga estas etapas:

Confirme se todos os serviços de visualização, incluindo o dispatcher, estão configurados corretamente e podem ser iniciados sem erros. Verifique nos logs do Cloud Manager se há falhas de verificação de integridade ou de preparação relacionadas ao dispatcher de visualização.
Edite o arquivo YAML de configuração do dispatcher, como rewrite-maps.yaml ou managed-rewrite-maps.yaml. Revise o arquivo para entradas de mapa que possam bloquear a inicialização e certifique-se de que o sinalizador wait esteja definido como false para todas as entradas de mapa. Por exemplo:

maps:
        - name: redirects-301.map
        path: /content/dam/rewrites/redirects-301.txt
        ttl: 300
        wait: false
        - name: redirects-302.map
        path: /content/dam/rewrites/redirects-302.txt
        ttl: 300
        wait: false

Salve e confirme as alterações no repositório e execute o pipeline novamente no Cloud Manager.
Monitore a execução do pipeline para confirmar se o dispatcher de visualização e os serviços relacionados atingem um estado íntegro em tempo hábil, em vez de permanecer em um estado de início ou aquecimento prolongado.
Depois de uma implantação bem-sucedida, verifique se o código do Dispatcher foi implantado conforme esperado.
Se o pipeline ainda demorar mais do que o esperado ou falhar, revise o dispatcher e visualize os logs do serviço para obter informações adicionais sobre disponibilidade, verificação de integridade ou problemas de inicialização.

recommendation-more-help

experience-cloud-kcs-help-kbarticles