AEM Cloud Manager: la pipeline full stack non riesce in fase di “Distribuzione in fase di sviluppo” a causa di XML DocView non valido nel pacchetto di contenuti
Questo articolo tratta gli errori coerenti nella pipeline full stack di Adobe Experience Manager Cloud durante la fase “Implementa in Dev” causati da XML DocView non valido in un pacchetto di contenuti.
Descrizione description
Ambiente
Adobe Experience Manager (AEM) as a Cloud Service (tutte le versioni)
Problema/Sintomi
La pipeline full stack del cloud ha esito negativo in modo coerente durante la fase Distribuisci in Dev. Più esecuzioni di pipeline presentano lo stesso comportamento, con il processo di distribuzione che si interrompe o si blocca per periodi prolungati (ad esempio, oltre 1,5 ore) senza progredire. Nei registri di distribuzione non sono visibili informazioni sugli errori utilizzabili.
- Il problema è riproducibile attivando la pipeline full stack per l’ambiente interessato.
- Nei registri non vengono visualizzati messaggi di errore specifici; la pipeline sembra bloccarsi o interrompersi automaticamente al passaggio di distribuzione.
Risoluzione resolution
-
Identificare il pacchetto di contenuti problematico
- Esamina i pacchetti di contenuti inclusi nella pipeline, concentrandoti sui pacchetti aggiunti o modificati di recente.
- Verifica la presenza di pacchetti generati da strumenti automatizzati che potrebbero introdurre XML in formato non valido.
-
Convalida file XML DocView
- Estrarre il pacchetto di contenuti e individuare tutti i file
.content.xml. - Utilizzare uno strumento di convalida XML, ad esempio
xmllint, per verificare la correttezza di ogni file.content.xml.
code language-none find . -name '*.content.xml' -exec xmllint --noout {} \;- Risolvi eventuali errori di sintassi XML segnalati dalla convalida.
- Estrarre il pacchetto di contenuti e individuare tutti i file
-
Aggiorna il processo di compilazione per evitare problemi futuri
- Verificare che il modulo
ui.contentsia stato creato utilizzando il plug-in Maven del pacchetto FileVault. - Eseguire
mvn clean verifyper convalidare la struttura del pacchetto e la correttezza XML prima di eseguire il commit o la distribuzione. - Riferimento: Struttura pacchetto contenuti progetto AEM
- Verificare che il modulo
-
Aggiungere la convalida XML alla pipeline CI
- Integra un passaggio di convalida XML nel processo CI per verificare automaticamente la corretta formattazione di tutti i file
.content.xmlprima della distribuzione.
- Integra un passaggio di convalida XML nel processo CI per verificare automaticamente la corretta formattazione di tutti i file
-
Rieseguire la pipeline
- Dopo aver corretto eventuali XML non validi e aver aggiornato il processo di build, riattiva la pipeline per verificare la corretta distribuzione.
Causa
Gli errori della pipeline sono stati causati da un file XML DocView non valido in un pacchetto di contenuto modificabile. Questo problema è emerso solo quando il pacchetto problematico è stato elaborato durante il passaggio di distribuzione, non a causa di modifiche negli strumenti di analisi o plug-in di Adobe.