Guía de 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

​

Actualización de Midaz core

​

1. Verificar versiones disponibles

• Listar versiones disponibles

helm search repo lerianstudio/midaz-helm --versions

• o revisa las etiquetas de GitHub:
  • Visita https://github.com/LerianStudio/helm/tags
  • Filtra por el prefijo “midaz-v”

​

2. Revisar cambios (opcional)

helm show values oci://registry-1.docker.io/lerianstudio/midaz-helm --version 5.7.0 > new-defaults.yaml

​

3. Ejecutar la actualización

• 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

​

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

kubectl logs -n midaz deployment/midaz-onboarding --tail=50
kubectl logs -n midaz deployment/midaz-transaction --tail=50

​

Actualización de plugins

​

CRM

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

• 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