Conmutar el nodo LEADER

En algunos casos de mantenimiento puede resultar útil conmutar el nodo LEADER del clúster de PostgreSQL para poder realizar operaciones en él.

Antes de poder cambiar el nodo LEADER, identifique el nodo LEADER actual del clúster de PostgreSQL y conéctese a él como root.
Una vez conectado como root al nodo LEADER, ejecute un comando similar al siguiente para provocar la conmutación inmediata:

patronictl -c /etc/patroni/config.yml failover --candidate PSQL_NODE --force

Sustituya PSQL_NODE por el nombre del nodo que pasará a ser LEADER.

Fracaso

Si el comando falla, es posible que no se hayan aplicado los siguientes parámetros: parámetros de patronictl.

Ejemplo

Para el siguiente clúster de PostgreSQL:

+ Cluster: 15-cleanroomvault5 ------+---------+---------+----+-----------+
| Member           | Host           | Role    | State   | TL | Lag in MB |
+------------------+----------------+---------+---------+----+-----------+
| PSQL_3           | psql_3         | Leader  | running | 2  |           |
| + PSQL_1         | psql_1         | Replica | running | 2  | 0         |
| + PSQL_2         | psql_2         | Replica | running | 2  | 0         |
+------------------+----------------+---------+---------+----+-----------+

El objetivo es convertir el nodo PSQL_1 en LEADER.
Por tanto, primero es necesario conectarse como root al nodo PSQL_3, que es el LEADER actual.
Una vez conectado, la ejecución del siguiente comando provoca la conmutación inmediata del LEADER hacia el nodo PSQL_1:

patronictl -c /etc/patroni/config.yml failover --candidate PSQL_1 --force

La modificación de la topología es después visible y comprobable:

+ Cluster: 15-cleanroomvault5 ------+---------+---------+----+-----------+
| Member           | Host           | Role    | State   | TL | Lag in MB |
+------------------+----------------+---------+---------+----+-----------+
| PSQL_1           | psql_1         | Leader  | running | 3  |           |
| + PSQL_3         | psql_3         | Replica | running | 3  | 0         |
| + PSQL_2         | psql_2         | Replica | running | 3  | 0         |
+------------------+----------------+---------+---------+----+-----------+