Pipeline di implementazione di AEM Cloud Manager bloccata durante la distribuzione
Questo articolo spiega come risolvere i problemi relativi a una pipeline di distribuzione Adobe Experience Manager (AEM) as a Cloud Service che rimane in esecuzione o bloccata durante la generazione o la distribuzione. I registri possono identificare definizioni dell’indice Oak non valide, errori di convalida del pacchetto FileVault, errori del codice personalizzato o problemi di preparazione al contenitore di pubblicazione. Per risolvere il problema, controlla la pipeline e i registri di distribuzione, correggi il codice o la configurazione quando i registri identificano un problema del cliente, convalida il pacchetto localmente, riesegui la pipeline e verifica che l’ambiente e i pod siano integri.
Descrizione description
Ambiente
- Adobe Experience Manager as a Cloud Service
- Adobe Experience Manager Cloud Manager
- Pipeline di distribuzione di Cloud Manager
- Indice Oak personalizzato e definizioni del pacchetto FileVault nel codebase del progetto
- Ambiente di pubblicazione sottoposto a controlli di implementazione e preparazione
Problema/Sintomi
- Quando esegui una distribuzione Cloud Manager, la pipeline rimane in uno stato di esecuzione durante la generazione o la distribuzione nell’ambiente di staging e non procede.
- La pipeline bloccata impedisce l’attività di rilascio e la promozione in ambienti più elevati.
- I registri di compilazione contengono errori come ValidationViolation: nodo figlio obbligatorio mancante o errori di tipo nodo non valido nei file di configurazione.
- I contenitori di pubblicazione iniziano ma non diventano pronti, pertanto l’ambiente non raggiunge lo stato di preparazione richiesto.
Causa
La pipeline non avanza quando la convalida della build o della distribuzione rifiuta una definizione di indice Oak non valida, un nodo figlio obbligatorio mancante o un tipo di nodo non valido in un pacchetto FileVault. All’avvio dei contenitori Pubblicazione si verifica una condizione di preparazione alla distribuzione separata che non risulta pronta, pertanto Cloud Manager non può contrassegnare l’ambiente come pronto. La causa rilevante viene determinata dalla pipeline e dai registri di distribuzione.
Risoluzione resolution
Per risolvere il problema, segui i passaggi seguenti:
-
Esamina i dettagli di esecuzione della pipeline Cloud Manager per l’esecuzione interessata.
-
Scarica e controlla i registri di build e distribuzione, concentrandoti sui passaggi di build e distribuzione.
-
Cerca gli errori di convalida del pacchetto FileVault o dell’indice Oak, ad esempio:
- Violazione di convalida: nodo figlio obbligatorio mancante
- Errori di tipo nodo non validi nei file di configurazione, ad esempio
src/main/content/jcr_root/_oak_index/your-index-name/config.xml.
-
Aggiorna i file di configurazione dell’indice Oak nella base di codice del progetto in modo che siano conformi alle regole di indicizzazione AEM as a Cloud Service e ai tipi di nodo JCR/Oak. Nota: distribuisci le definizioni dell’indice Oak come codice tramite Cloud Manager. Non modificare manualmente i nodi dell’indice di runtime in un ambiente in esecuzione.
-
Eseguire FileVault Package Validator in locale rispetto al pacchetto prima di confermare le modifiche. Confermare che le definizioni del pacchetto superino la convalida.
-
Dopo aver corretto i problemi di configurazione, avvia una nuova esecuzione della pipeline in Cloud Manager.
-
Monitora la pipeline e verifica che avanzi oltre il passaggio precedentemente bloccato.
-
Se il livello di pubblicazione rimane in Avanzamento con contenitori non pronti:
- Esamina i registri di distribuzione per individuare eventuali errori di avvio dei contenitori.
- Risolvi gli errori di runtime o le configurazioni errate identificate nei registri.
Nota: se i registri non identificano un problema di codice o configurazione del cliente e i contenitori non sono ancora pronti, raccogli i registri di distribuzione e Cloud Manager e contatta il supporto Adobe. Non tentare di gestire direttamente i pod di AEM.
-
Verifica che la pipeline di distribuzione venga completata correttamente e che tutti i pod vengano segnalati come integri in Cloud Manager.