63 lines
2.6 KiB
Markdown
63 lines
2.6 KiB
Markdown
|
# Rôle Ansible : Yunohost Backup
|
||
|
|
|
||
|
|
[🇬🇧 English version](README.md)
|
||
|
|
|
||
|
|
Sauvegardez [Yunohost](https://yunohost.org/#/) avec Ansible !
|
||
|
|
|
||
|
|
## Prérequis
|
||
|
|
|
||
|
|
Yunohost doit déjà être installé sur votre serveur.
|
||
|
|
|
||
|
|
## Variables du rôle
|
||
|
|
|
||
|
|
Les variables par défaut sont disponibles dans `default/main.yml` cependant il est possible de les surcharger selon vos besoins en ...
|
||
|
|
|
||
|
|
### Gestion des sauvegardes
|
||
|
|
|
||
|
|
```yml
|
||
|
|
ynh_backup:
|
||
|
|
scheduled: True
|
||
|
|
directory: "/data/backup"
|
||
|
|
scheduled_hour: "*"
|
||
|
|
scheduled_minute: "*/30"
|
||
|
|
scheduled_weekday: "*"
|
||
|
|
scheduled_month: "*"
|
||
|
|
system: True
|
||
|
|
apps: True
|
||
|
|
src_script: "templates/ynh_backup.sh.j2"
|
||
|
|
dest_script: "/usr/bin"
|
||
|
|
```
|
||
|
|
|
||
|
|
La tâche backup va permettre de sauvegarder les applications Yunohost ainsi que leurs données grâce à la mise en place d'une tâche cron.
|
||
|
|
|
||
|
|
- `ynh_backup.scheduled` : active la fonctionnalité de sauvegarde des applications Yunohost, mettez la valeur à `True`.
|
||
|
|
- `ynh_backup.directory` : le dossier de sauvegarde par défaut est `/home/yunohost.backup/archives` cependant vous pouvez tout à fait choisir de sauvegarder les backups dans un autre dossier grâce à cette variable. Dans ce cas, de manière à pouvoir restaurer les backups depuis l'interface web, Yunohost créé automatiquement un lien symbolique de l'archive créée vers son dossier par défaut.
|
||
|
|
- `ynh_backup.scheduled_[hour|minute|weekday|month]`: modifie la planification de la tâche cron. Par défaut elle se déclenchera tous les jours de l'année à 1 heure du matin. Pour plus d'informations concernant les réglages horaires cron, cet outil peut être utile : <https://crontab.guru/>.
|
||
|
|
- `ynh_backup.system` : est obligatoire. Activez la sauvegarde du système Yunohost en mettant la valeur à `True`.
|
||
|
|
- `ynh_backup.apps` : est obligatoire. Activez la sauvegarde des applications Yunohost en mettant la valeur à `True`.
|
||
|
|
- `src_script`: il s'agit du chemin absolu où le fichier de template se situe sur la machine qui exécute Ansible. Par défaut, il sera stocké dans `templates/ynh_backup.sh.j2`.
|
||
|
|
- `dest_script`: il s'agit du répertoire où le fichier de template va être stocké. Par défaut, il sera stocké dans `/usr/local/bin/`. Le script s'appelle `ynh_backup.sh`.
|
||
|
|
|
||
|
|
## Dépendances
|
||
|
|
|
||
|
|
Aucune.
|
||
|
|
|
||
|
|
## Exemple de Playbook
|
||
|
|
|
||
|
|
```yml
|
||
|
|
---
|
||
|
|
- name: Configure Yunohost backups
|
||
|
|
hosts: all
|
||
|
|
become: True
|
||
|
|
collections:
|
||
|
|
- lydra.yunohost
|
||
|
|
roles:
|
||
|
|
- ynh_backup
|
||
|
|
```
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
[](https://choosealicense.com/licenses/gpl-3.0/)
|
||
|
|
|
||
|
|
**ansible-yunohost** est maintenu par [Lydra](https://lydra.fr/) et publié sous la licence GPL3.
|