Rollback e solução de problemas

​

Procedimentos de rollback

​

Quando fazer rollback

• Pods falhando ao iniciar ou em crash-loop
• Erros de API ou indisponibilidade de serviços
• Inconsistências de dados
• Degradação de desempenho

​

Verificar histórico de releases

helm history midaz -n midaz

REVISION  STATUS      CHART                APP VERSION  DESCRIPTION
1         superseded  midaz-helm-8.5.0     3.7.7        Install complete
2         deployed    midaz-helm-8.6.0     3.8.0        Upgrade complete

​

Executar rollback

• Rollback do Midaz para revisão anterior

helm rollback midaz 1 -n midaz --wait --timeout 10m

• Rollback de um plugin (exemplo: Fees)

helm rollback plugin-fees 1 -n midaz-plugins --wait --timeout 10m

​

Verificar rollback

• Verificar versão do release

helm list -n midaz

• Verificar pods

kubectl get pods -n midaz

• Verificar logs

kubectl logs -n midaz deployment/midaz-ledger --tail=50

kubectl logs -n midaz deployment/midaz-onboarding --tail=50
kubectl logs -n midaz deployment/midaz-transaction --tail=50

​

Solução de problemas

​

Pods presos no estado Pending

• Descrever pod pendente

kubectl describe pod <pod-name> -n midaz

• Verificar recursos dos nodes

kubectl top nodes

​

Erros de pull de imagem

• Verificar eventos do pod

kubectl describe pod <pod-name> -n midaz | grep -A 10 Events

• Verificar se a imagem existe

docker pull lerianstudio/midaz-ledger:<appVersion>

​

Erros de configuração

• Visualizar valores atuais

helm get values midaz -n midaz

• Visualizar padrões do chart

helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.7.0

​

Problemas de conexão com banco de dados

• Verificar pods do banco de dados

kubectl get pods -n midaz -l app.kubernetes.io/name=postgresql
kubectl get pods -n midaz -l app.kubernetes.io/name=mongodb

• Verificar logs do serviço

kubectl logs -n midaz deployment/midaz-ledger | grep -i database

kubectl logs -n midaz deployment/midaz-onboarding | grep -i database

​

Procedimento geral de rollback

# Listar histórico de releases
helm history midaz -n midaz

# Rollback para versão anterior
helm rollback midaz <REVISION> -n midaz

# Verificar rollback
helm list -n midaz
kubectl get pods -n midaz

​

Recursos relacionados

• Instalando o Midaz com Helm - Guia de instalação inicial
• Compatibilidade de versões - Referência de mapeamento de versões
• Repositório Helm - Código-fonte e notas de release