README-FR.md

Rôle Ansible : Yunohost Backup

English version

Sauvegardez Yunohost 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

ynh_apps_backup:
  scheduled: "true"
  directory: "/data/backup"
  scheduled_hour: "*"
  scheduled_minute: "*/30"
  scheduled_weekday: "*"
  scheduled_month: "*"
  src_script: "templates/ynh_apps_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_apps_backup.scheduled : active la fonctionnalité de sauvegarde des applications Yunohost, mettez la valeur à True.
• ynh_apps_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_apps_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/.
• 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_apps_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_apps_backup.sh.

Dépendances

Aucune.

Exemple de Playbook

---
- name: Install Yunohost on Debian Server
  hosts: all
  become: True
  pre_tasks:
    - name: Update all packages and index
      ansible.builtin.apt:
        upgrade: dist
        update_cache: yes
    
  roles:
    - lydra.yunohost

License

ansible-yunohost est maintenu par Lydra et publié sous la licence GPL3.