Skip to content

Latest commit

 

History

History
102 lines (68 loc) · 3.5 KB

README.md

File metadata and controls

102 lines (68 loc) · 3.5 KB

Logo

Build Status Ansible Galaxy

PostgreSQL Ansible role

This Ansible role installs an PostgreSQL (10 to 16) in a Debian environment. It has been tested for the following Debian versions:

  • Bookworm
  • Bulleye
  • Buster

Getting Started

These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install an PostgreSQL server in a Debian or RHEL system.

Prerequisities

Ansible >=2.9.x.x version installed. Inventory destination should be a Debian or RHEL environment.

For testing purposes, Molecule with Docker as driver. Pipenv 2018.11.26 and Python 3 recommended.

Installing

Create or add to your roles dependency file (e.g requirements.yml):

- src: idealista.postgresql_role
  version: 2.0.0
  name: postgresql

Install the role with ansible-galaxy command:

ansible-galaxy install -p roles -r requirements.yml -f

Use in a playbook:

---
- hosts: someserver
  roles:
    - { role: postgresql }

Usage

Look to the defaults vars and specific OS related files to see all the possible configuration vars. Important note about custom configuration directories We tried to develop the most flexible role. But, even when it's possible changing the default configuration directory, it's not recommended. This role will respect the Debian/RHEL style when deploying config files and initializing the database directory:

  • in the Debian case, the configuration files will be deployed in /etc/postgresql
  • in the RHEL case, the configuration files will be deployed in the same data directory

Testing

$ pipenv sync
$ pipenv run molecule test

See molecule.yml to check possible testing platforms.

Built With

Ansible Molecule

Versioning

For the versions available, see the tags on this repository.

Additionaly you can see what change in each version in the CHANGELOG.md file.

Authors

See also the list of contributors who participated in this project.

License

Apache 2.0 License

This project is licensed under the Apache 2.0 license - see the LICENSE file for details.

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.