Le distribuzioni AEM Cloud Manager DEV non riescono a causa di errori XML e ClientLib
In questo articolo vengono illustrate le cause e i passaggi di risoluzione degli errori di distribuzione e dell’aumento dei tempi di distribuzione negli ambienti Adobe Experience Manager (AEM) Cloud Manager DEV causati da errori di sintassi XML e da problemi di compilazione delle librerie client.
Descrizione description
Ambiente
- Adobe Experience Manager (AEM) Cloud Manager (tutte le versioni)
Problema/Sintomi
-
Le distribuzioni DEV richiedono molto più tempo del solito (più di due ore) e alla fine falliscono durante la fase di distribuzione.
-
La pipeline di distribuzione supera le fasi di convalida, generazione, unit test, scansione del codice e creazione delle immagini, ma non riesce durante la fase di distribuzione in DEV.
-
I registri di distribuzione mostrano errori relativi a tag di fine XML mancanti nei pacchetti di contenuto, ad esempio:
Il tipo di elemento “content” deve essere terminato dal tag di fine corrispondente "
</content>".Il tipo di elemento “header” deve essere terminato dal tag di fine corrispondente "
</header>". -
Le importazioni del pacchetto di distribuzione non riescono a causa di errori di analisi XML.
-
Si verificano errori di compilazione della libreria client (ClientLib) LESS, come variabili non definite (ad esempio, @white) e mixin mancanti.
-
Si verificano errori di compilazione Java per le classi di modelli personalizzati non risolte.
-
Questi errori erano presenti in precedenza ma non hanno causato errori di distribuzione. Ora causano errori di pipeline.
Causa
Gli errori di distribuzione si verificano a causa di errori di sintassi XML (tag finali mancanti), variabili o mixin della libreria client non risolti e classi di modelli Java personalizzati mancanti. Le recenti modifiche apportate alla pipeline o all’ambiente possono impedire la corretta distribuzione di questi problemi, anche se in precedenza non erano di blocco.
Risoluzione resolution
Per risolvere il problema, segui la procedura riportata di seguito:
- Accedi ai registri di esecuzione della pipeline di Cloud Manager per la distribuzione non riuscita.
- Identifica tutti gli errori di analisi XML e di compilazione della libreria client.
- Individuare i file XML di riferimento, ad esempio, in
/conf/.../settings/wcm/templates/. - Assicurarsi che tutti gli elementi XML, ad esempio
<content>e<header>, includano tag di chiusura corrispondenti, ad esempio</content>e</header>. - Convalida la struttura XML con una convalida XML prima di confermare le modifiche.
- Esaminare i file LESS e CSS per le variabili non definite, ad esempio
@whitee@mid-blue, e i mixin mancanti, ad esempio.label-small-style()e.media(). - Definisci le variabili e i mixin mancanti oppure aggiorna le importazioni per includere le definizioni richieste.
- Rigenera le librerie client localmente per confermare la corretta compilazione.
- Assicurati che tutte le classi di modelli Sling personalizzate a cui fanno riferimento i componenti siano presenti e importate correttamente nel codebase.
- Risolvere eventuali dipendenze mancanti o riferimenti a pacchetti errati.
- Dopo aver completato le correzioni necessarie, esegui il commit delle modifiche nell’archivio.
- Attiva una nuova distribuzione in Cloud Manager e monitora la pipeline per verificare che venga completata correttamente.