Cloud Automation Patching Service (CAPS) guía de solución de problemas
Al usar CAPS para operaciones de revisión, puede encontrar mensajes de error y problemas que pueden impedir la aplicación o reversión de revisión correcta. Esta guía proporciona soluciones para los problemas más comunes.
Pasos rápidos de solución de problemas
Si falla la operación de parche
- Compruebe el estado de la operación para comprender qué fase falló
- Revisar mensajes de error por motivos de error específicos
- Examinar los registros de errores para obtener detalles técnicos
- Siga las soluciones proporcionadas en esta guía
Duración de operaciones de parche
En la mayoría de los entornos, la siguiente cronología describe cuánto tiempo deben tardar las operaciones de parche, pero podría tardar más según el tamaño y la complejidad del entorno:
- Procesamiento previo: de 2 a 5 minutos
- Parches: de 5 a 15 minutos
- Procesamiento posterior: de 10 a 40 minutos
- Total: 15-60 minutos
Cancelación de un parche en curso
Mensajes de éxito comunes
-
"Trabajo completado correctamente" - El parche se aplicó/revirtió correctamente sin ningún problema.
-
"Se ha aplicado el parche" - Está intentando aplicar un parche que ya se ha aplicado. El sistema detectó que el parche ya está presente en su entorno. No es necesario realizar ninguna acción.
-
"El parche se ha revertido" - Está intentando revertir un parche que ya se ha revertido. El sistema detectó que el parche no se está aplicando actualmente. No es necesario realizar ninguna acción.
Mensajes de error comunes y soluciones
Errores de aplicación de parche
"No se puede aplicar el parche porque CAPS ha detectado estos problemas con el código base o el archivo de parche"
Cuando se produce: Durante la comprobación preliminar
Causa: El parche entra en conflicto con la base de código actual O hay un problema con el propio parche
Soluciones:
- Revise los registros de errores detallados proporcionados para identificar si se trata de un problema de código base o de parche
- Compruebe si hay personalizaciones en conflicto en el código
- Verifique que el parche sea compatible con su versión de Adobe Commerce
- Considere la posibilidad de resolver conflictos manualmente o póngase en contacto con el soporte técnico
"Este parche no fue administrado por CAPS. No se puede revertir"
Cuando se produce: Durante las operaciones de reversión
Causa: Está intentando revertir un parche que no se aplicó mediante CAPS
Solución: Use el mismo método que se usó para aplicar el parche originalmente o póngase en contacto con el soporte técnico para obtener ayuda manual
Errores de entorno y validación
"El entorno no está sincronizado con el elemento principal"
Cuando se produce: Durante la validación
Causa: El entorno de integración difiere del entorno principal
Soluciones:
- Sincronizar el entorno con la rama principal
- Vuelva a intentar la operación de parche
- Póngase en contacto con el servicio de asistencia si persisten problemas de sincronización
"No se cumplen las salvaguardias del entorno de producción"
Cuando esto sucede: Durante la comprobación preliminar de entornos de producción
Causa: El entorno de producción no cumple las condiciones de seguridad requeridas
Soluciones:
- Habilite el modo de mantenimiento para su tienda de producción
- Deshabilitar los trabajos cron en el entorno de producción
- Compruebe que se cumplen ambas condiciones antes de volver a intentarlo
"Se ha aplicado el parche, pero la comprobación de estado no ha funcionado. Considere la posibilidad de revertir"
Cuando ocurre: Después de aplicar el parche durante la validación
Causa: El parche se aplicó correctamente, pero no se pudo comprobar el estado
Soluciones:
- Revisar los registros de aplicaciones para detectar errores específicos
- Prueba manual de la funcionalidad esencial
- Considere la posibilidad de revertir el parche si los problemas persisten
- Póngase en contacto con el soporte si necesita ayuda
Errores de autenticación y acceso
"Error de autenticación para el repositorio de Adobe Commerce"
Cuando ocurre: Durante cualquier etapa
Causa: credenciales de repositorio de Adobe Commerce no válidas o caducadas
Soluciones:
Existen dos opciones recomendadas para resolver este problema:
Opción 1: corregir env:COMPOSER_AUTH variable de nivel de entorno (recomendado)
- Asegúrese de haber configurado las credenciales correctas para
env:COMPOSER_AUTH. - Para acceder a la configuración global, haga clic en el icono de engranaje en la parte superior izquierda de la interfaz de usuario del proyecto en la nube y, a continuación, seleccione la pestaña Variables.
- Asegúrese de seleccionar Disponible durante la compilación y deseleccione Disponible durante la ejecución.
Si la Opción 1 no resuelve su problema, continúe con la Opción 2.
Opción 2: crear e implementar el archivo auth.json manualmente
- SSH en el servidor.
- Recupere el contenido de la variable
env:COMPOSER_AUTHactual mediante:echo $COMPOSER_AUTH - Copie todo el contenido del paso anterior (en formato JSON).
- Cree un nuevo archivo de nombre
auth.jsoncon este contenido. - Confirme este archivo
auth.jsonrecién creado en el directorio raíz del repositorio. - Déclencheur una nueva implementación.
"Permisos insuficientes para el acceso al entorno"
Cuando ocurre: Durante la creación del entorno o el acceso
Causa: Su cuenta de usuario carece de los permisos necesarios
Soluciones:
- Compruebe la función de usuario y los permisos
- Póngase en contacto con el administrador del sistema
- Compruebe que tiene permisos de administración del entorno
- Asegúrese de que tiene permisos de implementación
Errores de recursos y cuotas
"Se ha superado la cuota de entorno"
Cuando se produce: Durante la creación del entorno
Causa: Ha alcanzado el límite de entorno
Soluciones:
- Desactivar entornos no utilizados
- Limpieza de ramas e implementaciones antiguas
- Póngase en contacto con el servicio de asistencia para solicitar aumento de cuota
- Considere actualizar su plan
"Recursos insuficientes para la operación"
Cuando ocurre: Durante cualquier etapa
Causa: Su entorno carece de CPU, memoria o almacenamiento suficientes
Soluciones:
- Compruebe el uso de los recursos del entorno
- Libere recursos limpiando archivos
- Esperar a que los recursos estén disponibles
- Póngase en contacto con el servicio de asistencia si persisten problemas de recursos
Obtención de ayuda
Cuándo ponerse en contacto con el soporte técnico:
Póngase en contacto con el servicio de asistencia de Adobe Commerce Cloud cuando:
- Los mensajes de error no son claros o no tienen detalles suficientes
- Las operaciones de parche fallan constantemente
- Necesita ayuda con la resolución manual de conflictos
- Las comprobaciones de estado fallan, pero la causa no es evidente
- Necesita ayuda con los problemas de sincronización del entorno
Información que proporcionar:
Al ponerse en contacto con el servicio de asistencia, proporcione:
- ID de proyecto - Su identificador de proyecto de Adobe Commerce Cloud
- Id. de entorno - El entorno específico donde ocurrió el problema
- Id. de operación - Identificador de operación CAPS
- Detalles del error - Completar mensajes de error y registros
- Pasos para reproducir: lo que estaba haciendo cuando se produjo el error
- Intentos anteriores - Lo que ya ha intentado resolver el problema
Recursos adicionales
Para obtener información técnica más detallada:
- Revise los registros de errores completos proporcionados con las operaciones fallidas
- Consulte la documentación de Adobe Commerce para obtener instrucciones específicas sobre los parches
- Póngase en contacto con el servicio de asistencia técnica de Adobe Commerce Cloud para problemas específicos del entorno