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

# Compatibilidade de versões do Helm chart

> Tabela de referência mapeando versões do Helm chart para versões de aplicação do Midaz, plugins e produtos relacionados.

Esta página fornece o mapeamento oficial de versões entre versões do Helm chart e versões de aplicação. Use-a como referência antes de fazer deploy ou atualizar seu ambiente.

<Tip>
  Procurando instruções de atualização? Confira o [guia de atualização do Helm](/pt/platform/helm/midaz/midaz-upgrade-guide) para procedimentos passo a passo.
</Tip>

## Fonte da verdade

***

A **matriz de versões oficial e mais atualizada** é mantida no [README do repositório Helm](https://github.com/LerianStudio/helm?tab=readme-ov-file#lerian-studio-helm-charts). Esta matriz é **atualizada automaticamente** sempre que as aplicações têm um novo release, garantindo que sempre reflita as informações de compatibilidade mais recentes.

As tabelas nesta página são fornecidas para referência rápida, mas sempre verifique o repositório Helm para as versões mais atuais.

<Warning>
  **Sempre atualize o Helm chart ao atualizar aplicações.** A versão do Helm chart e as versões das aplicações são fortemente acopladas. Atualizar uma aplicação (como o Midaz) sem atualizar o Helm chart correspondente pode causar falhas no deployment.

  **Exceção:** Alguns hotfixes podem não exigir uma atualização do Helm chart. Verifique as notas de release para orientações específicas.
</Warning>

## Esquema de versionamento

***

A Lerian usa um esquema de **versionamento semântico com prefixo** para Helm charts:

```
{component}-v{MAJOR}.{MINOR}.{PATCH}[-{prerelease}]
```

**Exemplos:**

* `midaz-v4.4.8` - Helm chart do Midaz versão 4.4.8
* `plugin-crm-v3.2.1` - Chart do plugin CRM versão 3.2.1
* `plugin-crm-v3.2.1-rc.1` - Plugin CRM, prerelease (release candidate)

<Note>
  A **versão do Chart** refere-se à versão do pacote do Helm chart. A **versão do App** refere-se à versão real da imagem de container da aplicação implantada pelo chart.
</Note>

## Midaz core

***

O Helm chart principal do Midaz faz o deploy dos serviços core. A partir do chart v5.x, um serviço unificado **Ledger** está disponível que combina a funcionalidade de Onboarding e Transaction.

| Versão do 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 do chart v5.x, o serviço **Ledger** é a opção de deployment recomendada, combinando Onboarding e Transaction em um único serviço. O backend do CRM também está incluído no chart principal do Midaz (habilitado via `crm.enabled: true`). Veja o guia [Atualizando o Helm](/pt/platform/helm/midaz/midaz-upgrade-guide) para detalhes de migração.

  Para o histórico completo de versões, confira as [tags do repositório Helm](https://github.com/LerianStudio/helm/tags).
</Note>

## Plugins

***

Plugins são implantados como **Helm charts separados** com versionamento independente. Cada plugin requer uma licença Enterprise válida.

### CRM

<Note>
  O chart standalone plugin-crm inclui um componente de UI e permanece compatível com deployments chart v4.x e v5.x.
</Note>

| Versão do Chart | Backend | UI    | Compatibilidade com 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

| Versão do Chart | Backend | UI    | Compatibilidade com 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>
  O Fees Engine está disponível apenas para o Midaz v3 e posterior. Não é compatível com o Midaz v2.
</Warning>

### Pix

| Versão do Chart | Pix           | Job           | Compatibilidade com 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               |

## Produtos relacionados

***

Estes produtos possuem seus próprios Helm charts e não são plugins do Midaz.

### Reporter

O Reporter é um produto standalone para gerar relatórios a partir dos dados do Midaz.

| Versão do 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 (serviço compartilhado)

O Access Manager fornece serviços de autenticação e identidade compartilhados entre os produtos da Lerian.

| Versão do 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

O Product Console fornece a interface visual unificada para os produtos da Lerian.

| Versão do 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 a stack de observabilidade da Lerian.

| Versão do Chart | OTEL    |
| :-------------- | :------ |
| 4.1.0           | 0.142.0 |
| 2.2.1           | 2.1.0   |

## Dependências de infraestrutura

***

A tabela a seguir lista os pré-requisitos da plataforma e as versões dos subcharts de infraestrutura incluídos no Helm chart mais recente do Midaz. Kubernetes e o Helm CLI são versões mínimas necessárias; as linhas de bancos de dados e broker correspondem às versões dos subcharts incluídos, não a mínimos para um serviço gerenciado externo.

| Dependência    | Versão | Observações                                                    |
| :------------- | :----- | :------------------------------------------------------------- |
| Kubernetes     | 1.20+  | Mínimo; 1.30+ recomendado                                      |
| Helm CLI       | 3.8+   | Mínimo; necessário para registro OCI                           |
| PostgreSQL     | 16.3.5 | Versão do subchart incluído — banco de dados principal         |
| MongoDB        | 16.4.0 | Versão do subchart incluído — armazenamento de documentos      |
| RabbitMQ       | 2.1.11 | Versão do subchart incluído — broker de mensagens              |
| Valkey         | 2.4.7  | Versão do subchart incluído — cache em memória (fork do Redis) |
| OTEL Collector | 2.2.1  | Versão do subchart incluído — opcional                         |

## Regras de compatibilidade de versões

***

Siga estas diretrizes para garantir um deployment estável:

* **Atualize o Midaz Core primeiro** -- Sempre atualize o Helm chart principal do Midaz antes de atualizar qualquer plugin. Os plugins dependem das APIs do Midaz Core.
* **Verifique a compatibilidade dos plugins** -- Antes de atualizar um plugin, verifique se ele é compatível com sua versão atual do Midaz usando as tabelas acima.
* **Teste em staging** -- Sempre teste novas combinações de versões em um ambiente de staging antes de fazer deploy em produção.
* **Revise as breaking changes** -- Confira o guia [Atualizando o Helm](/pt/platform/helm/midaz/midaz-upgrade-guide) para breaking changes entre versões major.

## Repositório do Helm chart

***

Todos os Helm charts da Lerian estão disponíveis no registro OCI:

```bash theme={null}
# Midaz Core
oci://registry-1.docker.io/lerianstudio/midaz-helm

# Plugins and other products
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)

| Versão do Chart | appVersion |
| :-------------- | :--------- |
| 3.3.1           | 1.7.5      |
| 2.1.1           | 1.5.1      |

### Bank Transfer

| Versão do Chart | appVersion |
| :-------------- | :--------- |
| 1.2.1           | 1.0.0      |
| 1.1.0           | 2.1.0      |

### Fetcher

O Fetcher é o serviço interno de extração de dados da Lerian. É necessário apenas ao rodar o Reporter ou o Matcher no modo managed/multi-tenant (`FETCHER_ENABLED=true`); deployments self-hosted se conectam diretamente aos datasources e não precisam dele. Veja [Infraestrutura via Helm](/pt/platform/helm/infrastructure/infrastructure-helm).

| Versão do Chart | appVersion |
| :-------------- | :--------- |
| 3.0.0           | 1.4.2      |
| 2.0.3           | 1.2.0      |

### Flowker

| Versão do Chart | appVersion    |
| :-------------- | :------------ |
| 3.0.0           | 1.0.0-beta.22 |
| 1.0.0           | 1.0.0         |

### Tracer

| Versão do Chart | appVersion |
| :-------------- | :--------- |
| 2.1.0           | 1.0.0      |
| 1.0.0           | 1.0.0      |

<Tip>
  Para código-fonte e documentação detalhada dos charts, visite o [repositório GitHub](https://github.com/LerianStudio/helm).
</Tip>