fidanf.postgresql_ha

PostgreSQL HA

Zainstaluj i skonfiguruj klaster PostgreSQL o wysokiej dostępności zarządzany przez repmgr. Dodaj zależności, rozszerzenia, bazy danych i użytkowników. Działa również dla instalacji samodzielnych.

Testowane z:

• Debian 10.x :heavy_check_mark:
• Debian 11.x :heavy_check_mark:
• Ubuntu 18.04.x :heavy_check_mark:
• Ubuntu 20.04.x :heavy_check_mark:

• PostgreSQL HA
  • Wymagania
  • Instalacja
  • Zależności
  • Przykładowy inwentarz
  • Zmienne roli
  • Przykładowy playbook
• Przydatne komendy do uruchomienia po pierwszej instalacji
  • Weryfikacja funkcjonalności klastra
  • Pokaż status klastra
  • Lista węzłów i ich atrybutów
  • Zarejestruj (sklonuj) dodatkowy węzeł zapasowy
• Zarejestruj byłego głównego jako węzeł zapasowy po automatycznym przełączeniu awaryjnym
• Licencja

Wymagania

• Python >=3.8
• Ansible-core >=2.12

Zobacz ./requirements.txt w celu uzyskania szczegółowych informacji o zależnościach użytych do rozwoju roli.

Zalecane, dla każdego hosta PostgreSQL

• Python3 w PATH
• Pip3 w PATH
• psycopg2-binary (wymaga pakietu libpq-dev)

Możesz zobaczyć prepare.yml jako przykład ustawienia dla Pythona 3.

Instalacja

Shell

ansible-galaxy collection install community.crypto
ansible-galaxy install fidanf.postgresql_ha

Plik wymagań

---
roles:
- src: https://github.com/fidanf/ansible-role-postgresql-ha
  name: fidanf.postgresql_ha
  version: master

collections:
  - community.crypto

Zależności

• cryptography (host Ansible)

Przykładowy inwentarz

Zobacz inventory.yml dla szczegółowych zmiennych grup i hostów.

Zmienne roli

Domyślne zmienne roli podzielono na dwa pliki:

• 001-postgresql.yml
• 002-repmgr.yml

Aby dokładnie zrozumieć cel i validne wartości tych zmiennych, nie wahaj się sprawdzić wszystkich szablonów Jinja w katalogu templates. Oryginalne domyślne pliki konfiguracyjne są również zawarte (.orig).

Przykładowy playbook

---
- hosts: pgcluster
  gather_facts: yes
  become: yes
  roles:
    - name: fidanf.postgresql_ha
      vars:
        # Wymagane elementy konfiguracji
        repmgr_target_group: pgcluster
        repmgr_master: pgsql01
        repmgr_failover: automatic
        repmgr_promote_command: /usr/bin/repmgr standby promote -f /etc/repmgr.conf --log-to-file
        repmgr_follow_command: /usr/bin/repmgr standby follow -f /etc/repmgr.conf --log-to-file --upstream-node-id=%n
        repmgr_monitoring_history: "yes"
        repmgr_connection_check_type: query
        repmgr_log_level: DEBUG
        repmgr_reconnect_attempts: 2
        repmgr_reconnect_interval: 10
        # Podstawowe ustawienia
        postgresql_version: 13
        postgresql_cluster_name: main
        postgresql_cluster_reset: false # TODO: Musi być przetestowane dla repmgr
        postgresql_listen_addresses: "*"
        postgresql_port: 5432
        postgresql_wal_level: "replica"
        postgresql_max_wal_senders: 10
        postgresql_max_replication_slots: 10
        postgresql_wal_keep_segments: 100
        postgresql_hot_standby: on
        postgresql_archive_mode: on
        postgresql_archive_command: "test ! -f /tmp/%f && cp %p /tmp/%f"
        postgresql_ext_install_repmgr: yes
        postgresql_shared_preload_libraries:
          - repmgr
        # logowanie w postgresql 
        postgresql_log_checkpoints: on
        postgresql_log_connections: on
        postgresql_log_disconnections: on
        postgresql_log_temp_files: 0
        # pg_hba.conf
        postgresql_pg_hba_custom:
          - { type: "host", database: "all", user: "all", address: "192.168.56.0/24", method: "md5" }
          - { type: "host", database: "replication", user: "{{ repmgr_user }}", address: "192.168.56.0/24", method: "trust" }  
          - { type: "host", database: "replication", user: "{{ repmgr_user }}", address: "127.0.0.1/32", method: "trust" }  
          - { type: "host", database: "{{ repmgr_database }}", user: "{{ repmgr_user }}", address: "127.0.0.1/32", method: "trust" }  
          - { type: "host", database: "{{ repmgr_database }}", user: "{{ repmgr_user }}", address: "192.168.56.0/32", method: "trust" }  
        # Bazy danych
        postgresql_databases:
          - name: "{{ repmgr_database }}"
            owner: "{{ repmgr_user }}"
            encoding: "UTF-8"
          - name: testdb
            owner: admin
            encoding: "UTF-8"
        # Użytkownicy
        postgresql_users:
          - name: "{{ repmgr_user }}"
            pass: "{{ repmgr_password }}"
          - name: admin
            pass: secret # PostgreSQL >=10 nie akceptuje niezabezpieczonych haseł
            encrypted: yes
        # Role
        postgresql_user_privileges:
          - name: "{{ repmgr_user }}"
            db: "{{ repmgr_database }}"
            priv: "ALL"
            role_attr_flags: "SUPERUSER,REPLICATION"
          - name: admin
            db: testdb
            role_attr_flags: "SUPERUSER"

Przydatne komendy do uruchomienia po pierwszej instalacji

Weryfikacja funkcjonalności klastra

ansible pgcluster -b --become-user postgres -m shell -a "repmgr cluster crosscheck"

Pokaż status klastra

ansible pgcluster -b --become-user postgres -m shell -a "repmgr cluster show"

Lista węzłów i ich atrybutów

ansible pgcluster -b --become-user postgres -m shell -a "repmgr node status"

Zarejestruj (sklonuj) dodatkowy węzeł zapasowy

# Zakładając, że aktualna główna nazwa hosta to pgsql01
ansible-playbook myplaybook.yml -l 'pgsql04' -e 'repmgr_primary_hostname=pgsql01' -vv 

Zarejestruj byłego głównego jako węzeł zapasowy po automatycznym przełączeniu awaryjnym

postgres@pgsql01:~$ pg_ctlcluster 13 main stop
postgres@pgsql01:~$ repmgr standby clone --force -h pgsql02 -U repmgr -d repmgr
postgres@pgsql01:~$ pg_ctlcluster 13 main start
postgres@pgsql01:~$ repmgr standby register --force

Możesz również użyć polecenia do ponownego dołączenia węzła wraz z pg_rewind

repmgr node rejoin -d repmgr -U repmgr -h pgsql02 --verbose --force-rewind=/usr/lib/postgresql/13/bin/pg_rewind

Licencja

MIT / BSD