IT заметки по программированию
IT заметки по программированию
IT заметки по программированию
IT заметки по программированию

Конфигурационный файл patroni

16.01.2024
PostgreSQL
Комментариев нет

Конфигурационный файл Patroni является центральным элементом, который задает настройки для управления кластером PostgreSQL с высокой доступностью. Он обычно представлен в формате YAML и включает параметры для взаимодействия с членами кластера, настройки репликации, подключения к DCS (Distributed Configuration Store), а также настройки для работы с сервисами, такими как etcd или Consul.

Основные секции конфигурационного файла Patroni:

  1. scope и name:
    • scope: Имя кластера PostgreSQL. Все ноды в кластере должны иметь одинаковое имя scope.
    • name: Уникальное имя для каждого экземпляра (ноды) Patroni. Обычно это имя сервера.
      YAML
      1
      2
      3
      scope: mycluster
      name: postgresql0
       
       
  2. restapi:
    • Настройки для REST API, которое предоставляет Patroni для мониторинга состояния кластера, выполнения failover’ов и других операций. Оно используется для взаимодействия между нодами.
      YAML
      1
      2
      3
      4
      restapi:
        listen: 0.0.0.0:8008
        connect_address: 192.168.1.10:8008
       
       
  3. etcd или другой DCS (например, Consul):
    • Настройки для взаимодействия Patroni с распределенным хранилищем конфигураций (DCS). Здесь вы указываете, какой сервис используется для хранения состояния кластера и его конфигурации.
      YAML
      1
      2
      3
      etcd:
        hosts: 127.0.0.1:2379
       
       
  4. postgresql:
    • Это самая большая и важная секция, которая включает параметры для настройки самого PostgreSQL. Включает параметры подключения, настройки репликации и recovery.

    Пример:

    YAML
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    postgresql:
      listen: 0.0.0.0:5432
      connect_address: 192.168.1.10:5432
      data_dir: /var/lib/postgresql/12/main
      config_dir: /etc/postgresql/12/main
      authentication:
        replication:
          username: replicator
          password: replpassword
        superuser:
          username: postgres
          password: postgrespassword
      parameters:
        max_connections: 100
        shared_buffers: 256MB
        wal_level: replica
        hot_standby: "on"
     

    • authentication: Настройки для пользователей PostgreSQL, таких как суперпользователь и репликатор.
    • parameters: Параметры конфигурации PostgreSQL (например, max_connections, shared_buffers).
  5. bootstrap:
    • Используется для инициализации новой ноды кластера. Это может включать создание суперпользователя и начальной базы данных.

    Пример:

    YAML
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    bootstrap:
      dcs:
        ttl: 30
        loop_wait: 10
        retry_timeout: 10
      initdb:
        - encoding: UTF8
        - data-checksums
      pg_hba:
        - host replication replicator 127.0.0.1/32 md5
        - host all all 0.0.0.0/0 md5
      users:
        admin:
          password: adminpassword
          options:
            - createrole
            - createdb
     

    • pg_hba: Настройки для файла pg_hba.conf, который контролирует доступ к базе данных.
    • initdb: Параметры инициализации новой базы данных.
    • users: Создание пользователей при инициализации.
  6. tags:
    • Теги, которые позволяют отмечать роли ноды в кластере, например, быть ли ноде кандидатом на роль мастера.

      YAML
      1
      2
      3
      4
      5
      6
      tags:
        nofailover: false
        noloadbalance: false
        clonefrom: false
        nosync: false
       

       

Пример полного файла конфигурации:

YAML
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
scope: mycluster
name: postgresql0
 
restapi:
  listen: 0.0.0.0:8008
  connect_address: 192.168.1.10:8008
 
etcd:
  hosts: 127.0.0.1:2379
 
postgresql:
  listen: 0.0.0.0:5432
  connect_address: 192.168.1.10:5432
  data_dir: /var/lib/postgresql/12/main
  config_dir: /etc/postgresql/12/main
  authentication:
    replication:
      username: replicator
      password: replpassword
    superuser:
      username: postgres
      password: postgrespassword
  parameters:
    max_connections: 100
    shared_buffers: 256MB
    wal_level: replica
    hot_standby: "on"
 
bootstrap:
  dcs:
    ttl: 30
    loop_wait: 10
    retry_timeout: 10
  initdb:
    - encoding: UTF8
    - data-checksums
  pg_hba:
    - host replication replicator 127.0.0.1/32 md5
    - host all all 0.0.0.0/0 md5
  users:
    admin:
      password: adminpassword
      options:
        - createrole
        - createdb
 
tags:
  nofailover: false
  noloadbalance: false
  clonefrom: false
  nosync: false
 

Как настроить конфигурацию:

  1. Настройка DCS: Это критически важно для Patroni. Вы должны указать корректные параметры для etcd, Consul или другого DCS.
  2. Репликация: Убедитесь, что пользователи для репликации правильно настроены, и файл pg_hba.conf разрешает репликацию.
  3. Параметры PostgreSQL: Все параметры конфигурации PostgreSQL задаются в секции postgresql.parameters. Например, настройки для режима реплики, количества соединений и кэширования.

Использование Patroni с TLS:

Если вы хотите использовать TLS для защиты данных, передаваемых между нодами, вы можете добавить соответствующие сертификаты в конфигурацию PostgreSQL в Patroni:

YAML
1
2
3
4
5
6
postgresql:
  ssl: "on"
  ssl_cert_file: /path/to/server.crt
  ssl_key_file: /path/to/server.key
  ssl_ca_file: /path/to/ca.crt
 

Конфигурационный файл Patroni — это гибкий инструмент для настройки и управления кластерами PostgreSQL с высокой доступностью.

Recommended Posts

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *