Prioridade e failover
Quando tens vários servidores de origem, a FortFox usa-os por prioridade — o número mais baixo é o primeiro. Os outros entram só se o principal falhar. Resultado: o teu site continua a responder mesmo quando um servidor cai.
Como a prioridade funciona
Imagina que tens três servidores configurados:
| Servidor | Prioridade |
|---|---|
https://principal.o-meu-site.com | 1 |
https://backup-1.o-meu-site.com | 10 |
https://backup-2.o-meu-site.com | 10 |
Em estado normal:
- Todos os pedidos vão ao
principal(prioridade 1, a mais baixa). - Os backups ficam idle.
Se o principal cair:
- A FortFox passa a usar os de prioridade 10.
- Como há dois com a mesma prioridade, divide pedidos entre eles (round-robin).
Quando o principal volta:
- A FortFox deteta-o saudável e regressa-lhe o tráfego.
Round-robin (mesma prioridade)
Vários servidores na mesma prioridade são iguais entre si. A FortFox alterna pedidos entre eles sem preferência. Útil quando:
- Tens uma cluster de servidores horizontal (ex.: 3 réplicas atrás de um load balancer interno).
- Queres dividir carga, não criar hierarquia.
Failover: como acontece
Sem verificação de saúde, a FortFox descobre que um servidor está em baixo ao tentar usá-lo:
- Pedido chega ao edge → escolhe o de prioridade mais baixa → ele falha (timeout ou erro 5xx) → tenta o próximo.
- O primeiro pedido demora mais (precisa de timeout antes de tentar o próximo).
- Pedidos seguintes ao mesmo servidor falhado já não esperam — a falha fica marcada em memória por uns segundos.
Com verificação de saúde ativa, o servidor em baixo é já marcado antes do pedido real. Failover é instantâneo, sem latência adicional.
Marcar como "principal"
A checkbox Marcar como servidor principal num servidor não muda como o tráfego é encaminhado (a prioridade decide isso). É apenas um marcador semântico — útil no painel para destacar visualmente qual é o que deves olhar primeiro quando há problemas.
Padrões comuns
Single primary + cold backup
principal → prioridade 1
backup-frio → prioridade 10
O backup só recebe tráfego quando o principal está em baixo. Bom para sistemas onde o backup é mais lento ou caro (ex.: replica de leitura em região distante).
Active-active (dois servidores partilham tráfego)
servidor-A → prioridade 1
servidor-B → prioridade 1
Round-robin entre os dois. Bom para distribuir carga; se um cair, todo o tráfego vai para o outro.
Tiered failover (3 níveis)
principal-rapido → prioridade 1
secundario-pago → prioridade 10
gratis-degraded → prioridade 100
Site degrada graciosamente: primeiro o servidor rápido, depois um secundário pago, finalmente um servidor gratuito que serve uma versão estática só para o site não cair completamente.
Combinar com verificação de saúde
Failover sem verificação de saúde tem custo: o primeiro pedido a cada servidor falhado leva o timeout completo (até 10 s) antes de tentar o próximo. Para um site pequeno isto pode ser aceitável; para tráfego ativo é fricção.
Com verificação ligada nos servidores principais, o edge mantém uma tabela de saúde atualizada em background. Servidores em baixo nunca são tentados — o failover é em microssegundos.
Recomendação: se tens mais de um servidor de origem, ativa sempre a verificação de saúde no principal. Custa muito pouco (1 pedido a cada 30 s) e elimina latência no failover.
Onde mexer
Sites → o teu site → Servidores → Prioridade (na linha de cada servidor).
Em mais detalhe técnico
Implementação no agent: o renderer constrói um upstream {} por site no nginx config. Servidores de baixa prioridade vão como server X (default weight 1); maior prioridade vai como server X backup. O nginx só usa os backup quando todos os principais falharam.
Round-robin determinístico: o nginx usa weighted round-robin. Sem pesos configurados, distribuição é uniforme. Cada edge mantém o seu próprio estado de cursor — não há coordenação cross-edge.
Marca de falha: depois de N falhas consecutivas (default 1), o servidor é marcado unavailable por fail_timeout segundos (default 10 s). Durante esse período é skipado completamente.
Health-check integration: quando ativa, o agent gera um health_check uri=... block do ngx_http_upstream_check_module. Resultados estão num shared dict consultado a cada pedido upstream.
Connection draining: ao mudares a prioridade de um servidor "ao vivo", conexões já abertas terminam naturalmente. Não há rebalance forçado.
Limite: até 16 servidores de origem por site na implementação atual. Pratos quentes (10+) são raros — se chegares lá, geralmente queres um load balancer dedicado antes da FortFox.
Próximos passos
- Verificação de saúde — para failover sem latência.
- Servidor de origem — fundamento.