Implantação blue-green em um VPS: atualizar sem interromper o serviço
Publicado em 2026-11-14 por frfrand
Como preparar duas versões, verificar saúde, alterar Nginx e reverter com segurança.

O problema: uma atualização não deveria deixar a aplicação inacessível
Reiniciar uma aplicação diretamente sobre a única instância ativa cria uma janela de risco: se falhar a inicialização, uma dependência ou uma migração, todos os usuários notam. O implantação blue-green reduz esse risco mantendo duas versões executáveis: blue atende as requisições atuais e green recebe o novo código. Não equivale por si só a alta disponibilidade: se o VPS falhar, as duas versões caem.
Arquitetura mínima em um único VPS
Organize cada versão em um contêiner ou serviço independente, por exemplo nas portas internas 8101 e 8102. O Nginx escuta HTTPS e envia tráfego apenas ao serviço ativo. Mantenha separados os diretórios de releases, os logs e os artefatos; compartilhe apenas serviços que realmente devam ser comuns, como um banco de dados externo ou um armazenamento persistente projetado para acesso concorrente.
Um fluxo razoável é GitHub → build imutável → green → validação → troca de proxy → monitoramento. No GitHub Actions, o processo de CI deve executar testes e construir o artefato antes de entregá-lo ao VPS. Não construa sobre o diretório que está atendendo aos usuários.
Preparar o candidato sem tocar a produção
1. Baixe o commit exato e registre seu identificador. 2. Inicie o green com sua própria porta, variáveis adequadas e limites de recursos. 3. Execute verificações de conexão com o banco de dados, endpoint de saúde, autenticação e um fluxo de negócios crítico. 4. Confirme que o green pode funcionar com o esquema de banco de dados que o blue ainda está usando.
O endpoint /health não deve retornar 200 simplesmente porque o processo está vivo. Distinga liveness de readiness: uma aplicação pode funcionar como processo e não estar preparada para receber requisições.
Alterar tráfego via Nginx
Você pode manter um arquivo de upstream controlado pelo processo de implantação e alterar o servidor ativo. Depois execute nginx -t antes de recarregar o Nginx via systemctl reload nginx. Teste primeiro esta operação em um ambiente não produtivo: erros de sintaxe ou de permissão podem deixar o proxy mal configurado.
Conexões abertas e trabalhos em execução requerem atenção especial. WebSockets, requisições longas, sessões locais e filas de trabalho precisam de encerramento ordenado. Mantenha o blue disponível durante um intervalo de observação suficiente e revise latência, erros 5xx, logs e métricas de negócio.
O ponto mais perigoso: as migrações de dados
Mudar o Nginx para o blue não desfaz uma migração destrutiva. Projete primeiro mudanças de esquema compatíveis para frente e para trás: adicione colunas antes de exigi-las, implante leitores tolerantes e remova campos antigos apenas em um implante posterior. Faça cópias verificadas e documente quais seriam as consequências de reverter o código e não os dados.
Rollback testado, não improvisado
O procedimento de reversão deve estar escrito e ensaiado: identificar o release anterior, validar que ainda está saudável, restabelecer o upstream, verificar o Nginx e confirmar as operações críticas. Se o problema afetar gravações compartilhadas, talvez seja necessário interromper as mudanças e analisar a consistência antes de restaurar as informações.
Quando vale a pena
Blue-green funciona bem para APIs, painéis e SaaS com tráfego constante quando cabem duas instâncias na memória disponível. Se o VPS não suportar esse consumo duplo, considere manutenção planejada ou um segundo servidor. Para aprofundar na publicação de aplicações, consulte implantação do Next.js em VPS e Docker Compose em produção. A administração de VPS da ArduMaker pode facilitar a operação da infraestrutura, sem substituir os testes da sua aplicação.
Perguntas frequentes
### O tempo de inatividade zero é garantido? Não. Reduz interrupções por mudanças de versão, mas não elimina problemas de infraestrutura ou compatibilidade. ### Preciso de dois VPS? Não necessariamente; dois serviços isolados podem residir em um, se houver recursos. ### O que faço com os workers? Atualize-os com uma estratégia própria, evitando processar o mesmo trabalho duas vezes.