Pular para o conteúdo principal

Checklist pré-atualização

1
Faça backup dos releases Helm existentes:
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:
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:

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

Procedimento de rollback

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.