Skip to main content
La orientación sobre CRM y Fees marcada como legacy en esta página aplica solo a un release legacy existente. Midaz v4 despliega el Ledger unificado y sirve CRM y Fees en /v2.
Las etiquetas v3.x y v5.x de esta guía se refieren a releases del Helm chart, no a versiones de la aplicación Midaz. La línea histórica v5 del chart introdujo el workload de Ledger como una opción. La aplicación Midaz v4 ahora usa el Ledger unificado.
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. Si actualizas directamente de v3.x a v5.x, necesitas resolver los cambios incompatibles de ambas versiones.

​
Lista de verificación previa a la actualización

1
Respalda los Helm releases existentes:
2
Crítico: respalda los datos y las definiciones de RabbitMQ (cambio incompatible de v4.x).
3
Se requiere una decisión para esta migración histórica del chart: elige el workload de Ledger o los workloads legacy de Onboarding/Transaction.
4
Si migras al servicio de Ledger, prepara secrets nuevos con prefijos específicos de cada módulo.
5
Programa una ventana de mantenimiento.

​
Cambios incompatibles que hay que resolver

​
De v4.x: cambio de la dependencia de RabbitMQ

La dependencia del chart de RabbitMQ cambió de Bitnami a Groundhog2k. Esto puede provocar pérdida de datos de PVC. Respalda los datos de RabbitMQ antes de actualizar.
Configuración obligatoria:

​
Helm chart v5.x: se introduce el workload de Ledger

Esta sección describe la transición histórica del chart v5, cuando el workload de Ledger era opcional. La aplicación Midaz v4 ahora requiere el Ledger unificado. No uses la opción legacy para un despliegue nuevo de v4.
Elige una de estas configuraciones: Opción A: conservar los servicios legacy (migración gradual)
Opción B: migrar a Ledger (recomendado)
Si usas la Opción B, crea secrets nuevos con prefijos específicos de cada módulo:
  • DB_ONBOARDING_PASSWORD, DB_TRANSACTION_PASSWORD
  • MONGO_ONBOARDING_PASSWORD, MONGO_TRANSACTION_PASSWORD

​
Comando de actualización

​
Qué cambia respecto de v3.x

​
Problemas comunes

RabbitMQ no arranca
  • Verifica que configuraste la cookie de Erlang correctamente (32 caracteres imprimibles o más, sin espacios).
Pérdida de datos de PVC de RabbitMQ
  • Espera que ocurra después del cambio de dependencia de v4.x, de Bitnami a Groundhog2k. Exporta las definiciones de RabbitMQ antes de actualizar y restáuralas después.
El servicio de Ledger no arranca
  • Verifica que configuras todas las variables de entorno y los secrets específicos de cada módulo con los prefijos nuevos (DB_ONBOARDING_*, DB_TRANSACTION_*, etc.).
El ingress no enruta hacia Ledger
  • Define ledger.enabled: true. No definas migration.allowAllServices como true.
Faltan secrets después de habilitar Ledger
  • Crea secrets nuevos con prefijos de módulo:
    • DB_ONBOARDING_PASSWORD en lugar de DB_PASSWORD
    • DB_TRANSACTION_PASSWORD en lugar de DB_PASSWORD
    • MONGO_ONBOARDING_PASSWORD en lugar de MONGO_PASSWORD
    • MONGO_TRANSACTION_PASSWORD en lugar de MONGO_PASSWORD
Los overrides de la Console y de NGINX ya no aplican
  • El chart v7.0.0 eliminó por completo los componentes de la Console y de NGINX. templates/console/ ya no existe. Elimina de tu archivo de values cualquier override de console.* o de NGINX. Son inertes, y el esquema del chart en versiones más nuevas los rechaza.