Risolvere gli errori della pipeline di AEM as a Cloud Service durante gli aggiornamenti dell’indice
Questo articolo spiega come risolvere gli errori nella pipeline di AEM as a Cloud Service Cloud Manager che si verificano durante il passaggio di aggiornamento dell’indice dopo la distribuzione di definizioni di indice personalizzate o estese. Le linee guida descrivono le cause comuni e i passaggi utilizzabili per garantire distribuzioni corrette.
Descrizione description
Ambiente
Adobe Experience Manager as a Cloud Service (AEMaaCS)
Problema/Sintomi
- Errori di pipeline con errori che indicano problemi nel recupero delle nuove definizioni dell’indice
- Avvisi di convalida relativi ai file di configurazione dell’indice
Causa
Le cause principali spesso includono incongruenze tra le definizioni di indice personalizzato e le versioni predefinite (OOTB) nell’ambiente di destinazione, configurazioni Tika incomplete o non valide o pratiche non corrette per la denominazione e il controllo delle versioni degli indici.
Risoluzione resolution
Per risolvere il problema, segui i passaggi seguenti:
- Confronta le definizioni di indice personalizzate con le definizioni di indice OOTB nell’ambiente di destinazione. Ottieni la definizione dell’indice OOTB più recente (ad esempio, damAssetLucene-14) da un ambiente AEM as a Cloud Service che esegue la stessa versione o una versione più recente rispetto all’ambiente di destinazione.
- Unisci le modifiche personalizzate alla definizione OOTB più recente e assegna un nome personalizzato con versione appropriata (ad esempio, damAssetLucene-14-custom-2). Non presumere che la versione OOTB nell’ambiente di sviluppo corrisponda alla versione in altri ambienti.
- Convalida la configurazione Tika nella definizione dell’indice personalizzato. Verificare che la sottostruttura tika completa sia presente e valida, inclusi la cartella tika/, config.xml, jcr:content, jcr:data e jcr:mimeType impostati su application/xml. Evitare sostituzioni parziali o nodi config.xml vuoti.
- Segui le convenzioni di denominazione di AEM as a Cloud Service per gli indici personalizzati. Per gli indici completamente personalizzati, utilizza un nome personalizzato e una versione univoci (ad esempio, -custom-1). Per le estensioni degli indici OOTB, utilizza il modello di denominazione e controllo delle versioni OOTB. Non rinominare o eliminare i nodi di indice distribuiti direttamente nell’ambiente Cloud.
- Conferma che tutte le definizioni dell’indice si trovino in ui.apps/src/main/content/jcr_root/_oak_index e siano incluse nel pacchetto di codice dell’applicazione, non in un pacchetto di contenuto mutabile. Assicurarsi che i metadati del pacchetto includano allowIndexDefinitions=true e noIntermediateSaves=true. Tutte le definizioni di indice devono utilizzare la configurazione Lucene compatibile con Cloud e le impostazioni asincrone supportate (ad esempio
[asincrono],[asincrono, nrt]o[fulltext-async]). - Distribuisci il pacchetto rivisto in un ambiente inferiore e verifica che la distribuzione sia stata completata correttamente, che siano presenti le definizioni di indice previste e che le query utilizzino gli indici previsti.
- Per rimuovere le definizioni di indice precedenti, non rinominare o eliminare direttamente i nodi di indice. Tramite Cloud Manager è invece possibile gestire il ritiro come una modifica separata del codice. La rimozione delle voci dal solo filter.xml non rimuove i dati di indice distribuiti. Utilizza una definizione di indice conforme successiva per disabilitare l’indice precedente e renderlo idoneo per la pulizia periodica.
Dopo aver completato questi passaggi, esegui nuovamente la pipeline e verifica che la distribuzione abbia esito positivo e che gli indici previsti siano attivi.