Reformulamos completamente a documentação de deploy com Helm para refletir as últimas mudanças no Midaz Helm Chart v5.x. Esta atualização introduz uma nova arquitetura unificada, serviços integrados e guias de migração abrangentes.
Principais mudanças no Helm v5.x
Novo serviço Ledger (mudança principal)
A mudança mais significativa na v5.x é a introdução do serviço Ledger unificado, que combina a funcionalidade dos módulos separadosonboarding e transaction em um único deployment.- Serviço único: Um deployment em vez de dois serviços separados
- Configuração simplificada: Variáveis de ambiente unificadas com prefixos específicos por módulo
- Roteamento de ingress automático: Configurações de DNS existentes continuam funcionando perfeitamente
- Novo Balance Sync Worker: Processamento em background para sincronização de saldos
CRM integrado ao chart principal
O plugin CRM agora está integrado diretamente ao chart principal do Midaz Helm:- Anteriormente implantado como um chart separado (
plugin-crm) no namespacemidaz-plugins - Agora disponível como um componente opcional no namespace
midaz - Deployment e configuração simplificados
- Conexão MongoDB compartilhada com outros serviços do Midaz
Console removido
O componente Console foi removido do chart Helm como parte da migração para o Lerian Console. Para gerenciamento via web, consulte a documentação do Lerian Console.Mudanças de dependências
- RabbitMQ: Migrado do chart Bitnami para Groundhog2k (desde a v4.x)
- Erlang Cookie: Agora requer configuração explícita para o RabbitMQ
- Imagens BitnamiSecure: PostgreSQL, MongoDB e Valkey agora usam imagens hardened
Novas variáveis de ambiente
O serviço Ledger introduz prefixos específicos por módulo para configuração de banco de dados:| Variável antiga (Legacy) | Nova variável (Ledger) |
|---|---|
DB_PASSWORD | DB_ONBOARDING_PASSWORD, DB_TRANSACTION_PASSWORD |
MONGO_PASSWORD | MONGO_ONBOARDING_PASSWORD, MONGO_TRANSACTION_PASSWORD |
Atualizações de documentação
Reestruturamos e expandimos a seção de documentação do Helm:Novas páginas
- Visão geral do Helm: Hub central para toda documentação relacionada ao Helm
- Atualizando o Helm: Guia de migração abrangente cobrindo transições v3.x → v4.x → v5.x com breaking changes e procedimentos de rollback
Páginas atualizadas
-
Usando Helm: Completamente reescrito para incluir:
- Configuração do serviço Ledger (recomendado)
- Configuração legacy de Onboarding/Transaction
- Configuração de integração do CRM
- Jobs de bootstrap para PostgreSQL e RabbitMQ externos
- Tabelas detalhadas de parâmetros para todos os serviços
-
Atualizando Midaz e plugins via Helm: Atualizado com:
- Suporte para arquitetura Ledger (v5.x)
- Tabs para comandos Ledger vs Legacy
- Números de versão atualizados
-
Compatibilidade de versões: Atualizado com:
- Nova tabela de compatibilidade da arquitetura Ledger
- Versões de integração do CRM
- Versões de plugins atualizadas
- Visão geral de estratégias de deployment: Atualizado para refletir a nova estrutura do Helm
Compatibilidade de versões
| Versão do Helm Chart | Ledger | CRM | Recomendado |
|---|---|---|---|
| 5.3.0 | 3.5.1 | 3.5.0 | Sim |
| 5.2.0 | 3.5.0 | 3.5.0 | Sim |
| 5.0.0 | 3.5.0 | 3.5.0 | Sim |
Caminhos de migração
Fornecemos guias de migração detalhados para todos os cenários de upgrade:- v4.x → v5.x: Habilitar serviço Ledger, migrar secrets para prefixos específicos por módulo
- v3.x → v4.x: Configurar Erlang cookie para RabbitMQ, backup de dados PVC
- v3.x → v5.x: Migração combinada abordando ambos os conjuntos de breaking changes