Soluzione AEM per i test personalizzati dell’interfaccia utente ignorati in Cloud Manager a causa di un pacchetto di archiviazione nel contesto Docker errato

Ultimo aggiornamento: 8 luglio 2026

Se Cloud Manager ignora i test dell’interfaccia utente personalizzati anche se i test vengono eseguiti localmente, l’archivio contestuale Docker dei test dell’interfaccia utente generato potrebbe essere compilato con i file richiesti all’interno di una directory principale anziché nella directory principale dell’archivio. La verifica della struttura dell’archivio e l’aggiornamento della configurazione dell’assembly Maven ripristina il rilevamento dei test in Cloud Manager.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service

Problema/Sintomi

Questo problema si verifica in genere quando Cloud Manager non è in grado di rilevare i file di consenso del test dell’interfaccia utente nell’archivio contestuale Docker generato.

Il passaggio Test dell’interfaccia utente personalizzati mostra un messaggio simile a I test dell’interfaccia utente sono stati ignorati perché non è stato trovato alcun test nell’archivio del codice sorgente.
I test dell’interfaccia utente Playwright, Cypress, Selenium o altri test supportati vengono eseguiti localmente, ma in Cloud Manager non viene visualizzata alcuna esecuzione dei test dell’interfaccia utente.
Il file testing.properties esiste nel repository, ma Cloud Manager ignora ancora i test.
Per confermare il problema, crea il modulo dei test dell’interfaccia utente e controlla dove è memorizzato testing.properties nel file *-ui-test-docker-context.tar.gz generato. Esegui tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties. Se il risultato mostra un percorso come some-folder/testing.properties invece di solo testing.properties, l’archivio viene creato in modo errato.
È inoltre possibile confermare la configurazione verificando che testing.properties sia memorizzato accanto al file pom.xml nel modulo dei test dell’interfaccia utente e che contenga esattamente ui-tests.version=1.

Risoluzione resolution

Per risolvere il problema, effettua le seguenti operazioni:

Verifica che la pipeline utilizzi il ramo Git corretto per il modulo dei test dell’interfaccia utente. La pipeline deve utilizzare il ramo contenente il modulo ui.tests e testing.properties. Conferma nella configurazione della pipeline e nel riepilogo successivo dell’esecuzione della pipeline.
Verificare che testing.properties esista accanto al file pom.xml del modulo dei test dell’interfaccia utente e che contenga esattamente ui-tests.version=1. Dovresti visualizzare il file nel modulo corretto con il valore richiesto. Conferma direttamente nell’archivio.
Crea il modulo di test dell’interfaccia utente localmente in modo che venga generato l’archivio di contesto Docker. Dovresti vedere un file che termina in -ui-test-docker-context.tar.gz nella directory del modulo target. Verificare che l’archivio generato utilizzi il classificatore ui-test-docker-context.
Esaminare l’archivio generato e verificare se testing.properties è archiviato nella directory principale dell’archivio eseguendo tar -tvf target/*-ui-test-docker-context.tar.gz | grep testing.properties. Dovresti visualizzare solo testing.properties senza prefisso della cartella principale. Se l’output mostra un percorso come some-folder/testing.properties, l’archivio non viene compilato correttamente. Procedi al passaggio successivo.
Aggiornare assembly-ui-test-docker-context.xml in modo che il contesto Docker venga compilato nella directory principale dell’archivio. Assicurarsi che l’assembly mantenga <includeBaseDirectory>false</includeBaseDirectory> e includa testing.properties con i file di livello radice come Dockerfile e wait-for-grid.sh. Dovresti visualizzare i file richiesti memorizzati al livello superiore dell’archivio, anziché all’interno di una directory wrapper. Confermare l’operazione ricompilando il modulo e ripetendo l’ispezione dell’archivio fino a quando testing.properties non viene visualizzato nella radice.
Esegui il commit delle modifiche del pacchetto, inviale al ramo utilizzato dalla pipeline ed esegui di nuovo la pipeline. Il passaggio Custom UI Testing deve essere eseguito invece di mostrare un messaggio di salto. Conferma nei dettagli di esecuzione della pipeline e verifica che i registri dei test dell’interfaccia utente siano disponibili.
Se i test vengono ora rilevati ma non vengono eseguiti correttamente durante l’esecuzione, controlla i registri dei test dell’interfaccia utente dall’esecuzione della pipeline e correggi il test o gli errori specifici del framework. Cloud Manager dovrebbe rilevare ed eseguire correttamente l’immagine di test. Per confermarlo, controlla che la pipeline mostri un’esecuzione effettiva del test dell’interfaccia utente anziché un passaggio saltato.

Se si verificano i seguenti sintomi e i passaggi di risoluzione dei problemi producono i seguenti risultati, invia un ticket al Supporto Adobe: l’archivio mostra testing.properties nella radice, la pipeline sta utilizzando il ramo corretto e Cloud Manager segnala ancora che non sono stati trovati test dell’interfaccia utente.

Quando contatti il supporto tecnico, includi l’elenco degli archivi, il file assembly-ui-test-docker-context.xml, il modulo dei test dell’interfaccia utente pom.xml e l’URL di esecuzione della pipeline.

recommendation-more-help

experience-cloud-kcs-help-kbarticles