Saltar al contenido principal
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.
¿Buscas instrucciones de actualización? Consulta la guía de actualización de Helm para procedimientos paso a paso.

​
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}]
Ejemplos:
  • midaz-v5.3.0 - Chart de Helm de Midaz versión 5.3.0
  • plugin-crm-v4.0.0 - Chart del plugin CRM versión 4.0.0
  • plugin-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 v5.x, puedes elegir entre el servicio unificado Ledger (recomendado) o los servicios separados de Onboarding y Transaction (legacy).

​
Arquitectura Ledger (v5.x - Recomendado)

Versión del chartLedgerCRM
5.3.03.5.13.5.0
5.2.03.5.03.5.0
5.0.03.5.03.5.0

​
Arquitectura Legacy (v4.x y anteriores)

Versión del chartOnboardingTransaction
4.4.83.4.43.4.7
4.3.43.4.33.4.6
4.0.03.0.03.0.0
Los servicios Onboarding y Transaction se convertirán en legacy en una futura versión. Recomendamos migrar al servicio unificado Ledger. 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

A partir de Midaz v5.x, CRM está integrado en el chart de Helm principal de Midaz. La tabla a continuación es para despliegues legacy que usan el chart standalone.
Versión del chartBackendUICompatibilidad con Midaz
4.0.03.5.03.5.0v5.x
3.2.12.0.02.0.0v3.x, v4.x
3.1.02.0.02.0.0v3.x, v4.x
2.2.01.x1.xv2.x, v3.x

​
Fees Engine

Versión del chartBackendUICompatibilidad con Midaz
3.5.13.1.03.1.0v4.x, v5.x
3.4.73.0.33.0.0v3.x, v4.x
3.4.53.0.33.0.0v3.x, v4.x
Fees Engine solo está disponible para Midaz v3 y posteriores. No es compatible con Midaz v2.

​
Pix

Versión del chartPixJobCompatibilidad con Midaz
1.2.61.2.1-beta.71.2.1-beta.7v3.x, v4.x
1.3.0-beta.21.3.0-beta1.3.0-betav4.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 chartManagerWorkerUI
1.2.04.1.04.1.04.1.0
1.1.74.0.04.0.04.0.0
1.1.54.0.04.0.04.0.0

​
Access Manager (servicio compartido)

Access Manager proporciona servicios de autenticación e identidad compartidos entre los productos de Lerian.
Versión del chartAuthIdentity
4.1.02.3.02.1.0
4.0.02.2.02.0.0
3.2.02.1.01.x

​
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.
DependenciaVersión mínimaNotas
Kubernetes1.20+1.30+ recomendado
Helm CLI3.8+Requerido para registro OCI
PostgreSQL16.3Base de datos principal
MongoDB16.4.0Almacenamiento de documentos
RabbitMQ2.1.11Broker de mensajes (Groundhog2k)
Valkey2.4.7Caché en memoria (fork de Redis)
OTEL Collector2.2.1Opcional, 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
oci://registry-1.docker.io/lerianstudio/plugin-br-pix-direct-jd
oci://registry-1.docker.io/lerianstudio/reporter
oci://registry-1.docker.io/lerianstudio/plugin-access-manager
Para el código fuente y documentación detallada de los charts, visita el repositorio de GitHub.