Pular para o conteúdo principal
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.
Procurando instruções de atualização? Confira o guia de atualização do Helm para procedimentos passo a passo.

​
Fonte da verdade

A matriz de versões oficial e mais atualizada é mantida no README do repositório Helm. 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.
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.

​
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-br-pix-direct-jd-v1.3.0-beta.1 - Release beta do plugin Pix
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.

​
Midaz Core

O Helm chart principal do Midaz faz o deploy dos serviços core. A partir do v5.x, um serviço unificado Ledger está disponível que combina a funcionalidade de Onboarding e Transaction.
Versão do ChartLedgerCRMOnboardingTransaction
5.3.03.5.13.5.13.5.13.5.1
4.4.8--3.4.43.4.7
4.3.4--3.4.33.4.6
4.0.0--3.0.03.0.0
A partir do v5.x, o serviço Ledger é a opção de deployment recomendada, combinando Onboarding e Transaction em um único serviço. O CRM agora também está integrado ao chart principal do Midaz. Veja o guia Atualizando o Helm para detalhes de migração.Para o histórico completo de versões, confira as tags do repositório Helm.

​
Plugins

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

​
CRM

A partir do Midaz v5.x, o CRM está integrado ao Helm chart principal do Midaz. O chart standalone plugin-crm ainda está disponível para deployments v4.x.
Versão do ChartBackendUICompatibilidade com Midaz
4.0.03.5.12.0.0v4.x, v5.x
3.2.12.0.02.0.0v3.x, v4.x
3.1.02.0.02.0.0v3.x, v4.x

​
Fees Engine

Versão do ChartBackendUICompatibilidade com Midaz
3.5.13.0.53.0.0v3.x, v4.x, v5.x
3.4.73.0.33.0.0v3.x, v4.x
O Fees Engine está disponível apenas para o Midaz v3 e posterior. Não é compatível com o Midaz v2.

​
Pix

Versão do ChartPixJobCompatibilidade com Midaz
1.2.61.2.1-beta.71.2.1-beta.7v3.x, v4.x, v5.x
O plugin Pix ainda está em desenvolvimento.

​
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 ChartManagerWorkerUI
2.2.04.0.04.0.04.0.0
1.1.74.0.04.0.04.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 ChartAuthIdentity
5.2.22.4.42.1.1
4.0.02.2.02.0.0

​
Product Console

O Product Console fornece a interface visual unificada para os produtos da Lerian.
Versão do ChartConsole
1.0.01.0.0

​
OTEL Collector Lerian

OpenTelemetry Collector configurado para a stack de observabilidade da Lerian.
Versão do ChartOTEL
2.2.12.1.0

​
Dependências de infraestrutura

A tabela a seguir lista as versões mínimas necessárias para componentes de infraestrutura ao usar o Helm chart mais recente do Midaz.
DependênciaVersão mínimaObservações
Kubernetes1.20+1.30+ recomendado
Helm CLI3.8+Necessário para registro OCI
PostgreSQL16.3Banco de dados principal
MongoDB16.4.0Armazenamento de documentos
RabbitMQ2.1.11Message broker
Valkey2.4.7Cache em memória (fork do Redis)
OTEL Collector2.2.1Opcional, para observabilidade

​
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 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: 
# 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
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 código-fonte e documentação detalhada dos charts, visite o repositório GitHub.