Pular para o conteúdo principal

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.

Esta página é destinada a engenheiros DevOps e equipes de infraestrutura. Ela cobre a configuração de deploy no Kubernetes usando Helm charts. Se você está procurando uma visão de alto nível sobre as opções de deploy do Midaz, veja SaaS e BYOC.
Esta é a forma recomendada de fazer deploy do Midaz no Kubernetes. O Helm chart instala tudo que você precisa em um único comando: o serviço core Ledger (ou os legacy Onboarding/Transaction), PostgreSQL, MongoDB, Valkey, RabbitMQ e um stack de observabilidade opcional (Grafana + OpenTelemetry).
Use o serviço Ledger para todas as novas instalações. Os serviços separados de Onboarding e Transaction são suportados apenas para cenários de migração e serão deprecados em uma futura versão.
Este guia cobre o Helm chart do Midaz v5.x. Para atualizar a partir de versões anteriores, veja Atualizando o Helm.

​
O que é implantado

Um helm install padrão implanta os seguintes componentes:
  • Ledger — Serviço de API unificado (porta 3002) que gerencia onboarding, transações e administração de contas.
  • PostgreSQL — Primário + réplica para armazenamento de dados relacionais (porta 5432).
  • MongoDB — Armazenamento de documentos para logs de auditoria e metadados (porta 27017).
  • Valkey — Cache em memória para dados de sessão e saldos (porta 6379).
  • RabbitMQ — Broker de mensagens para processamento assíncrono de eventos (portas 5672/15672).
  • Grafana + OTEL LGTM — Stack de observabilidade com dashboards, logs, traces e métricas (porta 3000, se habilitado).

​
Pré-requisitos

Antes de fazer o deploy do Midaz com Helm, certifique-se de ter:
  • Kubernetes (v1.30+) – 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).
O código-fonte deste Helm chart está disponível em:A instalação padrão corresponde à fornecida no Guia de instalação rápida do Midaz.
Quer entender melhor a arquitetura? Confira a Visão geral da arquitetura do Midaz.

​
Instalar o Midaz via Helm Chart

Para instalar o Midaz usando Helm, execute o seguinte comando: 
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version> -n midaz --create-namespace
Substitua <version> pela versão desejada do Helm chart. Você pode verificar as versões disponíveis executando: 
helm search repo oci://registry-1.docker.io/lerianstudio/midaz-helm --versions
Isso cria um namespace chamado midaz (se ainda não existir) e faz o deploy do chart.
O Helm chart está no nosso repositório GitHub. Você pode fazer fork, personalizar valores ou estender conforme necessário.

​
Verificar a instalação

Após executar o comando de instalação, verifique se todos os pods estão em execução: 
kubectl get pods -n midaz
kubectl get svc -n midaz
Resultado esperado: Você deve ver 5-7 pods no estado Running (Ledger, PostgreSQL primário, PostgreSQL réplica, MongoDB, Valkey, RabbitMQ e opcionalmente Grafana). Todos os serviços devem ter endpoints ClusterIP atribuídos. Se algum pod estiver em CrashLoopBackOff ou Pending, verifique os logs do pod com kubectl logs <pod-name> -n midaz.
Para confirmar que o release do Helm está registrado: 
helm list -n midaz

​
Próximos passos

Depois de instalar o Midaz, consulte os guias a seguir para configurar seu ambiente: