Skip to content
Scultetus Lab

Runbook — Failover (DNS + Proxy + VIP)

🎯 Objetivo

Section titled “🎯 Objetivo”

Restaurar acesso rapidamente seguindo uma ordem única: DNS -> VIP -> Proxy -> Auth -> Backend.

🚨 Sequência operacional padrão

Section titled “🚨 Sequência operacional padrão”

1. DNS

Section titled “1. DNS”
Terminal window
nslookup git.scultetus.dev.br
nslookup git.scultetus.dev.br 192.168.1.11
nslookup git.scultetus.dev.br 192.168.1.12

Se não resolver corretamente, tratar DNS antes de seguir.

2. VIP

Section titled “2. VIP”
Terminal window
ping 192.168.1.20
curl http://192.168.1.11:9080/status.json
curl http://192.168.1.10:9080/status.json

Se VIP não estiver saudável, tratar keepalived.

3. Proxy

Section titled “3. Proxy”
Terminal window
curl -k -I https://git.scultetus.dev.br
docker exec -it nginx-proxy-manager curl http://SERVICO_INTERNO

Se 502, validar backend e sincronização do NPM.

4. Autenticação

Section titled “4. Autenticação”
Terminal window
curl -k -I https://auth.scultetus.dev.br
curl http://192.168.1.11:9091/api/health
docker logs authelia

Se login falhar, validar Authelia no RPi e snippets do NPM.

5. Backend

Section titled “5. Backend”
Terminal window
curl -I http://IP_DO_SERVICO

Se backend falhar, incidente é do serviço, não do proxy.

✅ Checklist de encerramento

Section titled “✅ Checklist de encerramento”
  • domínio resolve internamente
  • VIP responde e tem apenas um MASTER
  • proxy responde sem 502
  • autenticação externa funciona
  • backend responde diretamente

🔗 Referências técnicas

Section titled “🔗 Referências técnicas”