¿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:

