https://github.com/mahdi22/ansible-postgresql
Install and configure Postgresql server on Rhel/CentOS, Debian, Ubuntu and SUSE SLES ditributions
https://github.com/mahdi22/ansible-postgresql
ansible database linux postgresql
Last synced: 2 months ago
JSON representation
Install and configure Postgresql server on Rhel/CentOS, Debian, Ubuntu and SUSE SLES ditributions
- Host: GitHub
- URL: https://github.com/mahdi22/ansible-postgresql
- Owner: mahdi22
- Created: 2020-11-26T17:58:26.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-03-24T10:07:26.000Z (over 4 years ago)
- Last Synced: 2025-01-04T02:35:24.488Z (over 1 year ago)
- Topics: ansible, database, linux, postgresql
- Language: HTML
- Homepage:
- Size: 17.6 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ansible role `postgresql`
An Ansible role for installing Postresql on Linux for RHEL/CentOS, Debian, Ubunut and SUSE SLES distributions. Specifically, the responsibilities of this role are to:
- Install Postgresql
- Configure Postgresql parameters and authentifications
- Create users
- Create databases
## Installation
``` bash
$ ansible-galaxy install mahdi22.postgresql
```
## Role Variables
variable/main.yml
Set postgresql configuration parameters or use default values
```Yaml
postgresql_config:
- option: port
value: 5432
- option: log_destination
value: syslog
- option: log_directory
value: /var/log/postgresql/
```
Set or modify postgresql authentification parameters or use default values
```Yaml
postgresql_authentication:
- {type: local, database: all, user: postgres, auth_method: peer}
- {type: local, database: all, user: all, auth_method: md5}
- {type: host, database: all, user: all, address: '127.0.0.1/32', auth_method: md5}
- {type: host, database: all, user: all, address: '::1/128', auth_method: md5}
- {type: local, database: replication, user: all, auth_method: peer}
- {type: host, database: replication, user: all, address: '127.0.0.1/32', auth_method: md5}
- {type: host, database: replication, user: all, address: '::1/128', auth_method: md5}
```
Set postgresql databases and users to create if not set create_users: no and create_databases: no in default/main.yml
Example of creating multiple databases and users:
```Yaml
postgresql_databases_users: []
#postgresql_databases_users:
# - {database: test, user: user1, userpassword: user1pass, priv: ALL} #add database 'user' and user 'user1' with password 'user1pass' with Privileges 'ALL'
# - {database: test1, user:'', userpassword: '', priv: ''} #add only database 'test1'
# - {database: '', user: user2, userpassword: user2pass, priv: ''} #add only user 'user2' with password 'user2pass'
```
- To create only database without user set database: databasename, user:''
- To create only user set database: '', user: username, userpassword: password
- To create database with user PRIVILEGES set database: databasename, user: username, userpassword: password, priv: privileges
### Basic configuration
| Variable | Default | Comments |
| :--- | :--- | :--- |
| `use_proxy ` | 'False' | If managed hosts are behind web proxy set use_proxy: True |
| `http_proxy ` | 'http://proxy.lab.local:8080/'| Set Proxy server and port replace proxy.lab.local:8080 |
| `https_proxy` | 'http://proxy.lab.local:8080/'| Set Proxy server and port replace proxy.lab.local:8080 |
| `postgresql_version` | | Postgresql version that will be installed |
| `listen_addresses_host_ip` | yes | yes to active postgresql listen on network IP interface |
| `create_users` | yes | create postgresql users configured in variable files |
| `create_databases` | yes | create postgresql databases configured in variable files |
#### Remarks
(1) If managed hosts are behind web proxy set the folowing variables in defaults/main.yml file:
```yaml
use_proxy: False
proxy_env:
http_proxy: http://proxy.local:8080/
https_proxy: http://proxy.local:8080/
```
## Example Playbook
```Yaml
- hosts: dbservers
roles:
- role: mahdi22.postgresql
become: yes
```
## Testing
This role is tested on these Linux distributions:
- RHEL/CentOS 8 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- RHEL/CentOS 7 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- Debian 10 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- Debian 9 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- Ubuntu 20.04 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- Ubuntu 18.04 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- Ubuntu 16.04 postgresql version (9.5, 9.4, 10, 11, 12, 13)
- Suse SLES 12 postgresql version (9.5, 9.4, 10, 11, 12)
- Suse SLES 15 postgresql version (11, 12, 13)