Pular para o conteúdo principal

​
Migrando de v3.x para v4.x

​
Checklist pré-atualização

1
Faça backup dos releases Helm existentes:
helm get values -n midaz midaz > midaz-v3-backup.yaml
2
Crítico: Faça backup dos dados e definições do RabbitMQ antes de atualizar.
3
Agende uma janela de manutenção.

​
Breaking changes no v4.x

​
Mudança da dependência do RabbitMQ para Groundhog2k

A dependência do chart RabbitMQ foi substituída de Bitnami para Groundhog2k.
Esta mudança pode levar à perda de dados do PersistentVolumeClaim (PVC) ao atualizar instalações existentes porque o StatefulSet subjacente, montagens de volume e configuração diferem da dependência anterior.
Notas importantes:
  • O chart Groundhog2k requer um cookie Erlang válido. Defina rabbitmq.authentication.erlangCookie.value para uma string imprimível de 32+ caracteres sem espaços. Se estiver ausente ou vazio, o RabbitMQ falhará ao iniciar.
  • Se você precisa preservar dados existentes, faça backup e planeje uma migração controlada de PVCs e definições antes de atualizar.
Configuração obrigatória: 
rabbitmq:
  authentication:
    erlangCookie:
      value: "<32+ printable characters without spaces>"
Esta breaking change afeta apenas deployments que usam o RabbitMQ padrão do chart (rabbitmq.enabled: true). Se você usa um RabbitMQ externo ou gerenciado, não é afetado.

​
Atualização da versão do app

O Midaz foi atualizado para v3.3.1.
Confira o changelog do app para a lista completa de mudanças.

​
Novas funcionalidades no v4.x

​
Imagens BitnamiSecure para serviços de dados core

As imagens padrão para serviços de dados core agora usam os repositórios BitnamiSecure com a tag latest:
ServiceFonte da ImagemTag
PostgreSQLBitnamiSecurelatest
MongoDBBitnamiSecurelatest
ValkeyBitnamiSecurelatest
Se você precisa fixar uma versão específica, sobrescreva a tag no values.yaml: 
postgresql:
  image:
    tag: "16.2.0"

mongodb:
  image:
    tag: "7.0.5"

valkey:
  image:
    tag: "7.2.4"

​
Imagem oficial NGINX para microfrontends

A dependência anterior do Bitnami NGINX foi substituída por um template interno baseado na imagem oficial nginx.
Se você personalizou anteriormente a configuração NGINX baseada em Bitnami, revise os novos templates em templates/console/ e ajuste seus valores adequadamente.

​
Por que mudamos as dependências do Bitnami

Nos afastamos das dependências do Bitnami devido a mudanças de política que impactavam estabilidade e operações. Para mais contexto, veja:

​
Comando de atualização

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

​
Procedimento de rollback

# Listar histórico de releases
helm history midaz -n midaz

# Rollback para versão anterior
helm rollback midaz <REVISION> -n midaz
Devido à mudança de dependência do RabbitMQ, o rollback pode exigir intervenção manual para restaurar PVCs e dados. Garanta que você tenha backups antes de atualizar.

​
Problemas comuns

RabbitMQ falha ao iniciar
  • Garanta que o cookie Erlang esteja configurado corretamente (32+ caracteres imprimíveis, sem espaços).
Perda de dados PVC do RabbitMQ
  • Isso é esperado devido à mudança de dependência. Exporte as definições do RabbitMQ antes de atualizar e restaure depois.
Problemas de configuração do NGINX
  • Revise os novos templates NGINX em templates/console/ e atualize seus overrides.