Rôle Ansible : PgBouncer

Ce rôle installe et configure le pooler de connexions PgBouncer pour PostgreSQL.

Il a été conçu uniquement pour fonctionner sur Ubuntu 16.04, mais d'autres distributions Debian devraient également fonctionner.

Exigences

Aucune.

Variables du rôle

Le tableau pgbouncer_databases permet une configuration de base de données très dynamique. Toute propriété autorisée dans la chaîne de connexion peut être définie dans ce tableau et sera automatiquement ajoutée à la définition de l'alias. L'exemple ci-dessous configure un alias de base de données dev qui regroupe les connexions à la base de données postgres sur postgres:5432 en se connectant en tant que foo:md5asdofiasodfa09f9832f. Vous pouvez définir d'autres bases de données de la même manière.

pgbouncer_databases:
  - dev:
      host: postgres # ou l'adresse IP réelle
      port: 5432
      dbname: postgres
      user: foo
      password: md5asdofiasodfa09f9832f

Ce rôle peut également installer optionnellement le paquet postgresql-client pour un accès en ligne de commande à PostgreSQL ou PgBouncer. Pour installer ce paquet, définissez pgbouncer_install_psql: true.

Le modèle de configuration permet de remplacer certaines valeurs. Pour cela, créez une variable nommée d'après la propriété de configuration que vous souhaitez changer et préfixez-la avec pgbouncer_. Par exemple, pour remplacer le listen_port par défaut de 6432, passez une variable nommée pgbouncer_listen_port. Consultez le fichier modèle pour d'autres configurations qui peuvent être remplacées de cette manière. Notez que toutes les configurations ne sont pas disponibles, seulement quelques-unes communes que j'utilise.

Remarque : Certaines variables s'attendent à un tableau - cela devrait être évident.

Voir le fichier defaults/main.yml pour plus de descriptions sur d'autres variables. Vous devriez également vérifier templates/pgbouncer.ini.j2 pour des variables supplémentaires que vous pouvez définir.

pgbouncer_install_state : Cela est utile pour mettre à jour PgBouncer vers de nouvelles versions après qu'il ait déjà été installé. Utilisez latest pour obtenir cette fonctionnalité.

Ressources

La documentation relative à PgBouncer peut être trouvée aux liens ci-dessous :

• documentation
• dépôt github

Dépendances

Aucune.

Exemple de Playbook

- hosts: servers
  become: yes

  roles:
    - role: jradtilbrook.pgbouncer
      pgbouncer_databases:
        - testing:
            host: postgres
            port: 5432
            dbname: postgres

Licence

MIT