Ansible Role borg_local

This role installs and configures borg and sets up the desired backup repositories in a local directory.

Runs on

• RHEL 7 (and compatible)

• RHEL 8 (and compatible)

Tags

Tag	What it does
borg_local	Installs and configures borg
borg_local:configure	Configures borg
borg_local:state	Manages the state of the borg timer

Mandatory Role Variables

Variable	Description

Example:

# mandatory
borg_local__passphrase_mail: 'example@example.com'

Optional Role Variables

Variable	Description	Default Value
borg_local__backup_dir	The directory where the backup repositories will be created.	/backup
borg_local__backup_opts__host_vars / borg_local__backup_opts__group_vars	The list of options used by borg. Subkeys: option: Mandatory, string. The option to be used. state: Optional, string. Either present or absent. Defaults to present.	'--stats' '--progress' '--one-file-system' '--compression lz4' '--checkpoint-interval 86400'
borg_local__exclude_files__host_vars / borg_local__exclude_files__group_vars	The list of files or direcotries which should be excluded from the backup. Subkeys: file: Mandatory, string. The file or directory to be excluded. state: Optional, string. Either present or absent. Defaults to present.	'/root/.cache' '*.svn*' '*.git*' '*.tmp' '*.temp' '*/cache/*' '*/log/*'
borg_local__icinga2_api_url	The URL of the Icinga2 API (usually on the Icinga2 Master). This will be used to set a downtime for the corresponding clamAV service.	'https://{{ icinga2_agent__icinga2_master_host | d("") }}:{{ icinga2_agent__icinga2_master_port | d(5665) }}'
borg_local__icinga2_api_user_login	The Icinga2 API User to set the downtime for the corresponding clamAV service.	unset
borg_local__icinga2_hostname	The hostname of the Icinga2 host on which the downtime should be set.	'{{ ansible_facts["nodename"] }}'
borg_local__include_files__host_vars / borg_local__include_files__group_vars	The list of files or directories which should be included in the backup. Attention: These must not contain white spaces, since this is not supported by borg. Subkeys: file: Mandatory, string. The file or directory to be included. state: Optional, string. Either present or absent. Defaults to present.	'/etc' '/home' '/opt' '/root' '/var/spool/cron'
borg_local__on_calendar_daily_hour	The hour of the daily backup	23
borg_local__on_calendar_daily	The time the daily backup will happen. Once per day.	'*-*-* {{ borg_local__on_calendar_daily_hour }}:{{ 45|random(seed=inventory_hostname) }}'
borg_local__on_calendar_hourly	The time the daily backup will happen. Once per hour.	'*-*-* *:{{ 59 |random(start=45) }}'
borg_local__passphrase_mail	The mail address to send the borg passphrase to.	'{{ mailto_root__to[0] }}'
borg_local__retention_daily	The amount of daily backups into the past.	'14d'
borg_local__retention_hourly	The amount of hourly backups into the past.	'99H'
borg_local__timer_daily_enabled	Whether the daily backup should be enabled.	true
borg_local__timer_hourly_enabled	Whether the hourly backup should be enabled.	false

Example:

# optional
borg_local__backup_dir: '/backup'
borg_local__backup_opts__host_var:
  - option: '--stats'
  - option: '--progress'
  - option: '--one-file-system'
  - option: '--compression lz4'
  - option: '--checkpoint-interval 86400'
borg_local__exclude_files__host_var:
  - file: '/root/.cache'
  - file: '*.svn*'
  - file: '*.git*'
  - file: '*.tmp'
  - file: '*.temp'
  - file: '*/cache/*'
  - file: '*/log/*'
borg_local__icinga2_api_url: 'https://icinga.example.com:5665'
borg_local__icinga2_api_user_login:
  username: 'downtime-user'
  password: 'linuxfabrik'
borg_local__icinga2_hostname: 'myhost.example.com'
borg_local__include_files__host_var:
  - file: '/etc'
  - file: '/home'
  - file: '/opt'
  - file: '/root'
  - file: '/var/spool/cron'
borg_local__on_calendar_daily: '*-*-* {{ borg_local__on_calendar_daily_hour }}:{{ 45|random(seed=inventory_hostname) }}'
borg_local__on_calendar_daily_hour: 23
borg_local__on_calendar_hourly: '*-*-* *:{{ 59 |random(start=45) }}'
borg_local__passphrase_mail: 'example@example.com'
borg_local__retention_daily: '14d'
borg_local__retention_hourly: '99H'
borg_local__timer_daily_enabled: true
borg_local__timer_hourly_enabled: false

License

The Unlicense

Author Information

Linuxfabrik GmbH, Zurich