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

# Checklist de actualización de Midaz con Helm

> Sigue las mejores prácticas recomendadas y los pasos de verificación antes, durante y después de una actualización de Midaz con Helm para tener despliegues a producción seguros y predecibles.

<Warning>
  La orientación sobre CRM y Fees marcada como legacy en esta página se aplica solo a los releases legacy que ya existen. Midaz v4 despliega el Ledger unificado y sirve CRM y Fees en `/v2`.
</Warning>

El repositorio de Helm conserva una carga de trabajo `crm.enabled` y el chart `plugin-fees-helm` para releases de aplicación anteriores. Son superficies de compatibilidad legacy, no el modelo de despliegue de Midaz v4.

## Recomendación para producción

***

No recomendamos usar las dependencias predeterminadas del Helm chart de Midaz (bases de datos, cache y broker de mensajes) en entornos de producción. Para despliegues de nivel productivo, sigue nuestras [mejores prácticas](/es/products/midaz/midaz-production-best-practices) para operar estas dependencias con la seguridad, la observabilidad, los backups, la recuperación ante desastres y los SLOs adecuados.

## Mejores prácticas

***

### Orden de actualización

Actualiza siempre en este orden:

1. Infraestructura (si hace falta)
2. Midaz Core
3. Plugins (uno a la vez)

### Prueba primero

Prueba siempre las actualizaciones en un entorno de staging que refleje producción antes de aplicarlas en producción.

### Monitorea de cerca

Monitorea de cerca los logs y las métricas durante los primeros 15-30 minutos después de una actualización.

### Mantén backups

Mantén backups de tus values de Helm y de la base de datos antes de actualizaciones mayores.

## Resumen del checklist de actualización

***

| Paso                              | Comando                                                                                              | Verificado |
| :-------------------------------- | :--------------------------------------------------------------------------------------------------- | :--------: |
| Respaldar las bases de datos      | Toma un snapshot de PostgreSQL y MongoDB. `helm rollback` no puede deshacer migraciones de esquema   |            |
| Respaldar los values              | `helm get values <release> -n midaz > backup.yaml`                                                   |            |
| Revisar los metadatos del chart   | Consulta los [metadatos actuales del chart de Midaz](/es/platform/deploy/helm-version-compatibility) |            |
| Actualizar Midaz                  | `helm upgrade midaz ...`                                                                             |            |
| Verificar los pods de Midaz       | `kubectl get pods -n midaz`                                                                          |            |
| Actualizar los plugins            | `helm upgrade <plugin> ...`                                                                          |            |
| Verificar los pods de los plugins | `kubectl get pods -n midaz`                                                                          |            |
| Revisar los logs                  | `kubectl logs -n midaz deployment/<name>`                                                            |            |

## Verificación posterior a la actualización

***

### 1. Revisa el estado de los pods

<CodeGroup>
  ```bash Shell theme={null}
  kubectl get pods -n midaz
  ```
</CodeGroup>

Todos los pods deberían estar en `Running` y `READY`.

### 2. Verifica los servicios

<CodeGroup>
  ```bash Shell theme={null}
  kubectl get svc -n midaz
  ```
</CodeGroup>

### 3. Revisa los logs

<CodeGroup>
  ```bash Shell theme={null}
  # The ledger service (the only application Deployment by default)
  kubectl logs -n midaz deployment/midaz-ledger

  # RabbitMQ
  kubectl logs -n midaz statefulset/midaz-rabbitmq

  # CRM workload: run only when crm.enabled is true
  kubectl logs -n midaz deployment/midaz-crm
  ```
</CodeGroup>

<Note>
  En charts anteriores a v7.0.0 también tenías Deployments `midaz-onboarding` y `midaz-transaction`. Esos servicios se eliminaron en v7.0.0. En cualquier chart actual esos nombres devuelven `NotFound`.
</Note>

### 4. Verifica el enrutamiento del ingress

<CodeGroup>
  ```bash Shell theme={null}
  kubectl get ingress -n midaz
  kubectl describe ingress midaz-ledger -n midaz
  ```
</CodeGroup>