Saltar al contenido principal

​
Procedimientos de reversión

Si algo sale mal después de una actualización, puedes revertir a una versión anterior.

​
Cuándo revertir

Considera revertir si observas:
  • Pods que no inician o están en bucle de reinicio
  • Errores de API o indisponibilidad del servicio
  • Inconsistencias de datos
  • Degradación del rendimiento

​
Verificar historial de releases

Visualiza el historial de revisiones de un release: 
helm history midaz -n midaz
Ejemplo de salida: 
REVISION  STATUS      CHART           APP VERSION  DESCRIPTION
1         superseded  midaz-4.4.8     3.4.7        Install complete
2         deployed    midaz-5.7.0     3.5.3        Upgrade complete

​
Ejecutar reversión

Revierte a una revisión específica:
  • Revertir Midaz a la revisión anterior
helm rollback midaz 1 -n midaz
  • Revertir plugin (ejemplo: CRM)
helm rollback plugin-crm 1 -n midaz

​
Verificar reversión

  • Verificar versión del release
helm list -n midaz
  • Verificar pods
kubectl get pods -n midaz
  • Revisar logs
kubectl logs -n midaz deployment/midaz-ledger --tail=50
Las reversiones pueden no revertir los cambios del esquema de base de datos. Si la actualización incluyó migraciones de base de datos, puede que necesites restaurar desde un respaldo de base de datos.

​
Solución de problemas

​
Pods atascados en estado Pending

Síntoma: Los pods permanecen en estado Pending después de la actualización. Solución: Verifica restricciones de recursos:
  • Describir pod pendiente
kubectl describe pod <pod-name> -n midaz
  • Verificar recursos de nodos
kubectl top nodes

​
Errores de descarga de imagen

Síntoma: Los pods muestran ImagePullBackOff o ErrImagePull. Solución: Verifica el acceso al registro de imágenes y las credenciales:
  • Verificar eventos del pod
kubectl describe pod <pod-name> -n midaz | grep -A 10 Events
  • Verificar que la imagen existe
docker pull lerianstudio/midaz-ledger:3.5.3

​
Errores de configuración

Síntoma: Los pods fallan con errores relacionados con la configuración en los logs. Solución: Compara tus valores con los valores por defecto del nuevo chart:
  • Ver valores actuales
helm get values midaz -n midaz
  • Ver valores por defecto del chart
helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.7.0

​
Problemas de conexión a base de datos

Síntoma: Los servicios no pueden conectarse a PostgreSQL o MongoDB. Solución: Verifica la conectividad y credenciales de la base de datos:
  • Verificar pods de base de datos
kubectl get pods -n midaz -l app.kubernetes.io/name=postgresql
kubectl get pods -n midaz -l app.kubernetes.io/name=mongodb
  • Verificar logs del servicio
kubectl logs -n midaz deployment/midaz-ledger | grep -i database

​
Procedimiento general de reversión

Si encuentras problemas después de cualquier actualización: 
# Listar historial de releases
helm history midaz -n midaz

# Revertir a la versión anterior
helm rollback midaz <REVISION> -n midaz

# Verificar reversión
helm list -n midaz
kubectl get pods -n midaz

​
Recursos relacionados