Garantire l'affidabilità e la qualità della configurazione Patroni ad alta affidabilità è fondamentale per mantenere le operazioni continue del database AlloyDB Omni e ridurre al minimo i tempi di inattività. Questa pagina fornisce una guida completa per testare il cluster Patroni, che copre vari scenari di errore, la coerenza della replica e i meccanismi di failover.
Testa la configurazione di Patroni
Connettiti a una delle tue istanze Patroni (
alloydb-patroni1,alloydb-patroni2oalloydb-patroni3) e vai alla cartella Patroni di AlloyDB Omni.cd /alloydb/
Ispeziona i log di Patroni.
sudo journalctl -u patroni
Le ultime voci dovrebbero riflettere le informazioni sul nodo Patroni. Dovresti vedere qualcosa di simile a quanto segue.
May 16 15:10:29 alloydb-patroni1 patroni[1234]: 2024-06-12 15:10:29,020 INFO: no action. I am (patroni1), the leader with the lock May 16 15:10:39 alloydb-patroni1 patroni[1234]: 2024-06-12 15:10:39,010 INFO: no action. I am (patroni1), the leader with the lock May 16 15:10:49 alloydb-patroni1 patroni[1234]: 2024-06-12 15:10:49,007 INFO: no action. I am (patroni1), the leader with the lock
Connettiti a qualsiasi istanza che esegue Linux con connettività di rete alla tua istanza Patroni principale,
alloydb-patroni1, e ottieni informazioni sull'istanza. Potresti dover installare lo strumentojqeseguendosudo dnf install jq.curl -s http://alloydb-patroni1:8008/patroni | jq .
Dovresti visualizzare un messaggio simile al seguente.
{ "state": "running", "postmaster_start_time": "2024-05-16 14:12:30.031673+00:00", "role": "master", "server_version": 150005, "xlog": { "location": 83886408 }, "timeline": 1, "replication": [ { "usename": "alloydbreplica", "application_name": "patroni2", "client_addr": "10.172.0.40", "state": "streaming", "sync_state": "async", "sync_priority": 0 }, { "usename": "alloydbreplica", "application_name": "patroni3", "client_addr": "10.172.0.41", "state": "streaming", "sync_state": "async", "sync_priority": 0 } ], "dcs_last_seen": 1715870011, "database_system_identifier": "7369600155531440151", "patroni": { "version": "3.3.0", "scope": "my-patroni-cluster", "name": "patroni1" } }
La chiamata all'endpoint API HTTP Patroni su un nodo Patroni espone vari dettagli sullo stato e sulla configurazione di quella particolare istanza PostgreSQL gestita da Patroni, tra cui informazioni sullo stato del cluster, sulla cronologia, sulle informazioni WAL e sui controlli di integrità che indicano se i nodi e il cluster sono attivi e funzionanti correttamente.
Testa la configurazione di HAProxy
Su una macchina con un browser e connettività di rete al nodo HAProxy, vai al seguente indirizzo:
http://haproxy:7000. In alternativa, puoi utilizzare l'indirizzo IP esterno dell'istanza HAProxy anziché il relativo nome host.Dovresti vedere qualcosa di simile allo screenshot seguente.
Figura 1. Pagina di stato di HAProxy che mostra lo stato di integrità e la latenza dei nodi Patroni.
Nella dashboard di HAProxy puoi visualizzare lo stato di integrità e la latenza del nodo Patroni principale,
patroni1, e delle due repliche,patroni2epatroni3.Puoi eseguire query per controllare le statistiche di replica nel cluster. Da un client come pgAdmin, connettiti al server del database primario tramite HAProxy ed esegui la seguente query.
SELECT pid, usename, application_name, client_addr, state, sync_state FROM pg_stat_replication;Dovresti vedere un diagramma simile al seguente, che mostra che
patroni2epatroni3trasmettono in streaming dapatroni1.
Figura 2. Output di pg_stat_replication che mostra lo stato di replica dei nodi Patroni.
Testa il failover automatico
In questa sezione, nel cluster a tre nodi, simuliamo un'interruzione sul nodo principale arrestando il container Patroni in esecuzione collegato. Puoi interrompere il servizio Patroni sul nodo primario per simulare un'interruzione o applicare alcune regole firewall per interrompere la comunicazione con quel nodo.
Nell'istanza Patroni principale, vai alla cartella Patroni di AlloyDB Omni.
cd /alloydb/
Arresta il container.
sudo systemctl stop patroni
Dovresti vedere un output simile al seguente. In questo modo, dovresti verificare che il container e la rete siano stati arrestati.
patroni.service - Runner for Patroni Loaded: loaded (/etc/systemd/system/patroni.service; enabled; vendor preset: disabled) Active: inactive (dead) since ...
Aggiorna la dashboard di HAProxy e osserva come avviene il failover.
Figura 3. Dashboard HAProxy che mostra il failover dal nodo principale al nodo di riserva.
L'istanza
patroni3è diventata la nuova istanza principale epatroni2è l'unica replica rimanente. L'istanza principale precedente,patroni1, non è attiva e i controlli di integrità non vanno a buon fine.Patroni esegue e gestisce il failover tramite una combinazione di monitoraggio, consenso e orchestrazione automatizzata. Non appena il nodo principale non riesce a rinnovare il lease entro un timeout specificato o se segnala un errore, gli altri nodi del cluster riconoscono questa condizione tramite il sistema di consenso. I nodi rimanenti si coordinano per selezionare la replica più adatta da promuovere come nuova istanza principale. Una volta selezionata una replica candidata, Patroni promuove questo nodo a principale applicando le modifiche necessarie, ad esempio aggiornando la configurazione di PostgreSQL e riproducendo eventuali record WAL in sospeso. Poi, il nuovo nodo principale aggiorna il sistema di consenso con il suo stato e le altre repliche si riconfigurano per seguire il nuovo nodo principale, ad esempio cambiando l'origine della replica e potenzialmente recuperando eventuali nuove transazioni. HAProxy rileva il nuovo nodo principale e reindirizza le connessioni client di conseguenza, garantendo un'interruzione minima.
Da un client come pgAdmin, connettiti al server di database tramite HAProxy e controlla le statistiche di replica nel cluster dopo il failover.
SELECT pid, usename, application_name, client_addr, state, sync_state FROM pg_stat_replication;Dovresti vedere un diagramma simile al seguente, che mostra che solo
patroni2è in streaming ora.
Figura 4. Output di pg_stat_replication che mostra lo stato di replica dei nodi Patroni dopo il failover.
Il tuo cluster di tre nodi può sopravvivere a un'altra interruzione. Se interrompi l'attuale nodo principale,
patroni3, viene eseguito un altro failover.
Figura 5. Dashboard HAProxy che mostra il failover dal nodo principale,
patroni3, al nodo di riserva,patroni2.
Considerazioni sul fallback
Il fallback è il processo per reintegrare il nodo di origine precedente dopo un failover. In genere, il fallback automatico non è consigliato in un cluster di database ad alta affidabilità a causa di diversi problemi critici, come il recupero incompleto, il rischio di scenari split-brain e il ritardo di replica.
Nel cluster Patroni, se attivi i due nodi con cui hai simulato un'interruzione, questi si uniranno nuovamente al cluster come repliche in standby.
Immagine 6. Dashboard HAProxy che mostra il ripristino di patroni1 e
patroni3 come nodi in standby.
Ora patroni1 e patroni3 vengono replicate dall'istanza principale attuale patroni2.
Figura 7. Output di pg_stat_replication che mostra lo stato di replica dei nodi Patroni dopo il fallback.
Se vuoi eseguire manualmente il failback alla tua istanza principale iniziale, puoi farlo utilizzando l'interfaccia a riga di comando patronictl. Scegliendo il fallback manuale, puoi garantire un processo di recupero più affidabile, coerente e accuratamente verificato, mantenendo l'integrità e la disponibilità dei tuoi sistemi di database.