Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt

Use this file to discover all available pages before exploring further.

​
Procedimentos de rollback

Se algo der errado após uma atualização, você pode fazer rollback para uma versão anterior.

​
Quando fazer rollback

Considere fazer rollback se você observar:
  • 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

Visualize 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-4.4.8     3.4.7        Install complete
2         deployed    midaz-5.7.0     3.5.3        Upgrade complete

​
Executar rollback

Faça rollback para uma revisão específica:
  • Rollback do Midaz para revisão anterior
helm rollback midaz 1 -n midaz
  • Rollback de plugin (exemplo: CRM)
helm rollback plugin-crm 1 -n midaz

​
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
Rollbacks podem não reverter mudanças no schema do banco de dados. Se a atualização incluiu migrações de banco de dados, pode ser necessário restaurar a partir de um backup do banco.

​
Solução de problemas

​
Pods presos no estado Pending

Sintoma: Pods permanecem no status Pending após a atualização. Solução: Verifique restrições de recursos:
  • Descrever pod pendente
kubectl describe pod <pod-name> -n midaz
  • Verificar recursos dos nodes
kubectl top nodes

​
Erros de pull de imagem

Sintoma: Pods mostram ImagePullBackOff ou ErrImagePull. Solução: Verifique o acesso ao registro de imagens e credenciais:
  • 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:3.5.3

​
Erros de configuração

Sintoma: Pods falham com erros relacionados a configuração nos logs. Solução: Compare seus valores com os padrões novos:
  • 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

Sintoma: Serviços falham ao conectar ao PostgreSQL ou MongoDB. Solução: Verifique a conectividade e credenciais do 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

​
Procedimento geral de rollback

Se encontrar problemas após qualquer atualização: 
# 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