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-v4.4.8 - Chart de Helm de Midaz versión 4.4.8
  • plugin-crm-v3.2.1 - Chart del plugin CRM versión 3.2.1
  • 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 tres servicios centrales: Console, Onboarding y Transaction.
Versión del chartConsoleOnboardingTransaction
4.4.83.4.63.4.43.4.7
4.3.43.4.53.4.33.4.6
4.0.03.0.03.0.03.0.0
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

Versión del chartBackendUICompatibilidad con Midaz
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.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
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.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.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
Valkey2.4.7Caché en memoria (fork de Redis)
OTEL Collector2.1.0Opcional, 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 a Helm v3 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.