Skip to main content

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.

21 de enero de 2026 Actualización de documentación Acción requerida

​
Afecta

Equipos que despliegan o actualizan Midaz con Helm, especialmente los que migran a Helm Chart v5.x. Esta actualización aplica al portal público de documentación. No cambia el comportamiento de la API en tiempo de ejecución a menos que la documentación del producto enlazada indique lo contrario.

​
Qué cambió

Hemos renovado por completo la documentación de despliegue de Helm para reflejar los últimos cambios en Midaz Helm Chart v5.x. Esta actualización introduce una nueva arquitectura unificada, servicios integrados y guías de migración completas.

​
Cambios principales en Helm v5.x

​
Nuevo servicio Ledger (cambio principal)

El cambio más significativo en v5.x es la introducción del servicio Ledger unificado, que combina la funcionalidad de los módulos separados onboarding y transaction en un único despliegue.
  • Servicio único: un despliegue en lugar de dos servicios separados
  • Configuración unificada: variables de entorno unificadas con prefijos específicos por módulo
  • Enrutamiento de ingress automático: las configuraciones de DNS existentes siguen funcionando sin interrupciones
  • Nuevo Balance Sync Worker: procesamiento en segundo plano para la sincronización de saldos
Los servicios separados de Onboarding y Transaction ahora son legacy y quedarán obsoletos en una versión futura. Recomendamos planificar la migración al servicio Ledger unificado.

​
CRM integrado en el chart principal

El plugin CRM ahora está integrado directamente en el chart principal de Midaz Helm:
  • Antes se desplegaba como un chart separado (plugin-crm) en el namespace midaz-plugins
  • Ahora está disponible como un componente opcional en el namespace midaz
  • Despliegue y configuración unificados
  • Conexión MongoDB compartida con otros servicios de Midaz

​
Console eliminado

El componente Console se eliminó del chart de Helm como parte de la migración a Lerian Console. Para la gestión basada en web, consulta la documentación de Lerian Console.

​
Cambios de dependencias

  • RabbitMQ: migrado de Bitnami al chart Groundhog2k (desde v4.x)
  • Erlang Cookie: ahora requiere configuración explícita para RabbitMQ
  • Imágenes BitnamiSecure: PostgreSQL, MongoDB y Valkey ahora usan imágenes hardened

​
Nuevas variables de entorno

El servicio Ledger introduce prefijos específicos por módulo para la configuración de la base de datos:
Variable antigua (Legacy)Nueva variable (Ledger)
DB_PASSWORDDB_ONBOARDING_PASSWORD, DB_TRANSACTION_PASSWORD
MONGO_PASSWORDMONGO_ONBOARDING_PASSWORD, MONGO_TRANSACTION_PASSWORD

​
Actualizaciones de documentación

— Hemos reestructurado y ampliado la sección de documentación de Helm:

​
Nuevas páginas

  • Helm Overview: hub central para toda la documentación relacionada con Helm
  • Upgrading Helm: guía completa de migración que cubre las transiciones v3.x → v4.x → v5.x con cambios incompatibles y procedimientos de rollback

​
Páginas actualizadas

  • Using Helm: reescrita por completo para incluir:
  • Configuración del servicio Ledger (recomendada)
  • Configuración legacy de Onboarding/Transaction
  • Configuración de integración de CRM
  • Bootstrap jobs para PostgreSQL y RabbitMQ externos
  • Tablas detalladas de parámetros para todos los servicios
  • Upgrading Midaz and plugins via Helm: actualizada con:
  • Soporte para arquitectura Ledger (v5.x)
  • Pestañas para comandos Ledger vs Legacy
  • Números de versión actualizados
  • Version Compatibility: actualizada con:
  • Nueva tabla de compatibilidad de arquitectura Ledger
  • Versiones de integración de CRM
  • Versiones de plugin actualizadas
  • Deployment Strategies Overview: actualizada para reflejar la nueva estructura de Helm

​
Compatibilidad de versiones

Versión Helm ChartLedgerCRMRecomendada
5.3.03.5.13.5.0Sí
5.2.03.5.03.5.0Sí
5.0.03.5.03.5.0Sí

​
Rutas de migración

Proporcionamos guías de migración detalladas para todos los escenarios de actualización:
  • v4.x → v5.x: habilitar el servicio Ledger, migrar secretos a prefijos específicos por módulo
  • v3.x → v4.x: configurar Erlang cookie para RabbitMQ, hacer backup de datos PVC
  • v3.x → v5.x: migración combinada que aborda ambos conjuntos de cambios incompatibles

​
Recursos relacionados

​
Impacto

Esta actualización de documentación incluye información que los equipos deben revisar antes de cambiar la integración o el despliegue afectados.

​
Qué necesitas hacer

1
Revisa la guía de migración de Helm v5.x antes de tu próximo despliegue o actualización de Midaz.
2
Planifica la migración al servicio Ledger unificado y al modelo de despliegue de CRM actualizado cuando corresponda.

​
Plazo

Antes de tu próxima integración, despliegue o cambio de actualización relacionado.

​
Por qué

Helm v5.x cambia la arquitectura de despliegue documentada y la ruta de migración. Los equipos que operan Midaz con Helm necesitan las indicaciones actualizadas antes de cambiar entornos.