O pipeline do AEM as a Cloud Service ficou no estado EM EXECUÇÃO devido a problemas de índice Oak/Lucene personalizados
Este artigo explica como resolver situações em que um pipeline de implantação do as a Cloud Service do Adobe Experience Manager (AEM) permanece preso no estado EM EXECUÇÃO devido a problemas com índices Oak/Lucene personalizados.
Descrição description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS), todas as versões que usam os pipelines do Cloud Manager.
Problema/Sintomas
- O pipeline de implantação do Cloud Manager permanece no estado EM EXECUÇÃO por um período estendido e não é concluído.
- A verificação de preparação do ambiente está bloqueada, impedindo o pipeline de progredir.
- Os logs de trabalho de indexação mostram erros como:
Error while processing an index write operation java.io.IOException: Invalid byte range request for [ /oak:index/cqPageLucene-custom-1] ...
- Erros do sistema de arquivos, como:
java.nio.file.NoSuchFileException
- Os nós de índice personalizados, como
/oak:index/cqPageLucene-custom-1e/oak:index/damAssetLucene-11-custom-4, aparecem no repositório mesmo se não estiverem presentes na base de código atual. - A exclusão desses nós de índice manualmente no CRXDE é apenas temporária porque eles podem reaparecer após a reimplantação.
Causa
O pipeline está bloqueado porque a verificação de preparação do ambiente não pode ser concluída devido a um índice Oak/Lucene personalizado corrompido ou inconsistente. Isso impede que o trabalho de indexação seja concluído, deixando o pipeline preso no estado EM EXECUÇÃO. A exclusão manual de nós de índice não é persistente; a remoção adequada requer a atualização da base de código e o uso da abordagem de gerenciamento de índice compatível.
Resolução resolution
Siga as etapas abaixo para resolver o problema:
- Revise os logs de trabalho de indexação e identifique erros relacionados aos índices personalizados, como
/oak:index/cqPageLucene-custom-1. Confirme se os nós de índice existem na base de código emui.apps/src/main/content/jcr_root/_oak_index/ou em um arquivodiff.json. - Procure no repositório definições dos índices problemáticos, como
cqPageLucene-custom-1oudamAssetLucene-11-custom-4. Exclua essas definições de_oak_indexou de qualquer pacote de conteúdo de índice e confirme as alterações. - Expresse todas as alterações no índice personalizado em
/oak:index/diff.index/diff.jsonusando o modelo de Gerenciamento simplificado de índice. Implante o código atualizado pelo Cloud Manager. - Depois de limpar a base de código e confirmar que apenas as personalizações pretendidas existem no
diff.json, reimplante por meio do Cloud Manager. O pipeline deve ser concluído com êxito se nenhuma corrupção de índice permanecer. - Se o problema persistir, verifique se há erros de sistema de arquivos ou corrupção de segmento Lucene nos registros. Recrie o índice afetado removendo o nó de tempo de execução problemático e reimplantando.
- Após a reimplantação, o pipeline deve ser concluído com êxito e o ambiente deve ser marcado como pronto.
Notas
- A plataforma gera novos nós
*-custom-*conforme necessário e desativa automaticamente versões mais antigas não utilizadas ao longo do tempo. - Evite excluir nós de índice manualmente no CRXDE como uma solução permanente, pois os nós podem ser recriados durante implantações posteriores se a base de código ou
diff.jsonainda fizer referência a eles.