Afecta a
Equipos que despliegan o actualizan Midaz con Helm, en especial los que pasan a Helm Chart v5.x. Esta actualización aplica al portal público de documentación. No cambia el comportamiento de la API en runtime, a menos que la documentación de producto enlazada indique lo contrario.
Qué cambió
Rehicimos por completo la documentación de despliegue de Helm para reflejar los últimos cambios en Midaz Helm Chart v5.x. Esta actualización presenta una nueva arquitectura unificada, servicios integrados y guías de migración completas.
Cambios importantes 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ódulosonboarding y transaction separados en un único 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 de ingress automático: las configuraciones de DNS existentes siguen funcionando de forma transparente
- Nuevo Balance Sync Worker: procesamiento en segundo plano para la sincronización de saldos
CRM integrado en el chart principal
El plugin de CRM ahora está integrado directamente en el Helm chart principal de Midaz:- Antes se desplegaba como un chart separado (
plugin-crm) en el namespacemidaz-plugins - Ahora está disponible como componente opcional en el namespace
midaz - Despliegue y configuración simplificados
- Conexión de MongoDB compartida con otros servicios de Midaz
Console eliminado
El componente Console fue eliminado del Helm chart como parte de la migración a Lerian Console. Para la gestión web, consulta la documentación de Lerian Console.Cambios de dependencias
- RabbitMQ: migrado del chart de Bitnami al de 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 endurecidas
Nuevas variables de entorno
El servicio Ledger presenta prefijos específicos por módulo para la configuración de la base de datos:Actualizaciones de la documentación
— Reestructuramos y ampliamos la sección de documentación de Helm:Páginas nuevas
- Resumen de Helm: hub central de toda la documentación relacionada con Helm
- Actualizar Helm: guía de migración completa que cubre las transiciones v3.x → v4.x → v5.x con cambios incompatibles y procedimientos de rollback
Páginas actualizadas
- Usar Helm: reescrita por completo para incluir:
- Configuración del servicio Ledger (recomendada)
- Configuración legacy de Onboarding/Transaction
- Configuración de la integración de CRM
- Jobs de bootstrap para PostgreSQL y RabbitMQ externos
- Tablas de parámetros detalladas para todos los servicios
- Actualizar Midaz y plugins con Helm: actualizada con:
- Compatibilidad con la arquitectura Ledger (v5.x)
- Pestañas para los comandos de Ledger frente a Legacy
- Números de versión actualizados
- Compatibilidad de versiones: actualizada con:
- Nueva tabla de compatibilidad de la arquitectura Ledger
- Versiones de la integración de CRM
- Versiones de plugins actualizadas
- Resumen de estrategias de despliegue: actualizada para reflejar la nueva estructura de Helm
Compatibilidad de versiones
Rutas de migración
Proporcionamos guías de migración detalladas para todos los escenarios de actualización:
- v4.x → v5.x: habilita el servicio Ledger, migra los secretos a prefijos específicos por módulo
- v3.x → v4.x: configura la Erlang cookie para RabbitMQ, respalda los datos del PVC
- v3.x → v5.x: migración combinada que resuelve ambos conjuntos de cambios incompatibles
Recursos relacionados
Impacto
Esta actualización de documentación incluye información que se recomienda que los equipos revisen antes de cambiar la integración o el despliegue afectados.
Qué debes hacer
1
Revisa la orientación de migración a Helm v5.x antes de tu próximo despliegue o actualización de Midaz.
2
Planifica el cambio al servicio Ledger unificado y al modelo actualizado de despliegue de CRM cuando aplique.