Rollback y solución de problemas

​

Procedimientos de reversión

​

Cuándo revertir

• 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

helm history midaz -n midaz

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

• 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

kubectl logs -n midaz deployment/midaz-onboarding --tail=50

​

Solución de problemas

​

Pods atascados en estado Pending

• Describir pod pendiente

kubectl describe pod <pod-name> -n midaz

• Verificar recursos de nodos

kubectl top nodes

​

Errores de descarga de imagen

• 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

• 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

• 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

kubectl logs -n midaz deployment/midaz-onboarding | grep -i database

​

Procedimiento general de reversió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

• Instalar Midaz con Helm - Guía de instalación inicial
• Compatibilidad de versiones - Referencia de mapeo de versiones
• Repositorio de Helm - Código fuente y notas de versión