Esta seção cobre tudo o que você precisa para fazer o deploy e gerenciar o Midaz no Kubernetes usando Helm. Da instalação inicial às atualizações de versão, você encontrará guias adaptados tanto para novos deployments quanto para ambientes existentes.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.
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:

