Skip to main content

Lista de verificación previa a la actualización

1
Respalda los Helm releases existentes:
2
Crítico: respalda los datos y las definiciones de RabbitMQ antes de actualizar.
3
Programa una ventana de mantenimiento.

Cambios incompatibles en v4.x

Cambio de la dependencia de RabbitMQ a Groundhog2k

La dependencia del chart de RabbitMQ cambió de Bitnami a Groundhog2k.
Este cambio puede provocar pérdida de datos de PersistentVolumeClaim (PVC) al actualizar instalaciones existentes, porque el StatefulSet subyacente, los volume mounts y la configuración difieren de la dependencia anterior.
Notas importantes:
  • El chart de Groundhog2k requiere una cookie de Erlang válida. Define rabbitmq.authentication.erlangCookie.value como una cadena imprimible de 32 caracteres o más, sin espacios. Si falta o está vacía, RabbitMQ no arranca.
  • Si necesitas preservar los datos existentes, respalda y planifica una migración controlada de los PVC y las definiciones antes de actualizar.
Configuración obligatoria:
Este cambio incompatible solo afecta a los despliegues que usan el RabbitMQ predeterminado del chart (rabbitmq.enabled: true). Si ejecutas un RabbitMQ externo o gestionado, no te afecta.

Cambio de versión de la aplicación

Midaz pasa a v3.3.1.
Consulta el changelog de la aplicación para ver la lista completa de cambios.

Funcionalidades nuevas en v4.x

Imágenes de BitnamiSecure para los servicios de datos principales

Las imágenes predeterminadas de los servicios de datos principales ahora usan los repositorios de BitnamiSecure con el tag latest: Si necesitas fijar una versión específica, sobrescribe el tag en values.yaml:

Imagen oficial de NGINX para los microfrontends

El chart reemplazó la dependencia de NGINX de Bitnami por una plantilla interna basada en la imagen oficial nginx.
Si personalizaste antes la configuración de NGINX basada en Bitnami, revisa las plantillas nuevas en templates/console/ y ajusta tus values según corresponda.

Por qué cambiamos las dependencias de Bitnami

Dejamos las dependencias de Bitnami por cambios de política que afectan la estabilidad y las operaciones. Para más contexto, consulta:

Comando de actualización

Procedimiento de rollback

Debido al cambio de la dependencia de RabbitMQ, el rollback puede requerir intervención manual para restaurar los PVC y los datos. Confirma que tienes respaldos antes de actualizar.

Problemas comunes

RabbitMQ no arranca
  • Verifica que configuraste la cookie de Erlang correctamente (32 caracteres imprimibles o más, sin espacios).
Pérdida de datos de PVC de RabbitMQ
  • Espera que ocurra después del cambio de dependencia. Exporta las definiciones de RabbitMQ antes de actualizar y restáuralas después.
Problemas de configuración de NGINX
  • Revisa las plantillas nuevas de NGINX en templates/console/ y actualiza tus overrides.