> ## 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.
# Actualización de documentación de Helm v5.x
> La documentación de despliegue de Helm ahora coincide con Midaz Helm Chart v5.x, con el servicio Ledger unificado, CRM integrado, cambios de dependencias y guías de migración.
21 de enero de 2026 Actualización de documentación Acción requerida
## Afecta
***
Equipos que despliegan o actualizan Midaz con Helm, especialmente los que migran a Helm Chart v5.x.
Esta actualización aplica al portal público de documentación. No cambia el comportamiento de la API en tiempo de ejecución a menos que la documentación del producto enlazada indique lo contrario.
## Qué cambió
***
Hemos renovado por completo la documentación de despliegue de Helm para reflejar los últimos cambios en **Midaz Helm Chart v5.x**. Esta actualización introduce una nueva arquitectura unificada, servicios integrados y guías de migración completas.
### Cambios principales en Helm v5.x
***
### Nuevo servicio Ledger (cambio principal)
El cambio más significativo en v5.x es la introducción del **servicio Ledger unificado**, que combina la funcionalidad de los módulos separados `onboarding` y `transaction` en un único despliegue.
* **Servicio único**: un despliegue en lugar de dos servicios separados
* **Configuración unificada**: variables de entorno unificadas con prefijos específicos por módulo
* **Enrutamiento de ingress automático**: las configuraciones de DNS existentes siguen funcionando sin interrupciones
* **Nuevo Balance Sync Worker**: procesamiento en segundo plano para la sincronización de saldos
Los servicios separados de Onboarding y Transaction ahora son **legacy** y quedarán obsoletos en una versión futura. Recomendamos planificar la migración al servicio Ledger unificado.
### CRM integrado en el chart principal
El **plugin CRM** ahora está integrado directamente en el chart principal de Midaz Helm:
* Antes se desplegaba como un chart separado (`plugin-crm`) en el namespace `midaz-plugins`
* Ahora está disponible como un componente opcional en el namespace `midaz`
* Despliegue y configuración unificados
* Conexión MongoDB compartida con otros servicios de Midaz
### Console eliminado
El componente **Console** se eliminó del chart de Helm como parte de la migración a **Lerian Console**. Para la gestión basada en web, consulta la [documentación de Lerian Console](/es/midaz/about-midaz-console).
### Cambios de dependencias
* **RabbitMQ**: migrado de Bitnami al chart Groundhog2k (desde v4.x)
* **Erlang Cookie**: ahora requiere configuración explícita para RabbitMQ
* **Imágenes BitnamiSecure**: PostgreSQL, MongoDB y Valkey ahora usan imágenes hardened
### Nuevas variables de entorno
El servicio Ledger introduce prefijos específicos por módulo para la configuración de la base de datos:
| Variable antigua (Legacy) | Nueva variable (Ledger) |
| :------------------------ | :-------------------------------------------------------- |
| `DB_PASSWORD` | `DB_ONBOARDING_PASSWORD`, `DB_TRANSACTION_PASSWORD` |
| `MONGO_PASSWORD` | `MONGO_ONBOARDING_PASSWORD`, `MONGO_TRANSACTION_PASSWORD` |
### Actualizaciones de documentación
\--
Hemos reestructurado y ampliado la sección de documentación de Helm:
### Nuevas páginas
* [**Helm Overview**](/es/platform/helm/helm-overview): hub central para toda la documentación relacionada con Helm
* [**Upgrading Helm**](/es/platform/helm/midaz/midaz-upgrade-guide): guía completa de migración que cubre las transiciones v3.x → v4.x → v5.x con cambios incompatibles y procedimientos de rollback
### Páginas actualizadas
* [**Using Helm**](/es/platform/helm/midaz/midaz-installation): reescrita por completo para incluir:
* Configuración del servicio Ledger (recomendada)
* Configuración legacy de Onboarding/Transaction
* Configuración de integración de CRM
* Bootstrap jobs para PostgreSQL y RabbitMQ externos
* Tablas detalladas de parámetros para todos los servicios
* [**Upgrading Midaz and plugins via Helm**](/es/platform/helm/midaz/midaz-upgrade-guide): actualizada con:
* Soporte para arquitectura Ledger (v5.x)
* Pestañas para comandos Ledger vs Legacy
* Números de versión actualizados
* [**Version Compatibility**](/es/platform/helm/helm-version-compatibility): actualizada con:
* Nueva tabla de compatibilidad de arquitectura Ledger
* Versiones de integración de CRM
* Versiones de plugin actualizadas
* [**Deployment Strategies Overview**](/es/midaz/deployment): actualizada para reflejar la nueva estructura de Helm
### Compatibilidad de versiones
***
| Versión Helm Chart | Ledger | CRM | Recomendada |
| :----------------- | :----- | :---- | :---------- |
| 5.3.0 | 3.5.1 | 3.5.0 | Sí |
| 5.2.0 | 3.5.0 | 3.5.0 | Sí |
| 5.0.0 | 3.5.0 | 3.5.0 | Sí |
### Rutas de migración
***
Proporcionamos guías de migración detalladas para todos los escenarios de actualización:
* **v4.x → v5.x**: habilitar el servicio Ledger, migrar secretos a prefijos específicos por módulo
* **v3.x → v4.x**: configurar Erlang cookie para RabbitMQ, hacer backup de datos PVC
* **v3.x → v5.x**: migración combinada que aborda ambos conjuntos de cambios incompatibles
### Recursos relacionados
***
* [Helm Overview](/es/platform/helm/helm-overview)
* [Using Helm](/es/platform/helm/midaz/midaz-installation)
* [Upgrading Helm](/es/platform/helm/midaz/midaz-upgrade-guide)
* [Version Compatibility](/es/platform/helm/helm-version-compatibility)
* [Helm Repository](https://github.com/LerianStudio/helm)
## Impacto
***
Esta actualización de documentación incluye información que los equipos deben revisar antes de cambiar la integración o el despliegue afectados.
## Qué necesitas hacer
***
Revisa la guía de migración de Helm v5.x antes de tu próximo despliegue o actualización de Midaz.
Planifica la migración al servicio Ledger unificado y al modelo de despliegue de CRM actualizado cuando corresponda.
### Plazo
Antes de tu próxima integración, despliegue o cambio de actualización relacionado.
### Por qué
Helm v5.x cambia la arquitectura de despliegue documentada y la ruta de migración. Los equipos que operan Midaz con Helm necesitan las indicaciones actualizadas antes de cambiar entornos.