Executar um switchover planejado com Patroni

Comando

# Immediate switchover without confirmation:
patronictl -c /etc/patroni/patroni.yml switchover <cluster> --leader <leader_member> --candidate <member> --force
# Scheduled switchover (ISO 8601 timestamp with time zone):
patronictl -c /etc/patroni/patroni.yml switchover <cluster> --leader <leader_member> --candidate <member> --scheduled '2026-10-10T02:00:00+03:00' --force
# Cancel a pending scheduled switchover:
patronictl -c /etc/patroni/patroni.yml flush <cluster> switchover

O que faz

Rebaixa o leader saudável de forma controlada e promove a réplica escolhida (--candidate); o antigo leader volta automaticamente como réplica do novo leader. --scheduled adia a operação para o horário indicado.

Quando usar

Para mover o primário para outro nó antes de uma manutenção (patch do SO, troca de hardware, upgrade de versão minor) ou para restaurar os papéis originais após um failover.

Atenção

Todas as conexões caem quando o leader muda; a aplicação precisa conseguir reconectar. O Patroni rejeita o switchover se o lag do candidato exceder maximum_lag_on_failover. Com synchronous_mode habilitado, o candidato deve ser um standby síncrono.