La pipeline Cloud Manager si blocca e genera un errore quando l’anteprima del dispatcher non è pronta
Questo articolo spiega come risolvere le pipeline di distribuzione di AEM as a Cloud Service che rimangono in uno stato di avvio per ore e poi hanno esito negativo quando l’anteprima del dispatcher non diventa pronta in tempo.
Descrizione description
Ambiente
- Adobe Experience Manager (AEM) as a Cloud Service
- Pipeline di distribuzione di Cloud Manager utilizzando le configurazioni del dispatcher con mappe di riscrittura gestite
Problema/Sintomi
- Prima di generare un errore, la pipeline di distribuzione rimane in uno stato di avvio o riscaldamento per un periodo di tempo prolungato.
- Gli errori dei controlli di avvio e preparazione del dispatcher vengono visualizzati nei registri relativi a
content/dam/rewrites/redirects. - Cloud Manager mostra un messaggio di errore di distribuzione generico dopo un lungo ritardo.
The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.
- I passaggi di generazione e qualità del codice sono stati completati correttamente, ma la distribuzione non procede normalmente in seguito.
- Il problema può verificarsi anche quando lo stesso ramo o codice è stato distribuito correttamente nelle esecuzioni precedenti.
- Ciò è più probabile quando il progetto utilizza mappe di riscrittura gestite e l’avvio dell’anteprima di Dispatcher subisce ritardi.
Condizioni di riproduzione
- Tentativo di distribuire il codice (anche il codice con esito positivo in precedenza) nell’ambiente di sviluppo utilizzando Cloud Manager.
- L’anteprima del dispatcher o dei servizi di anteprima correlati non si integra entro il periodo di tempo previsto.
- La pipeline ha esito negativo dopo una lunga attesa oppure viene completata correttamente ma con un runtime insolitamente lungo.
Causa
La pipeline di distribuzione si blocca e alla fine non riesce perché il contenitore del dispatcher di anteprima non raggiunge uno stato pronto, causando un’attesa in Cloud Manager fino a quando non si verifica un timeout. L’aggiornamento della configurazione YAML del dispatcher per impostare il flag di attesa su false consente di avviare il dispatcher di anteprima senza bloccare la pipeline.
Risoluzione resolution
Per risolvere i ritardi e gli errori della pipeline causati dal blocco dell’avvio del dispatcher in anteprima sulle mappe di riscrittura gestite, effettua le seguenti operazioni:
- Verifica che tutti i servizi di anteprima, incluso Dispatcher, siano configurati correttamente e possano essere avviati senza errori. Controlla i registri di Cloud Manager per verificare la preparazione o gli errori di verifica dello stato relativi all’anteprima di Dispatcher.
- Modifica il file YAML di configurazione del dispatcher, ad esempio
rewrite-maps.yamlomanaged-rewrite-maps.yaml. Esaminare il file per individuare le voci di mapping che possono bloccare l’avvio e assicurarsi che il flagwaitsia impostato sufalseper tutte le voci di mapping. Ad esempio:
maps:
- name: redirects-301.map
path: /content/dam/rewrites/redirects-301.txt
ttl: 300
wait: false
- name: redirects-302.map
path: /content/dam/rewrites/redirects-302.txt
ttl: 300
wait: false
- Salva e conferma le modifiche nell’archivio, quindi esegui nuovamente la pipeline in Cloud Manager.
- Monitora l’esecuzione della pipeline per verificare che l’anteprima del dispatcher e dei servizi correlati raggiungano tempestivamente uno stato integro invece di rimanere in uno stato di avvio o riscaldamento prolungato.
- Dopo una distribuzione corretta, verifica che il codice del dispatcher sia stato distribuito come previsto.
- Se la pipeline richiede ancora più tempo del previsto o genera un errore, esamina il dispatcher e i registri del servizio di anteprima per verificare l’idoneità, il controllo di integrità o i problemi di avvio.