> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Compatibilidad de versiones de charts de Helm

> Tabla de referencia que mapea versiones de charts de Helm a versiones de aplicaciones para Midaz, plugins y productos relacionados.

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.

<Tip>
  ¿Buscas instrucciones de actualización? Consulta la [guía de actualización de Helm](/es/platform/helm/midaz/midaz-upgrade-guide) para procedimientos paso a paso.
</Tip>

## Fuente de verdad

***

La **matriz de versiones oficial y más actualizada** se mantiene en el [README del repositorio de Helm](https://github.com/LerianStudio/helm?tab=readme-ov-file#lerian-studio-helm-charts). 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.

<Warning>
  **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.
</Warning>

## 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-crm-v3.2.1-rc.1` - Plugin CRM, versión preliminar (release candidate)

<Note>
  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.
</Note>

## 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       |

<Note>
  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](/es/platform/helm/midaz/midaz-upgrade-guide) para los pasos de migración.

  Para el historial completo de versiones, consulta las [etiquetas del repositorio de Helm](https://github.com/LerianStudio/helm/tags).
</Note>

## Plugins

***

Los plugins se despliegan como **charts de Helm separados** con versionado independiente. Cada plugin requiere una licencia Enterprise válida.

### CRM

<Note>
  El chart standalone plugin-crm incluye un componente UI y sigue siendo compatible con despliegues chart v4.x y v5.x.
</Note>

| 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                    |

<Warning>
  Fees Engine solo está disponible para Midaz v3 y posteriores. No es compatible con Midaz v2.
</Warning>

### 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](/es/platform/helm/midaz/midaz-upgrade-guide) 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:

```bash theme={null}
# 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
```

### 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](/es/platform/helm/infrastructure/infrastructure-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      |

<Tip>
  Para el código fuente y documentación detallada de los charts, visita el [repositorio de GitHub](https://github.com/LerianStudio/helm).
</Tip>