Saltar al contenido principal
Esta página está dirigida a ingenieros DevOps y equipos de infraestructura. Cubre la configuración de despliegue en Kubernetes usando charts de Helm. Si buscas una comprensión de alto nivel de las opciones de despliegue de Midaz, consulta SaaS y BYOC.
Esta es la forma recomendada de desplegar Midaz en Kubernetes. El chart de Helm instala todo lo necesario en un solo comando: el servicio core Ledger (o los legacy Onboarding/Transaction), PostgreSQL, MongoDB, Valkey, RabbitMQ y un stack de observabilidad opcional (Grafana + OpenTelemetry).
Usa el servicio Ledger para todas las nuevas instalaciones. Los servicios separados de Onboarding y Transaction solo están soportados para escenarios de migración y serán deprecados en una futura versión.
Esta guía cubre el chart de Helm de Midaz v5.x. Para actualizar desde versiones anteriores, consulta Actualización de Helm.

​
Qué se despliega

Un helm install predeterminado despliega los siguientes componentes:
  • Ledger — Servicio API unificado (puerto 3002) que gestiona onboarding, transacciones y administración de cuentas.
  • PostgreSQL — Primario + réplica para almacenamiento de datos relacionales (puerto 5432).
  • MongoDB — Almacén de documentos para logs de auditoría y metadatos (puerto 27017).
  • Valkey — Caché en memoria para datos de sesión y balances (puerto 6379).
  • RabbitMQ — Broker de mensajes para procesamiento asíncrono de eventos (puertos 5672/15672).
  • Grafana + OTEL LGTM — Stack de observabilidad con dashboards, logs, traces y métricas (puerto 3000, si está habilitado).

​
Requisitos previos

Antes de desplegar Midaz con Helm, asegúrate de tener:
  • Kubernetes (v1.30+) – Clúster en ejecución.
  • Helm 3+ – Instalado y disponible (helm version).
  • Acceso a un registro de contenedores con imágenes de Midaz.
  • Certificados DNS y TLS para ingress (o cert-manager instalado).
El código fuente de este chart de Helm está disponible en:La instalación predeterminada coincide con la proporcionada en la guía de instalación rápida de Midaz.
¿Quieres una comprensión más profunda de la arquitectura? Consulta el resumen de la arquitectura de Midaz.

​
Instalar Midaz a través del chart de Helm

Para instalar Midaz usando Helm, ejecuta el siguiente comando: 
helm install midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version <version> -n midaz --create-namespace
Reemplaza <version> con la versión deseada del chart de Helm. Puedes verificar las versiones disponibles ejecutando: 
helm search repo oci://registry-1.docker.io/lerianstudio/midaz-helm --versions
Esto crea un namespace llamado midaz (si no existe ya) y despliega el chart.
El chart de Helm está en nuestro repositorio de GitHub. Puedes hacer un fork, personalizar los valores o extenderlo según sea necesario.

​
Verificar la instalación

Después de ejecutar el comando de instalación, verifica que todos los pods estén en ejecución: 
kubectl get pods -n midaz
kubectl get svc -n midaz
Resultado esperado: Deberías ver 5-7 pods en estado Running (Ledger, PostgreSQL primario, PostgreSQL réplica, MongoDB, Valkey, RabbitMQ y opcionalmente Grafana). Todos los servicios deben tener endpoints ClusterIP asignados. Si algún pod está en CrashLoopBackOff o Pending, revisa los logs del pod con kubectl logs <pod-name> -n midaz.
Para confirmar que el release de Helm está registrado: 
helm list -n midaz

​
Próximos pasos

Una vez completada la instalación, consulta las siguientes guías para configurar tu entorno: