Risoluzione dei problemi di patroni¶
Informazioni
L'intera procedura deve essere eseguita come root. Per elevare i propri privilegi a root, è possibile utilizzare il comando su -.
Attenzione
Per seguire questa procedura, è necessario aver effettuato le configurazioni aggiuntive per patronictl.
patroni è un orchestratore di alta disponibilità per PostgreSQL. Automatizza la gestione di un cluster PostgreSQL occupandosi dell'elezione del leader, del failover e della sincronizzazione dei nodi in caso di incidente.
Nel cluster PostgreSQL di CyberElements Bastion, patroni si basa su etcd per archiviare e condividere lo stato del cluster. Monitora costantemente lo stato delle istanze PostgreSQL e si assicura che un solo nodo sia designato leader in un dato momento.
Se il nodo leader si guasta, patroni orchestra automaticamente un'elezione tramite l'archivio di configurazione distribuito etcd, al fine di promuovere un nuovo leader e mantenere la disponibilità del servizio.
patroni dipende quindi da etcd e non può funzionare correttamente se etcd non funziona.
Desincronizzazione di un nodo¶
Un nodo del cluster PostgreSQL può talvolta desincronizzarsi. Ciò è visibile nel risultato del comando patronictl -c /etc/patroni/config.yml topology:
1 2 3 4 5 6 7 | |
Nella colonna TL, il nodo PSQL_1 non è più sulla stessa TL degli altri. Affinché il cluster funzioni, tutti i nodi devono essere sulla stessa TL: una differenza indica che uno dei nodi è desincronizzato.
In questo caso, eseguire il comando seguente sul nodo desincronizzato:
1 | |
Dove <MEMBER_PATRONI> è il nome del nodo desincronizzato, come indicato nella colonna Member della topologia.
Se più nodi sono desincronizzati, risincronizzare tutti quelli che non sono sulla TL più alta.
Attenzione
Se il nodo desincronizzato è il nodo Leader, possono verificarsi perdite di dati. Ciò non dovrebbe mai accadere: il nodo Leader deve trovarsi sulla TL più alta.
Esempio
Nel risultato del comando patronictl -c /etc/patroni/config.yml topology riportato sopra, il nodo PSQL_1 è desincronizzato. Per risincronizzarlo, utilizzare il comando seguente:
1 | |
Log¶
L'intera procedura si basa sui log del servizio patroni, che si ottengono con il comando seguente:
1 | |
Suggerimento
Per seguire i log in tempo reale, aggiungere l'opzione -f al comando:
1 | |
Informazioni
I log di patroni sono disponibili anche in /var/log/syslog.
Spiegazione dei log di errore¶
ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)
Quando etcd non funziona o non è raggiungibile, patroni può scrivere gli errori seguenti:
1 2 3 4 5 6 7 8 | |
<PSQL_NODE_NAME>-
Nome di uno dei nodi del cluster PostgreSQL.
In questo caso, è necessario risolvere i problemi di etcd.