1
0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2024-12-12 08:43:55 +02:00
matrix-docker-ansible-deploy/docs/configuring-playbook-postgres-backup.md
Suguru Hirahara dd5881f2b8
Adjust blank lines: remove duplicated ones
Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
2024-12-02 03:14:39 +09:00

2.6 KiB

Setting up postgres backup (optional)

The playbook can install and configure docker-postgres-backup-local for you via the ansible-role-postgres-backup Ansible role.

For a more complete backup solution (one that includes not only Postgres, but also other configuration/data files), you may wish to look into BorgBackup instead.

Adjusting the playbook configuration

To enable Postgres backup, add the following configuration to your inventory/host_vars/matrix.example.com/vars.yml file:

postgres_backup_enabled: true

Refer to the table below for additional configuration variables and their default values.

Name Default value Description
postgres_backup_enabled false Set to true to use docker-postgres-backup-local to create automatic database backups
postgres_backup_schedule '@daily' Cron-schedule specifying the interval between postgres backups.
postgres_backup_keep_days 7 Number of daily backups to keep
postgres_backup_keep_weeks 4 Number of weekly backups to keep
postgres_backup_keep_months 12 Number of monthly backups to keep
postgres_backup_base_path "{{ matrix_base_data_path }}/postgres-backup" Base path for postgres-backup. Also see postgres_backup_data_path
postgres_backup_data_path "{{ postgres_backup_base_path }}/data" Storage path for postgres-backup database backups

Installing

After configuring the playbook, run it with playbook tags as below:

ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start

The shortcut commands with the just program are also available: just install-all or just setup-all

just install-all is useful for maintaining your setup quickly when its components remain unchanged. If you adjust your vars.yml to remove other components, you'd need to run just setup-all, or these components will still remain installed. Note these shortcuts run the ensure-matrix-users-created tag too.