Pular para o conteúdo principal

Recomendação para produção


Não recomendamos usar as dependências padrão do Helm chart do Midaz (bancos de dados, cache e message broker) em ambientes de produção. Para deployments de nível produtivo, siga nossas boas práticas para operar essas dependências com segurança adequada, observabilidade, backups, recuperação de desastres e SLOs.

Boas práticas


Ordem de atualização

Sempre atualize nesta ordem:
  1. Infraestrutura (se necessário)
  2. Midaz Core
  3. Plugins (um por vez)

Teste primeiro

Sempre teste atualizações em um ambiente de staging que espelhe produção antes de aplicar em produção.

Monitore de perto

Monitore logs e métricas de perto nos primeiros 15-30 minutos após uma atualização.

Mantenha backups

Mantenha backups dos seus valores do Helm e banco de dados antes de atualizações major.

Resumo do checklist de atualização

PassoComandoVerificado
Backup dos valoreshelm get values <release> -n midaz > backup.yaml
Verificar compatibilidadeRevisar tabela de compatibilidade
Atualizar Midazhelm upgrade midaz ...
Verificar pods do Midazkubectl get pods -n midaz
Atualizar pluginshelm upgrade <plugin> ...
Verificar pods dos pluginskubectl get pods -n midaz
Verificar logskubectl logs -n midaz deployment/<name>

Verificação pós-atualização


1. Verificar status dos pods

kubectl get pods -n midaz
Todos os pods devem estar Running e READY.

2. Verificar serviços

kubectl get svc -n midaz

3. Verificar os logs

# Se estiver usando o serviço Ledger (v5.x)
kubectl logs -n midaz deployment/midaz-ledger

# Se estiver usando serviços legado
kubectl logs -n midaz deployment/midaz-onboarding
kubectl logs -n midaz deployment/midaz-transaction

# Verificar logs do RabbitMQ (importante para atualizações v4.x+)
kubectl logs -n midaz statefulset/midaz-rabbitmq

# Verificar logs do CRM (se habilitado)
kubectl logs -n midaz deployment/midaz-crm

4. Verificar roteamento de ingress (v5.x com Ledger)

kubectl get ingress -n midaz
kubectl describe ingress midaz-onboarding -n midaz
kubectl describe ingress midaz-transaction -n midaz