fidanf.postgresql_ha

PostgreSQL HA

Installieren und konfigurieren Sie einen hochverfügbaren PostgreSQL-Cluster, der mit repmgr verwaltet wird. Fügen Sie Abhängigkeiten, Erweiterungen, Datenbanken und Benutzer hinzu. Funktioniert auch für eigenständige Installationen.

Getestet mit:

• 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
  • Anforderungen
  • Installation
  • Abhängigkeiten
  • Beispiel-Inventory
  • Rollenvariablen
  • Beispiel-Playbook
• Nützliche Befehle nach der ersten Installation ausführen
  • Cluster-Funktionalität überprüfen
  • Clusterstatus anzeigen
  • Knoten und ihre Attribute auflisten
  • Einen zusätzlichen Standby-Knoten registrieren (klonen)
• Ehemaligen Primärknoten nach automatischem Failover als Standby-Knoten registrieren
• Lizenz

Anforderungen

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

Siehe ./requirements.txt für detaillierte Abhängigkeiten, die zur Entwicklung der Rolle verwendet werden.

Empfohlen für jeden PostgreSQL-Host

• Python3 im PATH
• Pip3 im PATH
• psycopg2-binary (benötigt das libpq-dev apt-Paket)

Sie können sich prepare.yml ansehen, um ein Beispiel-Setup für Python 3 zu überprüfen.

Installation

Shell

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

Anforderungsdatei

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

collections:
  - community.crypto

Abhängigkeiten

• cryptography (ansible-Host)

Beispiel-Inventory

Siehe inventory.yml für detaillierte Gruppen- und Hostvariablen.

Rollenvariablen

Die standardmäßigen Rollenvariablen sind auf zwei Dateien verteilt:

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

Um den Zweck und die gültigen Werte jeder dieser Variablen genau zu verstehen, zögern Sie nicht, alle Jinja-Templates im Verzeichnis templates zu überprüfen. Original-Konfigurationsdateien sind ebenfalls enthalten (.orig).

Beispiel-Playbook

---
- hosts: pgcluster
  gather_facts: yes
  become: yes
  roles:
    - name: fidanf.postgresql_ha
      vars:
        # Erforderliche Konfigurationselemente
        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
        # Grundlegende Einstellungen
        postgresql_version: 13
        postgresql_cluster_name: main
        postgresql_cluster_reset: false # TODO: Muss für repmgr getestet werden
        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
        # PostgreSQL-Logging 
        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" }  
        # Datenbanken
        postgresql_databases:
          - name: "{{ repmgr_database }}"
            owner: "{{ repmgr_user }}"
            encoding: "UTF-8"
          - name: testdb
            owner: admin
            encoding: "UTF-8"
        # Benutzer
        postgresql_users:
          - name: "{{ repmgr_user }}"
            pass: "{{ repmgr_password }}"
          - name: admin
            pass: secret # PostgreSQL >=10 akzeptiert keine unverschlüsselten Passwörter
            encrypted: yes
        # Rollen
        postgresql_user_privileges:
          - name: "{{ repmgr_user }}"
            db: "{{ repmgr_database }}"
            priv: "ALL"
            role_attr_flags: "SUPERUSER,REPLICATION"
          - name: admin
            db: testdb
            role_attr_flags: "SUPERUSER"

Nützliche Befehle nach der ersten Installation ausführen

Cluster-Funktionalität überprüfen

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

Clusterstatus anzeigen

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

Knoten und ihre Attribute auflisten

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

Einen zusätzlichen Standby-Knoten registrieren (klonen)

# Angenommen, der aktuelle Primärknoten heißt pgsql01
ansible-playbook myplaybook.yml -l 'pgsql04' -e 'repmgr_primary_hostname=pgsql01' -vv 

Ehemaligen Primärknoten nach automatischem Failover als Standby-Knoten registrieren

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

Oder Sie können die repmgr node rejoin mit pg_rewind verwenden

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

Lizenz

MIT / BSD