Resolver falhas de pipeline do AEM as a Cloud Service durante atualizações de índice
Este artigo explica como resolver falhas no pipeline do AEM as a Cloud Service Cloud Manager que ocorrem durante a etapa de atualização do índice após a implantação de definições de índice personalizadas ou estendidas. As orientações abordam causas comuns e etapas acionáveis para ajudar a garantir implantações bem-sucedidas.
Descrição description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Sintomas
- Falhas de pipeline com erros que indicam problemas ao recuperar novas definições de índice
- Avisos de validação relacionados aos arquivos de configuração de índice
Causa
As causas básicas geralmente incluem incompatibilidades entre as definições de índice personalizado e as versões de índice prontas para uso (OOTB) no ambiente de destino, configurações Tika incompletas ou inválidas ou práticas inadequadas de nomenclatura e controle de versão de índice.
Resolução resolution
Siga as etapas abaixo para resolver o problema:
- Compare suas definições de índice personalizadas com as definições de índice OOTB no ambiente de destino. Obter a definição de índice OOTB mais recente (por exemplo, damAssetLucene-14) de um ambiente do AEM as a Cloud Service que execute a mesma versão ou uma versão mais recente do que o ambiente de destino.
- Mescle as alterações personalizadas na definição mais recente de OOTB e atribua um nome personalizado com versão apropriada (por exemplo, damAssetLucene-14-custom-2). Não suponha que a versão OOTB no ambiente de desenvolvimento corresponda à versão em outros ambientes.
- Valide a configuração do Tika na definição do índice personalizado. Verifique se a subárvore Tika completa está presente e é válida, incluindo tika/ folder, config.xml, jcr:content, jcr:data e jcr:mimeType definidos como application/xml. Evite substituições parciais ou nós config.xml vazios.
- Siga as convenções de nomenclatura do AEM as a Cloud Service para índices personalizados. Para índices totalmente personalizados, use um nome e versão personalizados exclusivos (por exemplo, -custom-1). Para extensões de índices OOTB, use o padrão de nomenclatura e controle de versão OOTB. Não renomeie ou exclua nós de índice implantados diretamente no ambiente de nuvem.
- Confirme se todas as definições de índice estão localizadas em ui.apps/src/main/content/jcr_root/_oak_index e estão incluídas no pacote de código do aplicativo, não em um pacote de conteúdo mutável. Verifique se os metadados do pacote incluem allowIndexDefinitions=true e noIntermediateSaves=true. Todas as definições de índice devem usar a configuração Lucene compatível com a nuvem e as configurações assíncronas com suporte (como
[async],[async, {nrt]ou[fulltext-async]). - Implante o pacote revisado em um ambiente inferior e verifique se a implantação é concluída com êxito, se as definições de índice esperadas estão presentes e se as consultas usam os índices pretendidos.
- Para desativar definições de índice antigas, não renomeie ou exclua nós de índice diretamente. Em vez disso, trate a retirada como uma alteração de código separada por meio do Cloud Manager. Remover entradas apenas do filter.xml não remove os dados de índice implantados. Use uma definição de índice compatível subsequente para desativar o índice anterior e torná-lo qualificado para limpeza periódica.
Após concluir essas etapas, execute novamente o pipeline e verifique se a implantação foi bem-sucedida e se os índices pretendidos estão ativos.