Upgrade de versão
Como atualizar o ForgeRouter sem downtime.
Antes de atualizar
- Leia o changelog da versão de destino — mudanças de formato em
providers.yamlsão raras, mas quando acontecem são sempre documentadas ali. - Faça backup do
providers.yaml(ou do banco, se estiver usando o modo com Postgres).
Atualizando via Docker Compose
docker compose pull forgerouter
docker compose up -d forgerouterO Compose recria só o container do ForgeRouter, preservando o volume de configuração montado.
Upgrade sem downtime
Se você já roda o ForgeRouter atrás de um proxy reverso com mais de uma réplica, atualize uma réplica de cada vez e aguarde o health check dela ficar verde antes de seguir pra próxima — o mesmo princípio de qualquer deploy rolling.
Downgrade
Se algo der errado, docker compose pull forgerouter:<versão-anterior> seguido do mesmo up -d
volta pra versão anterior — desde que o providers.yaml daquele momento ainda seja compatível
(verifique o changelog antes).
Upgrades acompanhados, com plano de rollback testado antes de ir pra produção, fazem parte do serviço de manutenção da Darckware.