Hemos renovado completamente la documentación de despliegue con 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 unificado Ledger, que combina la funcionalidad de los módulos separadosonboarding y transaction en un solo despliegue.- Servicio único: Un despliegue en lugar de dos servicios separados
- Configuración simplificada: Variables de entorno unificadas con prefijos específicos por módulo
- Enrutamiento automático de ingress: Las configuraciones DNS existentes continúan funcionando sin problemas
- Nuevo Balance Sync Worker: Procesamiento en segundo plano para sincronización de saldos
CRM Integrado en el Chart Principal
El plugin CRM ahora está integrado directamente en el chart de Helm principal de Midaz:- Anteriormente se desplegaba como un chart separado (
plugin-crm) en el namespacemidaz-plugins - Ahora disponible como componente opcional en el namespace
midaz - Despliegue y configuración simplificados
- Conexión compartida de MongoDB con otros servicios de Midaz
Console Removido
El componente Console ha sido eliminado del chart de Helm como parte de la migración a Lerian Console. Para gestión basada en web, consulta la documentación de Lerian Console.Cambios de Dependencias
- RabbitMQ: Migrado de Bitnami a chart de Groundhog2k (desde v4.x)
- Cookie de Erlang: Ahora requiere configuración explícita para RabbitMQ
- Imágenes BitnamiSecure: PostgreSQL, MongoDB y Valkey ahora usan imágenes endurecidas
Nuevas Variables de Entorno
El servicio Ledger introduce prefijos específicos por módulo para la configuración de 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:Páginas Nuevas
- Resumen de Helm: Centro principal para toda la documentación relacionada con Helm
- Actualización de Helm: Guía de migración completa que cubre las transiciones v3.x → v4.x → v5.x con cambios importantes y procedimientos de reversión
Páginas Actualizadas
-
Usando Helm: Completamente reescrita para incluir:
- Configuración del servicio Ledger (recomendado)
- Configuración legacy de Onboarding/Transaction
- Configuración de integración de CRM
- Jobs de bootstrap para PostgreSQL y RabbitMQ externos
- Tablas detalladas de parámetros para todos los servicios
-
Actualización de Midaz y plugins mediante Helm: Actualizada con:
- Soporte para arquitectura Ledger (v5.x)
- Tabs para comandos Ledger vs Legacy
- Números de versión actualizados
-
Compatibilidad de Versiones: Actualizada con:
- Nueva tabla de compatibilidad de arquitectura Ledger
- Versiones de integración de CRM
- Versiones actualizadas de plugins
- Resumen de Estrategias de Despliegue: Actualizado para reflejar la nueva estructura de Helm
Compatibilidad de Versiones
| Versión del Chart | Ledger | CRM | Recomendado |
|---|---|---|---|
| 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 servicio Ledger, migrar secretos a prefijos específicos por módulo
- v3.x → v4.x: Configurar cookie de Erlang para RabbitMQ, respaldar datos de PVC
- v3.x → v5.x: Migración combinada que aborda ambos conjuntos de cambios importantes