Desinstalação da implantação do Midaz

Este guia mostra como remover completamente um deployment do Midaz do Kubernetes. O helm uninstall remove os recursos gerenciados pelo Helm e, importante, também remove o PersistentVolumeClaim do MongoDB junto com eles. Apenas os volumes do PostgreSQL sobrevivem, porque são criados a partir de um volumeClaimTemplate de StatefulSet. Esta página cobre o que vai embora com o release, o que permanece e como limpar o resto.

Desinstalar o Midaz exclui permanentemente os dados da aplicação. O helm uninstall por si só destrói o volume do MongoDB — faça o backup antes de executá-lo, não depois. Esta operação é irreversível.

O que a desinstalação remove e o que sobrevive

Recurso	No `helm uninstall`
Deployments, Services, ConfigMaps, Secrets, ServiceAccounts, RBAC, HPA, PDB, NetworkPolicy	Removidos
Jobs de bootstrap (`<release>-bootstrap-postgres`, `-bootstrap-mongodb`, `-bootstrap-rabbitmq`)	Removidos (também se autoexcluem 300 s após terminarem)
PVC `<release>-mongodb`	Removido — os dados do MongoDB são perdidos
PVCs `data-<release>-postgresql-primary-0`, `data-<release>-postgresql-replication-0`	Sobrevivem (volumeClaimTemplates de StatefulSet não são coletados)
Armazenamento do RabbitMQ	Não há o que remover — o RabbitMQ usa `emptyDir`, então seus dados já desaparecem quando o pod para
Secrets que você mesmo criou (`kubectl create secret`)	Sobrevivem
O namespace	Sobrevive

Nenhum recurso do chart carrega a anotação helm.sh/resource-policy: keep. Não conte com o Helm para proteger nenhum volume.

Pré-requisitos

Antes de desinstalar, faça backup dos seus bancos de dados — o helm uninstall destrói o volume do MongoDB:

kubectl exec -n midaz midaz-mongodb-0 -- mongodump --archive=/tmp/dump.gz --gzip
kubectl cp midaz/midaz-mongodb-0:/tmp/dump.gz ./mongo-backup.gz

Os volumes do PostgreSQL sobrevivem ao helm uninstall, mas a limpeza de PVCs mais abaixo os destrói. Faça o dump do PostgreSQL também se você pretende executar esse passo:

kubectl exec -n midaz midaz-postgresql-primary-0 -- \
  pg_dumpall -U postgres > ./postgres-backup.sql

Depois faça backup dos seus valores atuais do Helm para poder reinstalar com a mesma configuração se necessário:

helm get values midaz -n midaz > midaz-values-backup.yaml

Também faça backup dos releases de plugins que você executa separadamente (os plugins são instalados no próprio namespace, midaz-plugins):

helm get values plugin-fees -n midaz-plugins > plugin-fees-values-backup.yaml
helm get values plugin-br-pix-direct-jd -n midaz-plugins > plugin-pix-values-backup.yaml

O CRM faz parte do chart do Midaz, não é um release separado — não existe um chart plugin-crm para fazer backup ou desinstalar.

Verifique todos os releases que serão afetados:

helm list -n midaz
helm list -n midaz-plugins

Desinstalação do release do Helm

Execute o seguinte comando para desinstalar o release do Helm do Midaz:

helm uninstall midaz -n midaz

Isso remove todos os recursos do Kubernetes criados pelo chart do Helm — Deployments, StatefulSets, Services, Ingresses, ConfigMaps, Secrets gerenciados pelo chart, ServiceAccounts, recursos RBAC, Jobs de bootstrap e o PVC midaz-mongodb. Não remove os PVCs do StatefulSet do PostgreSQL, os Secrets criados fora do Helm, nem o namespace. Verifique se todos os pods gerenciados pelo Helm foram removidos:

kubectl get pods -n midaz

Limpeza de recursos persistentes

PersistentVolumeClaims

Depois da desinstalação, o que resta são os claims do PostgreSQL. Liste-os para confirmar:

kubectl get pvc -n midaz

Você deve ver data-midaz-postgresql-primary-0 e data-midaz-postgresql-replication-0. O claim midaz-mongodb já não existe — o Helm o removeu junto com o release. Delete os PVCs restantes do namespace (isso destrói os dados do PostgreSQL):

kubectl delete pvc --all -n midaz

Ou delete PVCs específicos pelo nome:

kubectl delete pvc <pvc-name> -n midaz

Deletar esses PVCs destrói permanentemente os dados do volume do PostgreSQL — o sistema de registro do ledger. Certifique-se de ter backups dos bancos de dados antes de executar este comando.

Secrets

Secrets criados fora do ciclo de vida do release do Helm (por exemplo, com kubectl create secret) não são removidos pelo helm uninstall. Liste todos os secrets do namespace e identifique os que não são mais necessários:

kubectl get secrets -n midaz

Delete secrets órfãos individualmente:

kubectl delete secret <secret-name> -n midaz

Ou delete todos os secrets do namespace:

kubectl delete secrets --all -n midaz

ConfigMaps

ConfigMaps criados manualmente ou por jobs de bootstrap também podem permanecer. Liste-os:

kubectl get configmaps -n midaz

Delete ConfigMaps órfãos:

kubectl delete configmap <configmap-name> -n midaz

Limpeza do namespace

Depois que todos os recursos dentro do namespace foram removidos, delete o namespace:

kubectl delete namespace midaz

Deletar o namespace removerá forçosamente qualquer recurso restante dentro dele. Se um recurso estiver travado em estado Terminating, pode ser necessário remover seus finalizers manualmente.

Verifique se o namespace foi removido:

kubectl get namespace midaz

Limpeza completa

Para ambientes de staging, avaliação ou CI onde uma remoção total é segura, o seguinte script automatiza todo o processo:

A perda de dados é permanente. Execute isso apenas em ambientes onde você tenha backups confirmados ou onde a perda de dados seja aceitável (staging, avaliação, CI). Não execute em produção sem backup completo e aprovação da equipe.

#!/bin/bash
set -e

NAMESPACE=midaz
RELEASE=midaz

echo "==> Desinstalando release do Helm: $RELEASE"
helm uninstall "$RELEASE" -n "$NAMESPACE" || true

echo "==> Deletando todos os PersistentVolumeClaims"
kubectl delete pvc --all -n "$NAMESPACE" || true

echo "==> Deletando todos os Secrets"
kubectl delete secrets --all -n "$NAMESPACE" || true

echo "==> Deletando todos os ConfigMaps"
kubectl delete configmaps --all -n "$NAMESPACE" || true

echo "==> Deletando namespace: $NAMESPACE"
kubectl delete namespace "$NAMESPACE" || true

echo "==> Concluído. O Midaz foi completamente removido."

Salve como midaz-cleanup.sh, torne-o executável (chmod +x midaz-cleanup.sh) e execute com ./midaz-cleanup.sh.

Considerações para produção

Em produção, uma desinstalação completa requer coordenação cuidadosa. Siga estes passos antes de executar qualquer comando de limpeza:

Faça backup de todos os bancos de dados antes do helm uninstall. Exporte um snapshot completo do PostgreSQL e MongoDB — o volume do MongoDB é destruído pela própria desinstalação, não pelos passos de limpeza.
Exporte dados críticos. Se algum dado precisa ser migrado ou preservado, exporte-o antes de desinstalar.
Coordene com sua equipe. Notifique todos os envolvidos sobre o tempo de inatividade planejado e confirme a janela de manutenção.
Desinstale os plugins primeiro. Remova os releases de plugins (Fees, Pix) antes de desinstalar o release principal do Midaz. O CRM não precisa de desinstalação separada — ele vem dentro do chart do Midaz.
Verifique ausência de tráfego. Confirme que nenhum tráfego ativo está chegando aos serviços antes de prosseguir.

Desinstale os plugins antes do release principal:

# Ignora um release realmente ausente e aborta em qualquer outro erro
# (auth, API, timeout) em vez de deixá-lo instalado silenciosamente.
# No Helm 3.13+ isso é apenas: helm uninstall <release> -n midaz-plugins --ignore-not-found
for release in plugin-fees plugin-br-pix-direct-jd; do
  if err=$(helm status "$release" -n midaz-plugins 2>&1 >/dev/null); then
    helm uninstall "$release" -n midaz-plugins
  elif printf '%s' "$err" | grep -q 'release: not found'; then
    echo "Ignorando $release — não está instalado."
  else
    echo "Abortando: helm status $release falhou: $err" >&2
    exit 1
  fi
done
helm uninstall midaz -n midaz

Em seguida, prossiga com os passos de limpeza de recursos persistentes descritos acima.

Recursos relacionados

Implantar o Midaz com Helm — Guia de instalação para reinstalar se necessário
Atualizar o Midaz e plugins via Helm — Procedimentos de atualização e rollback
Solução de problemas — Diagnosticar problemas antes de decidir desinstalar
Compatibilidade de versões — Tabela de referência de versões

Introdução

Midaz

Outros produtos

Desinstalação da implantação do Midaz

O que a desinstalação remove e o que sobrevive

Pré-requisitos

Desinstalação do release do Helm

Limpeza de recursos persistentes

PersistentVolumeClaims

Secrets

ConfigMaps

Limpeza do namespace

Limpeza completa

Considerações para produção

Recursos relacionados

​O que a desinstalação remove e o que sobrevive

​Pré-requisitos

​Desinstalação do release do Helm

​Limpeza de recursos persistentes

​PersistentVolumeClaims

​Secrets

​ConfigMaps

​Limpeza do namespace

​Limpeza completa

​Considerações para produção

​Recursos relacionados

O que a desinstalação remove e o que sobrevive

Pré-requisitos

Desinstalação do release do Helm

Limpeza de recursos persistentes

PersistentVolumeClaims

Secrets

ConfigMaps

Limpeza do namespace

Limpeza completa

Considerações para produção

Recursos relacionados