Esta guía te acompaña durante la actualización de tu despliegue de Midaz Helm a la última versión (v5.x.x).
Encontrarás un inicio rápido para operadores experimentados, seguido de rutas de migración desde versiones anteriores, cambios importantes detallados y verificaciones post-actualización.
¿Necesitas un repaso sobre la instalación de Midaz con Helm? Consulta la guía Instalar Midaz con Helm en Estrategias de despliegue antes de comenzar tu actualización. Inicio rápido
1. Verifica los requisitos previos
- Helm v3.8+ instalado y disponible (helm version).
- Kubernetes v1.20+ clúster en ejecución.
- Respaldo de tu instalación existente.
2. Identifica tu versión actual
3. Ejecuta el comando de actualización
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.x.x -n midaz
4. Verifica la actualización
helm list -n midaz
kubectl get pods -n midaz
Compatibilidad de versiones
| Componente | v3.x | v4.x | v5.x |
|---|
| Kubernetes | 1.20+ | 1.20+ | 1.20+ |
| Helm | 3.8+ | 3.8+ | 3.8+ |
| PostgreSQL | 13+ | 13+ | 13+ |
| MongoDB | 4.4+ | 4.4+ | 4.4+ |
| Valkey | 7.x | 7.x | 7.x |
Actualización de Midaz core
Al actualizar Midaz o cualquier plugin, siempre actualiza el chart de Helm correspondiente.Actualizar versiones de aplicaciones sin actualizar el chart de Helm puede provocar fallos en el despliegue o entornos inconsistentes.
1. Verificar versiones disponibles
Lista las versiones de charts disponibles desde el registro OCI:
- Listar versiones disponibles
helm search repo lerianstudio/midaz-helm --versions
- o revisa las etiquetas de GitHub:
2. Revisar cambios (opcional)
Compara tus valores actuales con los valores por defecto del nuevo chart:
helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.7.0 > new-defaults.yaml
3. Ejecutar la actualización
Actualiza a tu versión objetivo:
- Actualizar con valores existentes
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
--version 5.7.0 \
-n midaz \
-f midaz-values-backup.yaml
- Actualizar con nuevos valores
helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm \
--version 5.7.0 \
-n midaz \
-f my-custom-values.yaml
Si tienes valores personalizados, siempre pásalos con -f para evitar perder tu configuración durante la actualización.
4. Verificar la actualización
- Verificar estado del release
- Verificar si los pods están en ejecución
kubectl get pods -n midaz
- Revisar logs de los pods en busca de errores
Ledger (v5.x)
Legacy (v4.x)
kubectl logs -n midaz deployment/midaz-ledger --tail=50
kubectl logs -n midaz deployment/midaz-crm --tail=50
kubectl logs -n midaz deployment/midaz-onboarding --tail=50
kubectl logs -n midaz deployment/midaz-transaction --tail=50
Running y estado READY.
Actualización de plugins
Siempre actualiza Midaz Core antes de actualizar los plugins. Los plugins dependen de las APIs de Midaz Core.
CRM
A partir de Midaz v5.x, CRM está integrado en el chart de Helm principal de Midaz. El chart standalone plugin-crm solo es necesario para despliegues v4.x.
Integrado (v5.x)
Standalone (v4.x)
CRM está incluido en el chart principal de Midaz. No se necesita actualización separada.kubectl get pods -n midaz -l app=midaz-crm
helm upgrade plugin-crm oci://registry-1.docker.io/lerianstudio/plugin-crm \
--version 4.0.0 \
-n midaz \
-f plugin-crm-values-backup.yaml
kubectl get pods -n midaz -l app=plugin-crm
Fees Engine
- Actualizar plugin Fees Engine
helm upgrade plugin-fees oci://registry-1.docker.io/lerianstudio/plugin-fees-helm \
--version 4.1.2 \
-n midaz \
-f plugin-fees-values-backup.yaml
- Verificar pods de Fees Engine
kubectl get pods -n midaz -l app=plugin-fees
Pix
El plugin Pix aún está en desarrollo.
helm upgrade plugin-pix oci://registry-1.docker.io/lerianstudio/plugin-br-pix-direct-jd \
--version 1.2.6 \
-n midaz \
-f plugin-pix-values-backup.yaml
kubectl get pods -n midaz -l app=plugin-pix
