Saltar al contenido principal
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.
¿Nuevo en Midaz? Comienza con Usando Helm para un recorrido completo del proceso de instalación.

¿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.yaml centralizado.
  • 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:
  • Usando Helm: Instala y configura Midaz en Kubernetes, incluyendo configuración de ingress, observabilidad y gestión de dependencias.
  • Actualización de Helm: Migra entre versiones de charts de Helm con cambios importantes, rutas de migración y procedimientos de reversión.
  • Actualización de Midaz y plugins mediante Helm: Instrucciones paso a paso para actualizar Midaz Core y plugins mediante Helm, incluyendo mejores prácticas, listas de verificación y procedimientos de reversión.
  • Compatibilidad de versiones: Consulta la matriz de compatibilidad entre versiones del chart de Helm 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:
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. Verifica las versiones disponibles con:
helm search repo oci://registry-1.docker.io/lerianstudio/midaz-helm --versions
Recomendamos usar la última versión estable para despliegues de producción para asegurar que tengas las últimas características y parches de seguridad.
Para opciones de configuración detalladas, consulta Usando Helm.

Recursos