Esta página proporciona el mapeo oficial de versiones entre los charts de Helm y las versiones de aplicaciones. Úsala como referencia antes de desplegar o actualizar tu entorno.
Fuente de verdad
La matriz de versiones oficial y más actualizada se mantiene en el README del repositorio de Helm. Esta matriz se actualiza automáticamente cada vez que las aplicaciones tienen un nuevo lanzamiento, asegurando que siempre refleje la información de compatibilidad más reciente.
Las tablas en esta página se proporcionan como referencia rápida, pero siempre verifica el repositorio de Helm para las versiones más actuales.
Siempre actualiza el chart de Helm al actualizar las aplicaciones. La versión del chart de Helm y las versiones de las aplicaciones están estrechamente acopladas. Actualizar una aplicación (como Midaz) sin actualizar su chart de Helm correspondiente puede causar fallos en el despliegue.Excepción: Algunos hotfixes pueden no requerir una actualización del chart de Helm. Consulta las notas de la versión para orientación específica.
Esquema de versionado
Lerian utiliza un esquema de versionado semántico con prefijo para los charts de Helm:
Ejemplos:
midaz-v4.4.8 - Chart de Helm de Midaz versión 4.4.8plugin-crm-v3.2.1 - Chart del plugin CRM versión 3.2.1plugin-crm-v3.2.1-rc.1 - Plugin CRM, versión preliminar (release candidate)
La versión del Chart se refiere a la versión del paquete del chart de Helm. La versión de la App se refiere a la versión real de la imagen del contenedor de la aplicación desplegada por el chart.
Midaz core
El chart de Helm principal de Midaz despliega servicios centrales. A partir de chart v5.x, un servicio unificado Ledger está disponible que combina la funcionalidad de Onboarding y Transaction.
| Versión del chart | Ledger | CRM | Onboarding | Transaction |
|---|
| 8.4.0 | 3.7.7 | 3.7.6 | - | - |
| 5.7.0 | 3.5.3 | 3.5.3 | 3.5.3 | 3.5.3 |
| 5.3.0 | 3.5.1 | 3.5.1 | 3.5.1 | 3.5.1 |
| 4.4.8 | - | - | 3.4.4 | 3.4.7 |
| 4.3.4 | - | - | 3.4.3 | 3.4.6 |
| 4.0.0 | - | - | 3.0.0 | 3.0.0 |
A partir de chart v5.x, el servicio Ledger es la opción de despliegue recomendada, combinando Onboarding y Transaction en un único servicio. El backend CRM también está incluido en el chart principal de Midaz (habilitado mediante crm.enabled: true). Consulta la guía de actualización de Helm para los pasos de migración.Para el historial completo de versiones, consulta las etiquetas del repositorio de Helm. Plugins
Los plugins se despliegan como charts de Helm separados con versionado independiente. Cada plugin requiere una licencia Enterprise válida.
CRM
El chart standalone plugin-crm incluye un componente UI y sigue siendo compatible con despliegues chart v4.x y v5.x.
| Versión del chart | Backend | UI | Compatibilidad con chart Helm |
|---|
| 4.0.0 | 3.5.1 | 2.0.0 | v4.x, v5.x |
| 3.2.1 | 2.0.0 | 2.0.0 | v3.x, v4.x |
| 3.1.0 | 2.0.0 | 2.0.0 | v3.x, v4.x |
Fees Engine
| Versión del chart | Backend | UI | Compatibilidad con chart Helm |
|---|
| 7.0.0 | 3.2.1 | 3.0.0 | - |
| 4.1.2 | 3.0.8 | 3.0.0 | v3.x, v4.x, v5.x |
| 3.5.1 | 3.0.5 | 3.0.0 | v3.x, v4.x, v5.x |
| 3.4.7 | 3.0.3 | 3.0.0 | v3.x, v4.x |
Fees Engine solo está disponible para Midaz v3 y posteriores. No es compatible con Midaz v2.
Pix
| Versión del chart | Pix | Job | Compatibilidad con chart Helm |
|---|
| 3.0.0 | 1.2.1-beta.11 | 1.2.1-beta.12 | - |
| 1.2.6 | 1.2.1-beta.11 | 1.2.1-beta.11 | v3.x, v4.x, v5.x |
Productos relacionados
Estos productos tienen sus propios charts de Helm y no son plugins de Midaz.
Reporter
Reporter es un producto independiente para generar informes a partir de datos de Midaz.
| Versión del chart | Manager | Worker |
|---|
| 3.1.1 | 2.1.2 | 2.1.2 |
| 2.0.0 | 1.1.1 | 1.1.1 |
| 1.1.7 | 4.0.0 | 4.0.0 |
Access Manager (servicio compartido)
Access Manager proporciona servicios de autenticación e identidad compartidos entre los productos de Lerian.
| Versión del chart | appVersion | Auth | Identity |
|---|
| 8.2.0 | - | 2.6.7 | 2.4.5 |
| 6.0.0 | 2.3.0 | 2.4.4 | 2.1.1 |
| 5.2.2 | - | 2.4.4 | 2.1.1 |
| 4.0.0 | - | 2.2.0 | 2.0.0 |
Product Console
Product Console proporciona la interfaz visual unificada para los productos de Lerian.
| Versión del chart | Console |
|---|
| 3.1.0 | 1.6.0 |
| 2.0.1 | 1.5.0 |
| 1.0.0 | 1.0.0 |
OTEL Collector Lerian
OpenTelemetry Collector configurado para el stack de observabilidad de Lerian.
| Versión del chart | OTEL |
|---|
| 4.1.0 | 0.142.0 |
| 2.2.1 | 2.1.0 |
Dependencias de infraestructura
La siguiente tabla lista los prerrequisitos de la plataforma y las versiones de los subcharts de infraestructura incluidos en el chart de Helm más reciente de Midaz. Kubernetes y el Helm CLI son versiones mínimas requeridas; las filas de bases de datos y broker corresponden a las versiones de los subcharts incluidos, no a mínimos para un servicio gestionado externo.
| Dependencia | Versión | Notas |
|---|
| Kubernetes | 1.20+ | Mínimo; 1.30+ recomendado |
| Helm CLI | 3.8+ | Mínimo; requerido para registro OCI |
| PostgreSQL | 16.3.5 | Versión del subchart incluido — base de datos principal |
| MongoDB | 16.4.0 | Versión del subchart incluido — almacenamiento de documentos |
| RabbitMQ | 2.1.11 | Versión del subchart incluido — broker de mensajes |
| Valkey | 2.4.7 | Versión del subchart incluido — caché en memoria (fork de Redis) |
| OTEL Collector | 2.2.1 | Versión del subchart incluido — opcional |
Reglas de compatibilidad de versiones
Sigue estas directrices para asegurar un despliegue estable:
- Actualiza Midaz Core primero — Siempre actualiza el chart de Helm principal de Midaz antes de actualizar cualquier plugin. Los plugins dependen de las APIs de Midaz Core.
- Verifica la compatibilidad de plugins — Antes de actualizar un plugin, verifica que sea compatible con tu versión actual de Midaz usando las tablas anteriores.
- Prueba en staging — Siempre prueba nuevas combinaciones de versiones en un entorno de staging antes de desplegar en producción.
- Revisa los cambios importantes — Consulta la guía de actualización de Helm para cambios importantes entre versiones mayores.
Repositorio de charts de Helm
Todos los charts de Helm de Lerian están disponibles desde el registro OCI:
Pix Indirect (BTG)
| Versión del chart | appVersion |
|---|
| 3.3.1 | 1.7.5 |
| 2.1.1 | 1.5.1 |
Bank Transfer
| Versión del chart | appVersion |
|---|
| 1.2.1 | 1.0.0 |
| 1.1.0 | 2.1.0 |
Fetcher
Fetcher es el servicio interno de extracción de datos de Lerian. Es necesario solo al ejecutar Reporter o Matcher en modo managed/multi-tenant (FETCHER_ENABLED=true); los despliegues self-hosted se conectan directamente a los datasources y no lo necesitan. Consulta Infraestructura vía Helm.
| Versión del chart | appVersion |
|---|
| 3.0.0 | 1.4.2 |
| 2.0.3 | 1.2.0 |
Flowker
| Versión del chart | appVersion |
|---|
| 3.0.0 | 1.0.0-beta.22 |
| 1.0.0 | 1.0.0 |
Tracer
| Versión del chart | appVersion |
|---|
| 2.1.0 | 1.0.0 |
| 1.0.0 | 1.0.0 |
