Saltar al contenido principal

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.

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

helm list -n midaz

​
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

Componentev3.xv4.xv5.x
Kubernetes1.20+1.20+1.20+
Helm3.8+3.8+3.8+
PostgreSQL13+13+13+
MongoDB4.4+4.4+4.4+
Valkey7.x7.x7.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

​
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
helm list -n midaz
  • Verificar si los pods están en ejecución
kubectl get pods -n midaz
  • Revisar logs de los pods en busca de errores
kubectl logs -n midaz deployment/midaz-ledger --tail=50
kubectl logs -n midaz deployment/midaz-crm --tail=50
Todos los pods deben mostrar estado 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.
CRM está incluido en el chart principal de Midaz. No se necesita actualización separada.
  • Verificar pods de CRM
kubectl get pods -n midaz -l app=midaz-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.
  • Actualizar plugin Pix
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
  • Verificar pods de Pix
kubectl get pods -n midaz -l app=plugin-pix