improve README

thanks to  @warwick-lill for the hint
CLOSE https://github.com/roles-ansible/ansible_role_restic/issues/64
This commit is contained in:
L3D 2022-04-01 11:00:22 +02:00
parent 30b45c6154
commit 1121ff2511
No known key found for this signature in database
GPG key ID: CD08445BFF4313D1
2 changed files with 25 additions and 5 deletions

View file

@ -56,11 +56,14 @@ CRON=true /path/to/backup/script/backup-example.sh
``` ```
## Installation ## Installation
There are multiple ways to install the role. Either clone or download it directly from the [github repository](https://github.com/roles-ansible/ansible_role_restic.git). Or Install it via [ansible galaxy](https://galaxy.ansible.com/do1jlr/restic):
```bash ```bash
ansible-galaxy install arillso.restic ansible-galaxy install do1jlr.restic
``` ```
## Requirements ## Requirements
* bzip2 * bzip2
* jmespath
## Role Variables ## Role Variables
| Name | Default | Description | | Name | Default | Description |
@ -81,6 +84,7 @@ ansible-galaxy install arillso.restic
| `restic_do_not_cleanup_cron ` | `false` | we changed the cron location and clean up the old one. You can skip the cleanup here | | `restic_do_not_cleanup_cron ` | `false` | we changed the cron location and clean up the old one. You can skip the cleanup here |
| `restic__cache_config` | `false` | configure custom cache directory | | `restic__cache_config` | `false` | configure custom cache directory |
| `restic__cache_dir` | `'~/.cache/restic'` | define custom cache directory | | `restic__cache_dir` | `'~/.cache/restic'` | define custom cache directory |
|`submodules_versioncheck`| `false` | if you set this variable to true, the role will run a [simple versionscheck](tasks/versioncheck.yml) to prevent running older versions of this role. |
### Repos ### Repos
Restic stores data in repositories. You have to specify at least one repository Restic stores data in repositories. You have to specify at least one repository
@ -192,13 +196,29 @@ Please refer to the use of the specific keys to the
[documentation](https://restic.readthedocs.io/en/latest/040_backup.html#excluding-files). [documentation](https://restic.readthedocs.io/en/latest/040_backup.html#excluding-files).
## Dependencies ## Dependencies
none This role does not have any other ansible role as dependencie.
## Example Playbook ## Example Playbook
```yml ```yml
- hosts: all - name: backup your homefolders to /mnt/backup everyday night
hosts: localhost
roles: roles:
- restic - {role: do1jlr.restic, tags: restic}
vars:
restic_create_schedule: true
restic_repos:
local:
location: '/mnt/backup'
password: 'ChangM3'
init: true
restic_backups:
home:
name: home
repo: local
src: /home/
scheduled: true
schedule_oncalendar: '*-*-* 01:00:00'
``` ```
## License ## License

View file

@ -10,5 +10,5 @@ restic_os_variables:
paths: paths:
- 'vars' - 'vars'
playbook_version_number: 24 # should be int playbook_version_number: 25 # should be int
playbook_version_path: 'do1jlr.restic.version' playbook_version_path: 'do1jlr.restic.version'