Checklist de atualização

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:

Infraestrutura (se necessário)
Midaz Core
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

Passo	Comando	Verificado
Backup dos bancos	Snapshot do PostgreSQL e MongoDB — `helm rollback` não desfaz migrações de schema
Backup dos valores	`helm get values <release> -n midaz > backup.yaml`
Verificar compatibilidade	Revisar tabela de compatibilidade
Atualizar Midaz	`helm upgrade midaz ...`
Verificar pods do Midaz	`kubectl get pods -n midaz`
Atualizar plugins	`helm upgrade <plugin> ...`
Verificar pods dos plugins	`kubectl get pods -n midaz`
Verificar logs	`kubectl 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

# O serviço ledger (o único Deployment de aplicação por padrão)
kubectl logs -n midaz deployment/midaz-ledger

# RabbitMQ
kubectl logs -n midaz statefulset/midaz-rabbitmq

# CRM, se crm.enabled: true
kubectl logs -n midaz deployment/midaz-crm

Em charts anteriores à v7.0.0 você também tinha os Deployments midaz-onboarding e midaz-transaction. Esses serviços foram removidos na v7.0.0 — em qualquer chart atual esses nomes retornam NotFound.

4. Verificar roteamento de ingress

kubectl get ingress -n midaz
kubectl describe ingress midaz-ledger -n midaz

Introdução

Midaz

Outros produtos

Checklist de atualização

Recomendação para produção

Boas práticas

Ordem de atualização

Teste primeiro

Monitore de perto

Mantenha backups

Resumo do checklist de atualização

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

1. Verificar status dos pods

2. Verificar serviços

3. Verificar os logs

4. Verificar roteamento de ingress

​Recomendação para produção

​Boas práticas

​Ordem de atualização

​Teste primeiro

​Monitore de perto

​Mantenha backups

​Resumo do checklist de atualização

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

​1. Verificar status dos pods

​2. Verificar serviços

​3. Verificar os logs

​4. Verificar roteamento de ingress

Recomendação para produção

Boas práticas

Ordem de atualização

Teste primeiro

Monitore de perto

Mantenha backups

Resumo do checklist de atualização

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

1. Verificar status dos pods

2. Verificar serviços

3. Verificar os logs

4. Verificar roteamento de ingress