trainline-eu.ansible_barman_role

Barman Ansible Role

This Ansible role sets up and configures Barman, a tool for managing backups of PostgreSQL databases.

Installation

This role works with Ansible version 2.3.0 and newer.

To install:

ansible-galaxy install trainline-eu.ansible_barman_role

Dependencies

There are no dependencies for this role.

Recommended additional roles:

• trainline-eu.ansible_postgresql_role

Compatibility

The following table shows which operating systems and Barman versions have been tested together.

• :white_check_mark: - Successfully tested

Variables

# Basic settings
barman_databases:                               # Required
  - name: 'app1'                                  # Required
    description: 'Database for App1'              # Required
    primary_host: "{{ groups['db-app1'][0] }}"     # Required
    postgres_barman_password: 'super_secure_vaulted' # Required
    backup_method: rsync                          # Optional (default is rsync)
    retention_policy: 'RECOVERY WINDOW OF 7 DAYS' # Optional (default is 7 days)
    standby_hosts: "{{ groups['db-app1'][1:] }}"   # Optional (Automatically allows SSH on these servers)
    extract_host_from_var: 'ec2_private_ip_address' # Optional (Variable for host extraction)

barman_restore_directory: "/home/restore-$server"

barman_rsync_daemon_enabled: true  # Default is false
# If you enable Rsync daemon
barman_rsync_allowed_hosts: 10.0.0.0/24
barman_rsync_password: "vaulted_secret_password"

# Barman configuration
# Check http://docs.pgbarman.org/release/2.4/barman.5.html#configuration-file-syntax 
# for the meaning of these settings
barman_config:                      # Optional
  reuse_backup: "None|link|copy"
  bandwidth_limit: 0
  parallel_jobs: 2
  network_compression: true|false
  backup_options: exclusive_backup|concurrent_backup

Testing

Currently, there are no specific tests for this project.

However, this role is tested alongside the postgresql role in a series of automated integration tests.

License

This project is licensed under the MIT License. You can find more details in the LICENSE file.

Thanks

Creators:

• Gaëtan Duchaussois
• Théophile Helleboid
• Paul Bonaud

Maintainers:

• Théophile Helleboid
• Paul Bonaud

Feedback, Bug Reports, Requests, ...

You're welcome to share!