> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Rollback y solución de problemas

> Revierte una actualización Helm fallida de Midaz y resuelve problemas posteriores — caídas de pods, errores de esquema e integraciones rotas.

## 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:

```bash theme={null}
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**

```bash theme={null}
helm rollback midaz 1 -n midaz
```

* **Revertir plugin (ejemplo: CRM)**

```bash theme={null}
helm rollback plugin-crm 1 -n midaz
```

### Verificar reversión

* **Verificar versión del release**

```bash theme={null}
helm list -n midaz
```

* **Verificar pods**

```bash theme={null}
kubectl get pods -n midaz
```

* **Revisar logs**

<Tabs>
  <Tab title="Ledger (v5.x)">
    ```bash theme={null}
    kubectl logs -n midaz deployment/midaz-ledger --tail=50
    ```
  </Tab>

  <Tab title="Legacy (v4.x)">
    ```bash theme={null}
    kubectl logs -n midaz deployment/midaz-onboarding --tail=50
    ```
  </Tab>
</Tabs>

<Danger>
  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.
</Danger>

## 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**

```bash theme={null}
kubectl describe pod <pod-name> -n midaz
```

* **Verificar recursos de nodos**

```bash theme={null}
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**

```bash theme={null}
kubectl describe pod <pod-name> -n midaz | grep -A 10 Events
```

* **Verificar que la imagen existe**

```bash theme={null}
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**

```bash theme={null}
helm get values midaz -n midaz
```

* **Ver valores por defecto del chart**

```bash theme={null}
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**

```bash theme={null}
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**

<Tabs>
  <Tab title="Ledger (v5.x)">
    ```bash theme={null}
    kubectl logs -n midaz deployment/midaz-ledger | grep -i database
    ```
  </Tab>

  <Tab title="Legacy (v4.x)">
    ```bash theme={null}
    kubectl logs -n midaz deployment/midaz-onboarding | grep -i database
    ```
  </Tab>
</Tabs>

## Procedimiento general de reversión

***

Si encuentras problemas después de cualquier actualización:

<CodeGroup>
  ```bash Shell theme={null}
  # 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
  ```
</CodeGroup>

## Recursos relacionados

***

* [Instalar Midaz con Helm](/es/platform/helm/midaz/midaz-installation) - Guía de instalación inicial
* [Compatibilidad de versiones](/es/platform/helm/helm-version-compatibility) - Referencia de mapeo de versiones
* [Repositorio de Helm](https://github.com/LerianStudio/helm) - Código fuente y notas de versión