Skip to main content

​
Checklist antes do upgrade

1
Faça backup dos releases Helm existentes:
2
Crítico: faça backup dos dados e das definições do RabbitMQ antes do upgrade.
3
Agende uma janela de manutenção.

​
Mudanças incompatíveis na v4.x

​
Mudança da dependência RabbitMQ para Groundhog2k

A dependência de chart do RabbitMQ mudou de Bitnami para Groundhog2k.
Essa mudança pode causar perda de dados de PersistentVolumeClaim (PVC) ao fazer upgrade de instalações existentes, porque o StatefulSet, os volume mounts e a configuração subjacentes são diferentes da dependência anterior.
Notas importantes:
  • O chart Groundhog2k exige um Erlang cookie válido. Defina rabbitmq.authentication.erlangCookie.value como um texto imprimível de 32+ caracteres sem espaços. Se estiver ausente ou vazio, o RabbitMQ não inicia.
  • Se você precisa preservar dados existentes, faça backup e planeje uma migração controlada dos PVCs e das definições antes do upgrade.
Configuração obrigatória:
Essa mudança incompatível afeta apenas deploys que usam o RabbitMQ padrão do chart (rabbitmq.enabled: true). Se você roda um RabbitMQ externo ou gerenciado, não é afetado.

​
Aumento da versão da aplicação

O Midaz passa para a v3.3.1.
Consulte o changelog da aplicação para a lista completa de mudanças.

​
Novos recursos na v4.x

​
Imagens BitnamiSecure para os serviços de dados principais

As imagens padrão dos serviços de dados principais agora usam os repositórios BitnamiSecure com a tag latest: Se você precisa fixar uma versão específica, sobrescreva a tag em values.yaml:

​
Imagem oficial do NGINX para os microfrontends

O chart substituiu a dependência NGINX da Bitnami por um template interno baseado na imagem nginx oficial.
Se você tinha customizado a configuração do NGINX baseada na Bitnami, revise os novos templates em templates/console/ e ajuste seus values conforme necessário.

​
Por que mudamos as dependências Bitnami

Saímos das dependências Bitnami por causa de mudanças de política que afetam a estabilidade e a operação. Para mais contexto, consulte:

​
Comando de upgrade

​
Procedimento de rollback

Por causa da mudança na dependência do RabbitMQ, o rollback pode exigir intervenção manual para restaurar PVCs e dados. Garanta que você tem backups antes do upgrade.

​
Problemas comuns

O RabbitMQ não inicia
  • Confirme que você definiu o Erlang cookie corretamente (32+ caracteres imprimíveis, sem espaços).
Perda de dados do PVC do RabbitMQ
  • Espere isso depois da mudança de dependência. Exporte as definições do RabbitMQ antes do upgrade e restaure depois.
Problemas de configuração do NGINX
  • Revise os novos templates do NGINX em templates/console/ e atualize seus overrides.