silverlogic.postgresql

Descripción general Versiones Perspectivas

ANXS - PostgreSQL

¡Se necesita ayuda! Si puedes y estás dispuesto a ayudar a mantener este rol de Ansible, por favor abre un problema en GitHub. Muchas personas parecen usar este rol y nosotros (obviamente) necesitamos asistencia. 💖

Rol de Ansible que instala y configura PostgreSQL, extensiones, bases de datos y usuarios.

Instalación

Esto ha sido probado en Ansible 2.4.0 y versiones superiores.

Para instalar:

ansible-galaxy install ANXS.postgresql

Ejemplo de Playbook

Incluyendo un ejemplo de cómo usar tu rol:

- hosts: postgresql-server
  become: yes
  roles:
     - { role: anxs.postgresql }

Dependencias

ANXS.monit (Galaxy/GH) si deseas protección con monit (en ese caso, debes configurar monit_protection: true)

Matriz de compatibilidad

Distribución / PostgreSQL	<= 9.3	9.4	9.5	9.6	10	11	12
Ubuntu 14.04	:no_entry:	:no_entry:	:no_entry:	:no_entry:	:no_entry:	:no_entry:	:no_entry:
Ubuntu 16.04	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
Debian 8.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
Debian 9.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
CentOS 6.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
CentOS 7.x	:no_entry:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:	:white_check_mark:
CentOS 8.x	:no_entry:	:grey_question:	:grey_question:	:grey_question:	:grey_question:	:grey_question:	:grey_question:
Fedora latest	:no_entry:	:x:	:x:	:x:	:x:	:x:	:x:

:white_check_mark: - probado, funciona bien
:warning: - No para uso en producción
:grey_question: - funcionará en el futuro (ayuda si puedes)
:interrobang: - puede funcionar, no probado
:no_entry: - Ha alcanzado el final de su vida útil (EOL)

Variables

# Configuraciones básicas
postgresql_version: 12
postgresql_encoding: "UTF-8"
postgresql_locale: "en_US.UTF-8"
postgresql_ctype: "en_US.UTF-8"

postgresql_admin_user: "postgres"
postgresql_default_auth_method: "peer"

postgresql_service_enabled: false # ¿debe estar habilitado el servicio? el valor predeterminado es true

postgresql_cluster_name: "main"
postgresql_cluster_reset: false

# Lista de bases de datos a crear (opcional)
# Nota: para más flexibilidad con las extensiones, usa la configuración postgresql_database_extensions.
postgresql_databases:
  - name: foobar
    owner: baz          # opcional; especifica el propietario de la base de datos
    hstore: yes         # bandera para instalar la extensión hstore en esta base de datos (yes/no)
    uuid_ossp: yes      # bandera para instalar la extensión uuid-ossp en esta base de datos (yes/no)
    citext: yes         # bandera para instalar la extensión citext en esta base de datos (yes/no)
    encoding: "UTF-8"   # anular variable global {{ postgresql_encoding }} por base de datos
    lc_collate: "en_GB.UTF-8"   # anular variable global {{ postgresql_locale }} por base de datos
    lc_ctype: "en_GB.UTF-8"     # anular variable global {{ postgresql_ctype }} por base de datos

# Lista de extensiones de base de datos a crear (opcional)
postgresql_database_extensions:
  - db: foobar
    extensions:
      - hstore
      - citext

# Lista de usuarios a crear (opcional)
postgresql_users:
  - name: baz
    pass: pass
    encrypted: yes  # si la contraseña debe estar encriptada, postgresql >= 10 solo acepta contraseñas encriptadas

# Lista de esquemas a crear (opcional)
postgresql_database_schemas:
  - database: foobar           # nombre de la base de datos
    schema: acme               # nombre del esquema
    state: present

  - database: foobar           # nombre de la base de datos
    schema: acme_baz           # nombre del esquema
    owner: baz                 # nombre del propietario
    state: present

# Lista de privilegios de usuario a aplicar (opcional)
postgresql_user_privileges:
  - name: baz                   # nombre de usuario
    db: foobar                  # base de datos
    priv: "ALL"                 # formato de cadena de privilegio: ejemplo: INSERT,UPDATE/tabla:SELECT/otratabla:ALL
    role_attr_flags: "CREATEDB" # banderas de atributo de rol

Hay muchas más configuraciones que puedes encontrar en defaults/main.yml

Pruebas

Este proyecto viene con un Vagrantfile, esta es una forma rápida y fácil de probar cambios en el rol, inícialo con vagrant up

Consulta la documentación de vagrant para configurarte con vagrant.

Una vez que tu VM esté activa, puedes reprovisionarla usando vagrant provision, o ansible-playbook tests/playbook.yml -i vagrant-inventory.

Si deseas experimentar con el play de prueba, consulta tests/playbook.yml, y cambia las variables en tests/vars.yml.

Si estás contribuyendo, primero prueba tus cambios dentro del entorno de vagrant (usando la distribución objetivo), y si es posible, asegúrate de que tu cambio esté cubierto en las pruebas que se encuentran en .travis.yml.