Duas ou mais cópias da API atendem por trás de um balanceador. A publicação substitui cópias gradualmente, sem retirar todas ao mesmo tempo. Réplicas em máquinas diferentes podem proteger também contra perda de uma máquina, desde que os demais componentes tenham resiliência.

Duas réplicas da aplicação não significam dois bancos. Neste exemplo, ambas usam um banco compartilhado. Uma falha nele pode afetar todas.

Antes de começar

  • Todas as cópias recebem a mesma versão identificada; dados persistentes não dependem de um disco local descartável.
  • O balanceador detecta prontidão e permite retirar destinos de novas requisições.
  • As réplicas restantes suportam a carga ou uma cópia adicional pode ser iniciada antes da retirada.
  • Sessões, caches, arquivos e mensagens permitem coexistência das versões.
  • A migração é uma tarefa única e controlada; cada réplica não tenta executá-la ao iniciar.

Duas réplicas: troca gradual

Se B não suporta sozinho a carga, iniciar uma réplica extra antes de retirar A. O rollout só avança após verificações.

Fluxo completo

  1. Receber a versão homologada e registrar configuração, migração e critério de interrupção.
  2. Preparar o banco de modo compatível e verificar saúde antes de substituir processos.
  3. Retirar A de novas requisições e aguardar o trabalho em andamento. Se houver capacidade extra, iniciar a nova antes dessa retirada.
  4. Instalar/iniciar a nova versão de A e testar diretamente a réplica. Mantê-la fora do atendimento até ficar pronta.
  5. Devolver A ao balanceador. Verificar métricas por versão e por réplica, além das métricas globais.
  6. Observar pelo tempo e volume de operações adequados. Pouco tráfego exige testes sintéticos e observação maior; ausência de erros sem uso não comprova segurança.
  7. Repetir para B e depois para outros grupos. Uma degradação interrompe a expansão.
  8. Verificar o conjunto final, conexões e fila de tarefas; registrar conclusão e reter versões e evidências para recuperação.

Rolling, blue-green e canary neste cenário

Técnica Diferença
Rolling update Substituir grupos progressivamente, com capacidade mínima preservada. É a base deste exemplo.
Blue-green Preparar um conjunto completo novo, testar e transferir o atendimento; requer recursos temporários maiores.
Canary Controlar uma parcela representativa de tráfego/usuários para a versão nova antes de expandir. Uma réplica de duas não garante exatamente metade das requisições.

São variações para controlar a transição, não obrigação de usar Kubernetes. Percentuais e número de réplicas não substituem evidências de saúde.

Atualização do banco e dos contratos

Durante a atualização, réplicas antigas e novas podem operar simultaneamente. O banco, os contratos de API e os consumidores de mensagens devem permanecer compatíveis durante essa janela. Para um exemplo completo de migração em etapas, consulte Um servidor: releases, current e troca de processos.

  • Adicionar campo obrigatório sem valor para registros existentes pode falhar. Alterar tipo, semântica ou formato pode quebrar mesmo sem remover colunas.
  • Alterar esquema compartilhado pode afetar todas as réplicas de uma vez; canary da aplicação não isola esse impacto.
  • APIs novas precisam continuar atendendo frontends antigos que estão em abas abertas ou caches. Novos frontends não devem exigir uma API ainda ausente em parte do conjunto.
  • Medir bloqueios e custo da migração; online não significa ausência absoluta de locks. Uma migração pode exigir manutenção mesmo com muitas réplicas.

Falhas e recuperação por ponto

Falha Ação
Preparação ou migração falha Interromper antes de trocar réplicas. Se afetou o banco, conter o impacto compartilhado e recuperar conforme o estado real.
A não fica pronta Não recebe tráfego. B continua atendendo; recuperar A e a capacidade antes de avançar.
A falha depois de receber tráfego Retirar A, manter B antiga se saudável e capaz, verificar dados produzidos por A e retornar/corrigir.
B falha enquanto A nova atende Não avançar nem remover A cegamente. Garantir capacidade com uma versão saudável compatível ou adicionar outra réplica.
Todas já estão novas e surge defeito Retornar gradualmente à versão anterior se compatível; caso contrário, desativar função, corrigir para frente ou usar manutenção.
Dado errado no banco Conter escritores, identificar registros e corrigir seletivamente. Voltar réplicas não desfaz dados.
Balanceador, banco ou cache compartilhado falha Acionar recuperação desse componente. Mais réplicas da API não resolvem a falha compartilhada.

Workers de fila: procedimento próprio

  1. Iniciar consumidores novos compatíveis com as mensagens e com o banco.
  2. Nos consumidores antigos, interromper a busca de novas tarefas e permitir concluir as já iniciadas.
  3. Confirmar conclusão conforme o protocolo da fila; encerrar somente após drenagem ou uma decisão explícita de recuperação.
  4. Se houver interrupção, usar a política de reentrega/visibilidade do sistema. Projetar processamento idempotente: repetir uma tarefa não deve cobrar ou executar efeitos externos duas vezes.
  5. Versionar mensagens quando necessário e verificar produtores, consumidores e jobs antigos. Controlar retries e uma fila de falhas para tarefas que não podem ser processadas.

Cancelar o consumo não significa automaticamente devolver todas as tarefas em andamento; o comportamento depende do broker e da biblioteca. Um efeito externo pode ter ocorrido antes da confirmação da tarefa, exigindo deduplicação ou reconciliação.

Bugfixes, hotfixes e critérios de conclusão

Correções comuns seguem nova release e rollout gradual. Em incidente, avaliar retirar a versão problemática ou desativar a funcionalidade antes de escrever o patch. Hotfix recebe revisão e teste prioritários; reduzir observação exige responsável e risco explícitos. A correção precisa ser aplicada também às versões afetadas que ainda recebem manutenção.

  • Erros e latência dentro dos limites definidos, com volume representativo.
  • Jornadas de negócio corretas; processo vivo não basta.
  • Capacidade, filas, conexões e banco saudáveis.
  • Versões realmente executadas conferidas em cada réplica.
  • Janela de rollback mantida e retirada de estruturas antigas adiada até ser segura.

Fontes e aprofundamento

Referências consultadas em 2 de novembro de 2026. Os procedimentos são modelos conceituais: parâmetros, comandos e garantias dependem da tecnologia e precisam ser ensaiados.

Outros artigos da série