La canalización de Cloud Manager se detiene y falla cuando la previsualización de Dispatcher no está lista
En este artículo se explica cómo resolver las canalizaciones de implementación de AEM as a Cloud Service que permanecen en estado de inicio durante horas y luego fallan cuando la previsualización de Dispatcher no está lista a tiempo.
Descripción description
Entorno
- Adobe Experience Manager (AEM) as a Cloud Service
- canalizaciones de implementación de Cloud Manager que utilizan configuraciones de dispatcher con asignaciones de reescritura administradas
Problema/Síntomas
- La canalización de implementación permanece en estado de inicio o calentamiento durante un periodo prolongado antes de fallar.
- Los errores de inicio y comprobación de disponibilidad de Dispatcher se ven en los registros relacionados con
content/dam/rewrites/redirects. - Cloud Manager muestra un mensaje de error de implementación genérico después de un largo retraso.
The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.
- Los pasos de generación y calidad del código se completan correctamente, pero la implementación no progresa normalmente posteriormente.
- El problema puede ocurrir incluso cuando la misma rama o código se implementó correctamente en ejecuciones anteriores.
- Esto es más probable cuando el proyecto utiliza mapas de reescritura administrada y se retrasa el inicio de la previsualización de Dispatcher.
Condiciones de reproducción
- Intentando implementar código (incluso código exitoso anteriormente) en el entorno de desarrollo usando Cloud Manager.
- El despachante de vista previa o los servicios de vista previa relacionados no se recuperan dentro del intervalo de tiempo esperado.
- La canalización falla después de una larga espera o se completa correctamente pero con un tiempo de ejecución inusualmente largo.
Causa
La canalización de implementación se bloquea y, finalmente, falla porque el contenedor de previsualización de Dispatcher no alcanza un estado listo, lo que hace que Cloud Manager espere hasta que se agote el tiempo de espera. Actualizar la configuración YAML de Dispatcher para establecer el indicador de espera en false permite que la previsualización de Dispatcher se inicie sin bloquear la canalización.
Resolución resolution
Para corregir los retrasos y errores de canalización causados por el bloqueo de inicio de la previsualización de Dispatcher en los mapas de reescritura administrada, siga estos pasos:
- Confirme que todos los servicios de vista previa, incluido Dispatcher, estén configurados correctamente y se puedan iniciar sin errores. Compruebe los registros de Cloud Manager para ver si hay algún error de preparación o de comprobación de estado relacionado con la vista previa de Dispatcher.
- Edite el archivo YAML de configuración del distribuidor, como
rewrite-maps.yamlomanaged-rewrite-maps.yaml. Revise el archivo en busca de entradas de mapa que puedan bloquear el inicio y asegúrese de que el indicadorwaitestá establecido enfalsepara todas las entradas de mapa. Por ejemplo:
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
- Guarde y confirme los cambios en el repositorio y, a continuación, vuelva a ejecutar la canalización en Cloud Manager.
- Monitorice la ejecución de la canalización para confirmar que la previsualización de Dispatcher y los servicios relacionados alcancen un estado saludable de forma oportuna en lugar de permanecer en un estado de inicio o calentamiento prolongado.
- Después de una implementación correcta, compruebe que el código de Dispatcher se haya implementado según lo esperado.
- Si la canalización aún tarda más de lo esperado o falla, revise los registros del servicio de Dispatcher y previsualice los registros de preparación adicional, comprobación de estado o problemas de inicio.