Pular para o conteúdo principal
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.
Novo no Midaz? Comece com Usando o Helm para um passo a passo completo do processo de instalação.

​
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á:
  • Usando o Helm: Instale e configure o Midaz no Kubernetes, incluindo configuração de ingress, observabilidade e gerenciamento de dependências.
  • Atualizando o Helm: Migre entre versões do Helm chart com breaking changes, caminhos de migração e procedimentos de rollback.
  • Atualizando o Midaz e plugins via Helm: Instruções passo a passo para atualizar o Midaz Core e plugins via Helm, incluindo boas práticas, checklists e procedimentos de rollback.
  • 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: 
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. Verifique as versões disponíveis com: 
helm search repo oci://registry-1.docker.io/lerianstudio/midaz-helm --versions
Recomendamos usar a última versão estável para deployments em produção para garantir que você tenha as funcionalidades e correções de segurança mais recentes.
Para opções detalhadas de configuração, veja Usando o Helm.

​
Recursos