Esta sección cubre todo lo que necesitas para desplegar y gestionar Midaz en Kubernetes usando Helm. Desde la instalación inicial hasta las actualizaciones de versión, encontrarás guías adaptadas tanto para nuevos despliegues como para entornos existentes.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.
¿Por qué Helm?
Helm es la forma recomendada de desplegar Midaz en Kubernetes. Proporciona:
- Despliegue simplificado: Instala Midaz con un solo comando.
- Configuración consistente: Gestiona todas las configuraciones a través de un archivo
values.yamlcentralizado. - Actualizaciones fáciles: Actualiza versiones de Midaz con tiempo de inactividad mínimo.
- Gestión de dependencias: Maneja automáticamente PostgreSQL, MongoDB, RabbitMQ, Valkey y otros servicios requeridos.
Contenido
En esta sección encontrarás:
- Instalar Midaz con Helm: Instala y configura Midaz en Kubernetes.
- Configurar ingress: Expón los servicios de Midaz fuera del clúster con NGINX, AWS ALB o Traefik.
- Configurar observabilidad: Configura Grafana y OpenTelemetry para monitoreo.
- Configurar dependencias: Configura PostgreSQL, MongoDB, RabbitMQ y Valkey.
- Referencia de componentes de Midaz: Parámetros detallados para los servicios Ledger, Onboarding, Transaction y CRM.
- Guía de actualización: Inicio rápido para actualizar Midaz Core y plugins.
- Guías de migración: Rutas de migración paso a paso entre versiones del Helm chart.
- Referencia de configuración: Configuración del servicio Ledger, secrets externos y flags de despliegue.
- Lista de verificación de actualización: Mejores prácticas y verificaciones post-actualización.
- Rollback y solución de problemas: Procedimientos de reversión y resolución de problemas comunes.
- Compatibilidad de versiones: Consulta la matriz de compatibilidad entre versiones del Helm chart y componentes de Midaz.
Requisitos previos
Antes de desplegar Midaz con Helm, asegúrate de tener:
- Kubernetes (v1.30+): Un clúster en ejecución.
- Helm 3+: Instalado y disponible (
helm version). - Acceso a un registro de contenedores con imágenes de Midaz.
- DNS y certificados TLS para ingress (o cert-manager instalado).
Inicio rápido
Para instalar Midaz usando Helm, ejecuta:
<version> con la versión deseada del Helm chart. Verifica las versiones disponibles con:

