Desinstalar el despliegue de Midaz

La orientación sobre CRM y Fees marcada como legacy en esta página aplica solo a los releases legacy que ya existen. Midaz v4 despliega el Ledger unificado y sirve CRM y Fees en /v2.

El repositorio de Helm conserva un workload crm.enabled y el chart plugin-fees-helm para releases de aplicación anteriores. Son superficies de compatibilidad legacy, no el modelo de despliegue de Midaz v4. Esta guía te lleva por la eliminación completa de un despliegue de Midaz de Kubernetes. helm uninstall elimina los recursos gestionados por Helm. Lo que pasa con los volúmenes de base de datos depende de los subcharts incluidos, así que lee sus ajustes de almacenamiento antes de ejecutarlo.

Desinstalar Midaz puede eliminar datos de la aplicación de forma permanente. Respalda antes de ejecutarlo, no después. Esta operación es irreversible.

Qué elimina la desinstalación y qué sobrevive

Recurso	Con `helm uninstall`
Deployments, Services, ConfigMaps, Secrets, ServiceAccounts, RBAC, HPA, PDB, NetworkPolicy	Eliminados
Jobs de bootstrap (`<release>-bootstrap-postgres`, `-bootstrap-mongodb`, `-bootstrap-rabbitmq`)	Eliminados (también se eliminan solos 300s después de terminar)
PersistentVolumeClaims del PostgreSQL, MongoDB y RabbitMQ incluidos	Depende de cómo los crea cada subchart. Lee los ajustes de almacenamiento de la versión que ejecutas
Secrets que creaste tú (`kubectl create secret`)	Sobreviven
El namespace	Sobrevive

Ningún recurso del chart lleva una anotación helm.sh/resource-policy: keep. No confíes en Helm para proteger ningún volumen.

Requisitos previos

Antes de desinstalar, lista los claims para saber qué existe:

kubectl get pvc -n midaz

Luego respalda tus bases de datos:

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

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

Luego respalda tus values actuales de Helm para poder reinstalar con la misma configuración si lo necesitas:

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

Respalda también cualquier release de plugin que ejecutes por separado (los plugins se instalan en su propio 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

CRM es un módulo dentro del chart midaz-helm. Lo habilitas con el bloque de values crm. No existe un chart de CRM. No lo respaldas ni lo desinstalas por separado.

Verifica todos los releases que afecta la desinstalación:

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

Desinstalar el Helm release

Ejecuta el siguiente comando para desinstalar el Helm release de Midaz:

helm uninstall midaz -n midaz

Esto elimina los recursos de Kubernetes que creó el Helm chart: Deployments, StatefulSets, Services, Ingresses, ConfigMaps, Secrets gestionados por el chart, ServiceAccounts, recursos de RBAC y Jobs de bootstrap. No elimina los Secrets que creaste fuera de Helm ni el namespace. Verifica que no quedan pods gestionados por Helm:

kubectl get pods -n midaz

Limpiar los recursos persistentes

PersistentVolumeClaims

Lista los claims que sobrevivieron a la desinstalación:

kubectl get pvc -n midaz

Elimina solo los PVC de Midaz que identificaste arriba. No uses un delete para todo el namespace cuando otros workloads comparten el namespace:

kubectl delete pvc <midaz-pvc-name> -n midaz

Eliminar estos PVC destruye de forma permanente los datos del volumen, el sistema de registro del ledger. Confirma que los backups de base de datos están en su lugar antes de ejecutar este comando.

Secrets

helm uninstall no elimina los secrets creados fuera del ciclo de vida del Helm release (por ejemplo, kubectl create secret). Lista todos los secrets del namespace e identifica los que ya no necesitas:

kubectl get secrets -n midaz

Elimina los secrets huérfanos de a uno:

kubectl delete secret <secret-name> -n midaz

O elimina todos los secrets del namespace:

kubectl delete secrets --all -n midaz

ConfigMaps

Los ConfigMaps creados manualmente o por los Jobs de bootstrap también pueden quedar. Lístalos:

kubectl get configmaps -n midaz

Elimina los ConfigMaps huérfanos:

kubectl delete configmap <configmap-name> -n midaz

Limpieza del namespace

Cuando no quedan recursos dentro del namespace, elimina el namespace mismo:

kubectl delete namespace midaz

Eliminar el namespace quita por la fuerza cualquier recurso que quede dentro. Si un recurso está atascado en estado Terminating, puedes necesitar quitar sus finalizers manualmente.

Verifica que el namespace ya no existe:

kubectl get namespace midaz

Limpieza completa

Para entornos de staging, evaluación o CI donde un desmontaje completo es seguro, el siguiente script automatiza todo el proceso:

La pérdida de datos es permanente. Ejecuta esto solo en entornos donde confirmaste los backups o donde la pérdida de datos es aceptable (staging, evaluación, CI). No lo ejecutes en producción sin un backup completo y la aprobación del equipo. El script supone un namespace que contiene solo Midaz. Elimina cada claim, Secret y ConfigMap de ese namespace.

#!/bin/bash
set -e

NAMESPACE=midaz
RELEASE=midaz

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

echo "==> Deleting all PersistentVolumeClaims"
kubectl delete pvc --all -n "$NAMESPACE" || true

echo "==> Deleting all Secrets"
kubectl delete secrets --all -n "$NAMESPACE" || true

echo "==> Deleting all ConfigMaps"
kubectl delete configmaps --all -n "$NAMESPACE" || true

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

echo "==> Done. Midaz has been fully removed."

Guarda esto como midaz-cleanup.sh, hazlo ejecutable (chmod +x midaz-cleanup.sh) y ejecútalo con ./midaz-cleanup.sh.

Consideraciones de producción

En producción, una desinstalación completa requiere coordinación cuidadosa. Sigue estos pasos antes de ejecutar cualquier comando de limpieza:

Respalda todas las bases de datos antes de helm uninstall. Exporta un snapshot completo de PostgreSQL y MongoDB.
Exporta los datos críticos. Si debes migrar o preservar algún dato, expórtalo antes de desinstalar.
Coordina con tu equipo. Avisa a todos los stakeholders del downtime planificado y confirma la ventana de mantenimiento.
Desinstala los plugins primero. Elimina los releases de plugins (Fees, Pix) antes de desinstalar el release central de Midaz.
Verifica que no haya tráfico. Confirma que ningún tráfico activo llega a los servicios antes de continuar.

Desinstala los plugins antes del release central:

# Skips a release that is genuinely absent, and aborts on anything else
# (auth, API, timeout) instead of silently leaving it installed.
for release in plugin-fees plugin-br-pix-direct-jd; do
  if err=$(helm status "$release" -n midaz-plugins 2>&1 >/dev/null); then
    if ! helm uninstall "$release" -n midaz-plugins; then
      echo "Aborting: failed to uninstall $release." >&2
      exit 1
    fi
  elif printf '%s' "$err" | grep -q 'release: not found'; then
    echo "Skipping $release: not installed."
  else
    echo "Aborting: helm status $release failed: $err" >&2
    exit 1
  fi
done
helm uninstall midaz -n midaz

Luego continúa con los pasos de limpieza de recursos persistentes que se describen arriba.

Recursos relacionados

Desplegar Midaz con Helm: guía de instalación si necesitas reinstalar
Actualizar Midaz y los plugins con Helm: procedimientos de actualización y rollback
Solución de problemas: diagnostica problemas antes de decidir desinstalar
Compatibilidad de versiones del chart de Midaz: metadatos actuales del chart y de la aplicación

Introducción

Midaz

Otros productos

Desinstalar el despliegue de Midaz

Qué elimina la desinstalación y qué sobrevive

Requisitos previos

Desinstalar el Helm release

Limpiar los recursos persistentes

PersistentVolumeClaims

Secrets

ConfigMaps

Limpieza del namespace

Limpieza completa

Consideraciones de producción

Recursos relacionados

​Qué elimina la desinstalación y qué sobrevive

​Requisitos previos

​Desinstalar el Helm release

​Limpiar los recursos persistentes

​PersistentVolumeClaims

​Secrets

​ConfigMaps

​Limpieza del namespace

​Limpieza completa

​Consideraciones de producción

​Recursos relacionados

Qué elimina la desinstalación y qué sobrevive

Requisitos previos

Desinstalar el Helm release

Limpiar los recursos persistentes

PersistentVolumeClaims

Secrets

ConfigMaps

Limpieza del namespace

Limpieza completa

Consideraciones de producción

Recursos relacionados