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.
Esquema de versionamento
A Lerian usa um esquema de versionamento semântico com prefixo para Helm charts:
midaz-v4.4.8- Helm chart do Midaz versão 4.4.8plugin-crm-v3.2.1- Chart do plugin CRM versão 3.2.1plugin-crm-v3.2.1-rc.1- Plugin CRM, prerelease (release candidate)
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 chart v5.x, um serviço unificado Ledger está disponível que combina a funcionalidade de Onboarding e Transaction.
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 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
O chart standalone plugin-crm inclui um componente de UI e permanece compatível com deployments chart v4.x e v5.x.
Fees Engine
Pix
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.Access Manager (serviço compartilhado)
O Access Manager fornece serviços de autenticação e identidade compartilhados entre os produtos da Lerian.Product Console
O Product Console fornece a interface visual unificada para os produtos da Lerian.OTEL Collector Lerian
OpenTelemetry Collector configurado para a stack de observabilidade da Lerian.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.
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:
Pix Indirect (BTG)
Bank Transfer
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.