Rollback e solução de problemas

As orientações de CRM e Fees marcadas como legado nesta página valem apenas para um release legado existente. O Midaz v4 faz deploy do Ledger unificado e serve CRM e Fees em /v2.

O repositório Helm mantém uma carga de trabalho crm.enabled e o chart plugin-fees-helm para releases de aplicação mais antigos. Essas são superfícies de compatibilidade legadas, não o modelo de deploy do Midaz v4.

Procedimentos de rollback

Se algo der errado depois de um upgrade, você pode fazer rollback para uma versão anterior.

Quando fazer rollback

Considere fazer rollback se você observar:

Pods que não iniciam ou entram em crash loop
Erros de API ou indisponibilidade do serviço
Inconsistências de dados
Degradação de desempenho

Consultar o histórico do release

Veja o histórico de revisões de um release:

helm history midaz -n midaz

Exemplo de saída:

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 o rollback

Faça rollback para uma revisão específica:

Fazer rollback do Midaz para a revisão anterior

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

Fazer rollback de um plugin (exemplo: Fees)

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

O CRM não tem um release próprio para sofrer rollback. Ele vem dentro do chart do Midaz, então o rollback de midaz leva o CRM junto.

Verificar o rollback

Verificar a versão do release

helm list -n midaz

Verificar os pods

kubectl get pods -n midaz

Consultar os logs

Chart atual (v7.0.0+)
Charts anteriores à v7.0.0

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

O rollback pode não reverter mudanças de schema do banco de dados. Se o upgrade incluiu migrations de banco de dados, você pode precisar restaurar a partir de um backup.

Solução de problemas

Pods travados no estado Pending

Sintoma: os pods continuam no status Pending depois do upgrade. Solução: verifique se há restrições de recursos:

Descrever o pod pendente

kubectl describe pod <pod-name> -n midaz

Verificar os recursos dos nós

kubectl top nodes

Erros ao baixar a imagem

Sintoma: os pods mostram ImagePullBackOff ou ErrImagePull. Solução: verifique o acesso ao registry de imagens e as credenciais:

Verificar os 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

Sintoma: os pods caem com erros de configuração nos logs. Solução: compare seus values com os novos padrões:

Ver os values atuais

helm get values midaz -n midaz

Ver os padrões do chart

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

Problemas de conexão com o banco de dados

Sintoma: os serviços não conseguem conectar ao PostgreSQL ou ao MongoDB. Solução: verifique a conectividade com o banco de dados e as credenciais:

Verificar os pods de 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

Consultar os logs do serviço

Chart atual (v7.0.0+)
Charts anteriores à v7.0.0

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

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

Procedimento geral de rollback

Se você encontrar problemas depois de qualquer upgrade:

# List release history
helm history midaz -n midaz

# Rollback to previous version
helm rollback midaz <REVISION> -n midaz

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

Recursos relacionados

Instalar o Midaz com Helm - Guia de instalação inicial
Compatibilidade de versões do chart do Midaz - Metadados atuais do chart e da aplicação
Repositório Helm - Código-fonte e notas de release

Introdução

Midaz

Outros produtos

Rollback e solução de problemas

Procedimentos de rollback

Quando fazer rollback

Consultar o histórico do release

Executar o rollback

Verificar o rollback

Solução de problemas

Pods travados no estado Pending

Erros ao baixar a imagem

Erros de configuração

Problemas de conexão com o banco de dados

Procedimento geral de rollback

Recursos relacionados

​Procedimentos de rollback

​Quando fazer rollback

​Consultar o histórico do release

​Executar o rollback

​Verificar o rollback

​Solução de problemas

​Pods travados no estado Pending

​Erros ao baixar a imagem

​Erros de configuração

​Problemas de conexão com o banco de dados

​Procedimento geral de rollback

​Recursos relacionados

Procedimentos de rollback

Quando fazer rollback

Consultar o histórico do release

Executar o rollback

Verificar o rollback

Solução de problemas

Pods travados no estado Pending

Erros ao baixar a imagem

Erros de configuração

Problemas de conexão com o banco de dados

Procedimento geral de rollback

Recursos relacionados