Rol de Ansible: PgBouncer

Este rol instala y configura el agrupador de conexiones PgBouncer para PostgreSQL.

Ha sido diseñado solo para funcionar en Ubuntu 16.04, pero otras versiones de Debian también deberían funcionar.

Requisitos

Ninguno.

Variables del Rol

El arreglo pgbouncer_databases permite una configuración de base de datos muy dinámica. Cualquier propiedad permitida en la cadena de conexión se puede definir en este arreglo y se añadirá automáticamente a la definición del alias. El ejemplo a continuación configura un alias de base de datos dev que agrupa conexiones a la base de datos postgres en postgres:5432 conectándose como foo:md5asdofiasodfa09f9832f. Puedes definir más bases de datos de la misma manera.

pgbouncer_databases:
  - dev:
      host: postgres # o la dirección IP real
      port: 5432
      dbname: postgres
      user: foo
      password: md5asdofiasodfa09f9832f

Este rol también puede instalar opcionalmente el paquete postgresql-client para acceso a la línea de comandos de PostgreSQL o PgBouncer. Para instalar este paquete, establece pgbouncer_install_psql: true.

La plantilla de configuración permite que algunos valores sean sobrescritos. Para lograr esto, crea una variable nombrada en función de la propiedad de configuración que quieres cambiar y prefíjela con pgbouncer_. Por ejemplo, para sobrescribir el listen_port predeterminado de 6432, pasa una variable llamada pgbouncer_listen_port. Consulta el archivo de plantilla para ver otras configuraciones que se pueden sobrescribir de esta manera. Ten en cuenta que no todas las configuraciones están disponibles, solo algunas comunes que uso.

Nota: Algunas variables esperan un arreglo - debería ser obvio cuáles son.

Consulta el archivo defaults/main.yml para más descripciones de otras variables. También deberías revisar templates/pgbouncer.ini.j2 por posibles variables adicionales que puedes establecer.

pgbouncer_install_state: Esto es útil para actualizar PgBouncer a versiones más nuevas después de que ya se haya instalado. Usa latest para lograr esta funcionalidad.

Recursos

La documentación relacionada con PgBouncer se puede encontrar en los siguientes enlaces:

• documentación
• repositorio de github

Dependencias

Ninguna.

Ejemplo de Playbook

- hosts: servers
  become: yes

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

Licencia

MIT