Saltar al contenido principal

​
Migrando de v3.x a v4.x

​
Lista de verificación previa a la actualización

1
Respalda los releases de Helm existentes:
helm get values -n midaz midaz > midaz-v3-backup.yaml
2
Crítico: Respalda los datos y definiciones de RabbitMQ antes de actualizar.
3
Programa una ventana de mantenimiento.

​
Cambios importantes en v4.x

​
Cambio de dependencia de RabbitMQ a Groundhog2k

La dependencia del chart de RabbitMQ ha sido reemplazada de Bitnami a Groundhog2k.
Este cambio puede provocar pérdida de datos de PersistentVolumeClaim (PVC) al actualizar instalaciones existentes porque el StatefulSet subyacente, montajes de volumen y configuración difieren de la dependencia anterior.
Notas importantes:
  • El chart de Groundhog2k requiere una cookie de Erlang válida. Configura rabbitmq.authentication.erlangCookie.value con una cadena imprimible de 32+ caracteres sin espacios. Si falta o está vacía, RabbitMQ fallará al iniciar.
  • Si necesitas preservar datos existentes, respalda y planifica una migración controlada de PVCs y definiciones antes de actualizar.
Configuración requerida: 
rabbitmq:
  authentication:
    erlangCookie:
      value: "<32+ caracteres imprimibles sin espacios>"
Este cambio importante solo afecta a despliegues que usan el RabbitMQ predeterminado del chart (rabbitmq.enabled: true). Si ejecutas un RabbitMQ externo o gestionado, no te afecta.

​
Actualización de versión de la aplicación

Midaz ha sido actualizado a v3.3.1.
Consulta el changelog de la aplicación para la lista completa de cambios.

​
Nuevas características en v4.x

​
Imágenes BitnamiSecure para servicios de datos principales

Las imágenes predeterminadas para servicios de datos principales ahora usan los repositorios BitnamiSecure con la etiqueta latest:
ServicioFuente de imagenEtiqueta
PostgreSQLBitnamiSecurelatest
MongoDBBitnamiSecurelatest
ValkeyBitnamiSecurelatest
Si requieres fijar una versión específica, anula la etiqueta en values.yaml: 
postgresql:
  image:
    tag: "16.2.0"

mongodb:
  image:
    tag: "7.0.5"

valkey:
  image:
    tag: "7.2.4"

​
Imagen oficial NGINX para microfrontends

La dependencia anterior de NGINX de Bitnami fue reemplazada con una plantilla interna basada en la imagen oficial nginx.
Si previamente personalizaste la configuración de NGINX basada en Bitnami, revisa las nuevas plantillas en templates/console/ y ajusta tus valores en consecuencia.

​
Por qué cambiamos las dependencias de Bitnami

Nos alejamos de las dependencias de Bitnami debido a cambios de políticas que afectan la estabilidad y las operaciones. Para más contexto, consulta:

​
Comando de actualización

helm upgrade midaz oci://registry-1.docker.io/lerianstudio/midaz-helm --version 4.0.0 -n midaz

​
Procedimiento de reversión

# Listar historial de releases
helm history midaz -n midaz

# Revertir a la versión anterior
helm rollback midaz <REVISION> -n midaz
Debido al cambio de dependencia de RabbitMQ, la reversión puede requerir intervención manual para restaurar PVCs y datos. Asegúrate de tener respaldos antes de actualizar.

​
Problemas comunes

RabbitMQ falla al iniciar
  • Asegúrate de que la cookie de Erlang esté configurada correctamente (32+ caracteres imprimibles, sin espacios).
Pérdida de datos de PVC de RabbitMQ
  • Esto es esperado debido al cambio de dependencia. Exporta las definiciones de RabbitMQ antes de actualizar y restáuralas después.
Problemas de configuración de NGINX
  • Revisa las nuevas plantillas de NGINX en templates/console/ y actualiza tus overrides.