Por que Helm?
Helm é a forma recomendada de fazer o deploy do Midaz no Kubernetes. Ele oferece:
- Deploy simplificado: Instale o Midaz com um único comando.
- Configuração consistente: Gerencie todas as configurações através de um arquivo centralizado
values.yaml. - Atualizações fáceis: Atualize versões do Midaz com tempo de inatividade mínimo.
- Gerenciamento de dependências: Gerencia automaticamente PostgreSQL, MongoDB, RabbitMQ, Valkey e outros serviços necessários.
Conteúdo
Nesta seção, você encontrará:
- Instalando o Midaz com Helm: Instale e configure o Midaz no Kubernetes.
- Configurando o ingress: Exponha os serviços do Midaz fora do cluster com NGINX, AWS ALB ou Traefik.
- Configurando a observabilidade: Configure Grafana e OpenTelemetry para monitoramento.
- Configurando dependências: Configure PostgreSQL, MongoDB, RabbitMQ e Valkey.
- Referência de componentes do Midaz: Parâmetros detalhados para os serviços Ledger, Onboarding, Transaction e CRM.
- Guia de atualização: Início rápido para atualizar o Midaz Core e plugins.
- Guias de migração: Caminhos de migração passo a passo entre versões do Helm chart.
- Referência de configuração: Configuração do serviço Ledger, secrets externos e flags de deployment.
- Checklist de atualização: Boas práticas e verificações pós-atualização.
- Rollback e solução de problemas: Procedimentos de rollback e resolução de problemas comuns.
- Compatibilidade de versões: Consulte a matriz de compatibilidade entre versões do Helm chart e componentes do Midaz.
Pré-requisitos
Antes de fazer o deploy do Midaz com Helm, certifique-se de ter:
- Kubernetes (v1.30+): Um cluster em execução.
- Helm 3+: Instalado e disponível (
helm version). - Acesso a um registro de containers com as imagens do Midaz.
- Certificados DNS e TLS para ingress (ou cert-manager instalado).
Início rápido
Para instalar o Midaz usando Helm, execute:
<version> pela versão desejada do Helm chart. Verifique as versões disponíveis com:

