Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/idealista/postgresql_role
Ansible role to install PostgreSQL
https://github.com/idealista/postgresql_role
ansible ansible-role centos database debian postgres postgresql rhel
Last synced: 24 days ago
JSON representation
Ansible role to install PostgreSQL
- Host: GitHub
- URL: https://github.com/idealista/postgresql_role
- Owner: idealista
- License: apache-2.0
- Created: 2020-01-20T17:35:20.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-21T14:38:12.000Z (8 months ago)
- Last Synced: 2024-10-20T03:29:16.569Z (3 months ago)
- Topics: ansible, ansible-role, centos, database, debian, postgres, postgresql, rhel
- Language: Jinja
- Homepage:
- Size: 303 KB
- Stars: 2
- Watchers: 24
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.com/idealista/postgresql_role)
[](https://galaxy.ansible.com/idealista/postgresql_role)
# 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](#getting-started)
- [Prerequisities](#prerequisities)
- [Installing](#installing)
- [Usage](#usage)
- [Testing](#testing)
- [Built With](#built-with)
- [Versioning](#versioning)
- [Authors](#authors)
- [License](#license)
- [Contributing](#contributing)
## Getting Started
These instructions will get you a copy of the role for your Ansible playbook. Once launched, it will install an [PostgreSQL](https://www.postgresql.org/) 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](https://molecule.readthedocs.io/) with [Docker](https://www.docker.com/) 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](defaults/) and [specific OS related](vars/) 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](https://github.com/idealista/postgresql_role/blob/master/molecule/default/molecule.yml) to check possible testing platforms.
## Built With
## Versioning
For the versions available, see the [tags on this repository](https://github.com/idealista/postgresql_role/tags).
Additionaly you can see what change in each version in the [CHANGELOG.md](https://github.com/idealista/postgresql_role/blob/master/CHANGELOG.md) file.
## Authors
* **Idealista** - *Work with* - [idealista](https://github.com/idealista)
See also the list of [contributors](https://github.com/idealista/postgresql_role/contributors) who participated in this project.
## License
This project is licensed under the [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0) license - see the [LICENSE](LICENSE) file for details.
## Contributing
Please read [CONTRIBUTING.md](https://github.com/idealista/postgresql_role/blob/master/.github/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.