Saltar para o conteúdo

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.

4 min de leitura

Como a prioridade funciona

Imagina que tens três servidores configurados:

ServidorPrioridade
https://principal.o-meu-site.com1
https://backup-1.o-meu-site.com10
https://backup-2.o-meu-site.com10

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

← Toda a documentação