fidanf.postgresql_ha

PostgreSQL HA

Installer et configurer un cluster PostgreSQL à haute disponibilité géré avec repmgr. Ajouter des dépendances, des extensions, des bases de données et des utilisateurs. Fonctionne également pour les installations autonomes.

Testé avec :

• 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
  • Exigences
  • Installation
  • Dépendances
  • Exemple d'inventaire
  • Variables de rôle
  • Exemple de playbook
• Commandes utiles à exécuter après votre première installation
  • Vérifier le fonctionnement du cluster
  • Afficher l'état du cluster
  • Lister les nœuds et leurs attributs
  • Enregistrer (cloner) un nœud de secours supplémentaire
• Enregistrer l'ancien primaire en tant que nœud de secours après un basculement automatique
• Licence

Exigences

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

Voir ./requirements.txt pour le détail des dépendances utilisées pour développer le rôle.

Recommandé, pour chaque hôte PostgreSQL

• Python3 dans le PATH
• Pip3 dans le PATH
• psycopg2-binary (nécessite le paquet libpq-dev)

Vous pouvez consulter prepare.yml pour voir un exemple de configuration pour Python 3.

Installation

Shell

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

Fichier de exigences

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

collections:
  - community.crypto

Dépendances

• cryptography (hôte Ansible)

Exemple d'inventaire

Voir inventory.yml pour les variables de groupe et d'hôte détaillées.

Variables de rôle

Les variables par défaut du rôle sont divisées en deux fichiers :

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

Pour comprendre exactement le but et les valeurs valides pour chacune de ces variables, n'hésitez pas à inspecter tous les modèles Jinja dans le répertoire templates. Les fichiers de configuration par défaut originaux sont également inclus (.orig).

Exemple de playbook

---
- hosts: pgcluster
  gather_facts: yes
  become: yes
  roles:
    - name: fidanf.postgresql_ha
      vars:
        # Éléments de configuration requis
        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
        # Paramètres de base
        postgresql_version: 13
        postgresql_cluster_name: main
        postgresql_cluster_reset: false # TODO: Doit être testé pour 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
        # Journalisation de 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" }  
        # Bases de données
        postgresql_databases:
          - name: "{{ repmgr_database }}"
            owner: "{{ repmgr_user }}"
            encoding: "UTF-8"
          - name: testdb
            owner: admin
            encoding: "UTF-8"
        # Utilisateurs
        postgresql_users:
          - name: "{{ repmgr_user }}"
            pass: "{{ repmgr_password }}"
          - name: admin
            pass: secret # PostgreSQL >=10 n'accepte pas les mots de passe non cryptés
            encrypted: yes
        # Rôles
        postgresql_user_privileges:
          - name: "{{ repmgr_user }}"
            db: "{{ repmgr_database }}"
            priv: "ALL"
            role_attr_flags: "SUPERUSER,REPLICATION"
          - name: admin
            db: testdb
            role_attr_flags: "SUPERUSER"

Commandes utiles à exécuter après votre première installation

Vérifier le fonctionnement du cluster

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

Afficher l'état du cluster

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

Lister les nœuds et leurs attributs

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

Enregistrer (cloner) un nœud de secours supplémentaire

# Supposons que le nom d'hôte primaire actuel est pgsql01
ansible-playbook myplaybook.yml -l 'pgsql04' -e 'repmgr_primary_hostname=pgsql01' -vv 

Enregistrer l'ancien primaire en tant que nœud de secours après un basculement automatique

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

Ou vous pouvez utiliser le rejoin de nœud repmgr avec pg_rewind

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

Licence

MIT / BSD