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:
{componente}-v{MAYOR}.{MENOR}.{PARCHE}[-{prelanzamiento}]
midaz-v5.3.0 - Chart de Helm de Midaz versión 5.3.0plugin-crm-v4.0.0 - Chart del plugin CRM versión 4.0.0plugin-br-pix-direct-jd-v1.3.0-beta.1 - Lanzamiento beta del plugin Pix
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 |
|---|
| 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.0 | 3.5.0 | 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 |
| 2.2.0 | 1.x | 1.x | v2.x, v3.x |
Fees Engine
| Versión del chart | Backend | UI | Compatibilidad con chart Helm |
|---|
| 4.1.2 | 3.0.8 | 3.0.0 | v3.x, v4.x, v5.x |
| 3.5.1 | 3.1.0 | 3.1.0 | v4.x, v5.x |
| 3.4.7 | 3.0.3 | 3.0.0 | v3.x, v4.x |
| 3.4.5 | 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 |
|---|
| 1.2.6 | 1.2.1-beta.11 | 1.2.1-beta.11 | v3.x, v4.x, v5.x |
| 1.3.0-beta.2 | 1.3.0-beta | 1.3.0-beta | v4.x, v5.x |
El plugin Pix aún está en desarrollo.
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 |
|---|
| 2.0.0 | 1.1.1 | 1.1.1 |
| 1.2.0 | 4.1.0 | 4.1.0 |
| 1.1.7 | 4.0.0 | 4.0.0 |
| 1.1.5 | 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 |
|---|
| 6.0.0 | 2.3.0 | 2.4.4 | 2.1.1 |
| 4.1.0 | - | 2.3.0 | 2.1.0 |
| 4.0.0 | - | 2.2.0 | 2.0.0 |
| 3.2.0 | - | 2.1.0 | 1.x |
Product Console
Product Console proporciona la interfaz visual unificada para los productos de Lerian.
| Versión del chart | Console |
|---|
| 2.0.1 | 1.5.0 |
| 1.0.0 | 1.0.0 |
Dependencias de infraestructura
La siguiente tabla lista las versiones mínimas requeridas para los componentes de infraestructura al usar el chart de Helm más reciente de Midaz.
| Dependencia | Versión mínima | Notas |
|---|
| Kubernetes | 1.20+ | 1.30+ recomendado |
| Helm CLI | 3.8+ | Requerido para registro OCI |
| PostgreSQL | 16.3 | Base de datos principal |
| MongoDB | 16.4.0 | Almacenamiento de documentos |
| RabbitMQ | 2.1.11 | Broker de mensajes (Groundhog2k) |
| Valkey | 2.4.7 | Caché en memoria (fork de Redis) |
| OTEL Collector | 2.2.1 | Opcional, para observabilidad |
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:
# Midaz Core
oci://registry-1.docker.io/lerianstudio/midaz-helm
# Plugins y otros productos
oci://registry-1.docker.io/lerianstudio/plugin-crm
oci://registry-1.docker.io/lerianstudio/plugin-fees-helm
oci://registry-1.docker.io/lerianstudio/plugin-br-pix-direct-jd
oci://registry-1.docker.io/lerianstudio/plugin-br-pix-indirect-btg-helm
oci://registry-1.docker.io/lerianstudio/plugin-br-bank-transfer-helm
oci://registry-1.docker.io/lerianstudio/reporter
oci://registry-1.docker.io/lerianstudio/plugin-access-manager
oci://registry-1.docker.io/lerianstudio/fetcher-helm
oci://registry-1.docker.io/lerianstudio/flowker-helm
oci://registry-1.docker.io/lerianstudio/tracer-helm
oci://registry-1.docker.io/lerianstudio/underwriter-helm
Pix Indirect (BTG)
| Versión del chart | appVersion |
|---|
| 2.1.1 | 1.5.1 |
Bank Transfer
| Versión del chart | appVersion |
|---|
| 1.1.0 | 2.1.0 |
Fetcher
| Versión del chart | appVersion |
|---|
| 2.0.3 | 1.2.0 |
Flowker
| Versión del chart | appVersion |
|---|
| 1.0.0 | 1.0.0 |
Tracer
| Versión del chart | appVersion |
|---|
| 1.0.0 | 1.0.0 |
Underwriter
| Versión del chart | appVersion |
|---|
| 1.0.1 | 1.0.0 |
