Léim go dtí an t-ábhar

Fabhtcheartú patroni

Faisnéis

Ní mór an nós imeachta ar fad a leanúint mar root. Chun do phribhléidí a ardú go root, is féidir leat an t-ordú su - a úsáid.

Rabhadh

Chun an nós imeachta seo a leanúint, ní mór duit na cumraíochtaí breise do patronictl a bheith déanta agat.

Is ceolfhoirneoir ardinfhaighteachta do PostgreSQL é patroni. Uathoibríonn sé bainistíocht braisle PostgreSQL trí thoghchán an cheannaire, an cliseadh thar agus sioncrónú na nód a láimhseáil nuair a tharlaíonn teagmhas.

Sa bhraisle PostgreSQL de chuid CyberElements Bastion, braitheann patroni ar etcd chun staid na braisle a stóráil agus a chomhroinnt. Déanann sé monatóireacht leanúnach ar staid na n-áscanna PostgreSQL agus cinntíonn sé nach n-ainmnítear ach nód amháin mar cheannaire ag aon am ar leith.

Má theipeann ar an nód ceannaire, eagraíonn patroni toghchán go huathoibríoch tríd an stór cumraíochta dáilte etcd, chun ceannaire nua a ardú céime agus an tseirbhís a choinneáil ar fáil.

Braitheann patroni ar etcd dá bhrí sin, agus ní féidir leis oibriú i gceart mura bhfuil etcd ag obair.

Díshioncrónú nóid

Uaireanta, is féidir le nód den bhraisle PostgreSQL éirí díshioncrónaithe. Tá sé seo le feiceáil in aschur an ordaithe patronictl -c /etc/patroni/config.yml topology:

1
2
3
4
5
6
7
+ Cluster: 15-cleanroomvault5 ------+---------+---------+----+-----------+
| Member           | Host           | Role    | State   | TL | Lag in MB |
+------------------+----------------+---------+---------+----+-----------+
| PSQL_3           | psql_3         | Leader  | running | 3  |           |
| + PSQL_1         | psql_1         | Replica | running | 2  |       230 |
| + PSQL_2         | psql_2         | Replica | running | 3  |         0 |
+------------------+----------------+---------+---------+----+-----------+

Sa cholún TL, níl an nód PSQL_1 ar an TL céanna leis na nóid eile a thuilleadh. Le go n-oibreoidh an bhraisle, ní mór do gach nód a bheith ar an TL céanna: léiríonn difríocht go bhfuil ceann de na nóid díshioncrónaithe.

Sa chás seo, rith an t-ordú seo a leanas ar an nód díshioncrónaithe:

1
patronictl -c /etc/patroni/config.yml reinit 15-cleanroomvault5 <MEMBER_PATRONI>

Is é <MEMBER_PATRONI> ainm an nóid dhíshioncrónaithe, mar a thaispeántar é i gcolún Member na topeolaíochta.

Má tá roinnt nód díshioncrónaithe, athshioncrónaigh na nóid uile nach bhfuil ar an TL is airde.

Rabhadh

Más é an nód Leader an nód díshioncrónaithe, d'fhéadfaí sonraí a chailleadh. Níor cheart go dtarlódh sé seo riamh: táthar ag súil go mbeidh an nód Leader ar an TL is airde.

Sampla

In aschur an ordaithe patronictl -c /etc/patroni/config.yml topology thuas, tá an nód PSQL_1 díshioncrónaithe. Chun é a athshioncrónú, úsáid an t-ordú seo a leanas:

1
patronictl -c /etc/patroni/config.yml reinit 15-cleanroomvault5 PSQL_1

Logs

Braitheann an nós imeachta ar fad ar logaí na seirbhíse patroni, a fhaigheann tú leis an ordú thíos:

1
journalctl -u patroni

Leid

Chun na logaí a leanúint i bhfíor-am, cuir an rogha -f leis an ordú: 

1
journalctl -fu patroni

Faisnéis

Tá logaí patroni ar fáil in /var/log/syslog freisin.

Mínithe ar logaí earráide

ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379)

Nuair nach bhfuil etcd ag obair nó nach féidir teacht air, is féidir le patroni na hearráidí seo a leanas a scríobh:

1
2
3
4
5
6
7
8
patroni[1812916]: 2026-04-17 15:23:51,431 INFO: Retrying on https://<PSQL_NODE_NAME>:2379
patroni[1812916]: 2026-04-17 15:23:51,434 ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379): Max retries exceeded with url: /v3/lease/keepalive (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7f8924a49fd0>: Failed to establish a new connection: [Errno 111] Connection refused'))")
patroni[1812916]: 2026-04-17 15:23:51,434 INFO: Reconnection allowed, looking for another server.
patroni[1812916]: 2026-04-17 15:23:51,434 INFO: Retrying on https://<PSQL_NODE_NAME>:2379
patroni[1812916]: 2026-04-17 15:23:51,438 ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: MaxRetryError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379): Max retries exceeded with url: /v3/lease/keepalive (Caused by NewConnectionError('<urllib3.connection.HTTPSConnection object at 0x7f8924a48c50>: Failed to establish a new connection: [Errno 111] Connection refused'))")
patroni[1812916]: 2026-04-17 15:23:51,438 INFO: Reconnection allowed, looking for another server.
patroni[1812916]: 2026-04-17 15:23:53,940 ERROR: Request to server https://<PSQL_NODE_NAME>:2379 failed: ReadTimeoutError("HTTPSConnectionPool(host='<PSQL_NODE_NAME>', port=2379): Read timed out. (read timeout=2.0772262712319693)")
patroni[1812916]: 2026-04-17 15:23:53,940 INFO: Reconnection allowed, looking for another server.
<PSQL_NODE_NAME>

Ainm nóid de chuid na braisle PostgreSQL.

Sa chás seo, ní mór duit fabhtcheartú a dhéanamh ar etcd.