From 025dce2dbece795bdc144cf25075efef20f44a14 Mon Sep 17 00:00:00 2001
From: Arthur BOUDREAULT <boudreaultarthur@ik.me>
Date: Tue, 11 Jan 2022 17:10:06 +0100
Subject: [PATCH] refactor: task is now in main.yml + updates readme
---
README-FR.md | 5 ++++-
README.md | 6 +++++-
defaults/main.yml | 4 ++++
tasks/apps.yml | 10 ----------
tasks/main.yml | 12 ++++++++++++
5 files changed, 25 insertions(+), 12 deletions(-)
diff --git a/README-FR.md b/README-FR.md
index 33be9c4..73600ef 100644
--- a/README-FR.md
+++ b/README-FR.md
@@ -132,7 +132,10 @@ Cette tâche utilisant le module template, vous pouvez tout à fait utiliser vos
Pour `owner` et `group`, par défaut le fichier va prendre comme utilisateur propriétaire le nom de l'application et comme groupe propriétaire www-data (groupe NGINX). Vous pouvez les changer en précisant des valeurs différentes.
#### Concernant les mises à jour :
-Une tâche cron a été mise en place pour automatiser la vérification des mises à jour système et applications tous les jours à 1 heure du matin. Si des mises à jour sont disponibles, elles sont faites automatiquement. En cas de problème suite à la mise à jour d'une application, vous avez la possibilité de revenir à la version précédente car Yunohost fait toujours une sauvegarde automatique d'une application lorsqu'elle est mise à jour.
+Une tâche cron peut être mise en place pour automatiser la vérification des mises à jour système et applications suivant la périodicité de votre choix.
+ - `ynh_autoupdate.scheduled` : Activez la tâche cron en mettant la valeur à "true".
+ - `ynh_autoupdate.special_time`: Cette variable est obligatoire. Elle permet de préciser quand vous souhaitez que cette tâche soit exécutée. Pour en savoir plus sur les special times, cliquez [ici] (https://docs.ansible.com/ansible/latest/collections/ansible/builtin/cron_module.html)
+Si des mises à jour sont disponibles, elles sont faites automatiquement. En cas de problème suite à la mise à jour d'une application, vous pouvez lire les logs qui sont disponibles ici `/var/log/yunohost/categories/operation`. Vous avez aussi la possibilité de revenir à la version précédente car Yunohost fait toujours une sauvegarde automatique d'une application lorsqu'elle est mise à jour.
Pour en savoir plus sur le fonctionnement des mises à jour dans Yunohost vous pouvez vous rendre [ici](https://yunohost.org/fr/update). Le changelog des versions de Yunohost est aussi disponible [ici](https://forum.yunohost.org/tag/ynh_release).
diff --git a/README.md b/README.md
index 661adee..07210f9 100644
--- a/README.md
+++ b/README.md
@@ -132,7 +132,11 @@ Because this task uses the template module, you can use your own variables and c
For `owner` and `group`, by default the file will take as owner the name of the application and as owner www-data(NGINX group). You can change them by specifying different values.
#### About the updates:
-A cron job has been set up to automate the check for system and application updates every day at 1am. If updates are available, they are done automatically. In case of problems following an application update, you have the possibility to rollback to the previous version because Yunohost always makes an automatic backup of an application when it is updated.
+A cron job can been set up to automate the check for system and application updates on a schedule of your choice.
+ - `ynh_autoupdate.scheduled` : Enable the cron job by setting the value to "true".
+ - `ynh_autoupdate.special_time`: This variable is mandatory. It allows you to specify when you want this task to be executed. To learn more about special times, click [here] (https://docs.ansible.com/ansible/latest/collections/ansible/builtin/cron_module.html)
+
+If available, updates are done automatically. In case of problems following an application update, you can read logs located in `/var/log/yunohost/categories/operation` . You also have the possibility to rollback to the previous version since Yunohost always makes an automatic backup of an application when it is updated.
To learn more about how updates work in Yunohost you can go [here](https://yunohost.org/fr/update). The changelog of Yunohost versions is also available [here](https://forum.yunohost.org/tag/ynh_release).
diff --git a/defaults/main.yml b/defaults/main.yml
index 725285b..39eeb88 100644
--- a/defaults/main.yml
+++ b/defaults/main.yml
@@ -63,3 +63,7 @@ ynh_apps: null
# owner: ttrss # Only provide if different from app name
# group: ttrss # Only provide if different from www-data
+# Autoupdate Yunohost and its apps
+ynh_autoupdate:
+ scheduled: "false"
+ special_time: "daily" #Choices are [annually,daily,hourly,monthly,reboot,weekly,yearly]
diff --git a/tasks/apps.yml b/tasks/apps.yml
index cc0738f..6ac376b 100644
--- a/tasks/apps.yml
+++ b/tasks/apps.yml
@@ -33,13 +33,3 @@
loop_var: ynh_app
when: ynh_app.label not in ynh_installed_apps.values()
-- name: Creates a cron file under /etc/cron.d to auto-update Yunohost everyday
- ansible.builtin.cron:
- name: "auto-update Yunohost everyday.
- Logs can be found in /var/log/yunohost/categories/operation"
- special_time: "daily"
- user: root
- job: "yunohost tools update && \
- yunohost tools upgrade system && \
- yunohost tools upgrade apps"
- cron_file: ynh_autoupdate
diff --git a/tasks/main.yml b/tasks/main.yml
index 0480221..7f42805 100644
--- a/tasks/main.yml
+++ b/tasks/main.yml
@@ -72,3 +72,15 @@
- name: Install Yunohost apps
ansible.builtin.include_tasks: apps.yml
when: ynh_apps
+
+- name: Creates a cron task under /etc/cron.d to auto-update Yunohost
+ ansible.builtin.cron:
+ name: "auto-update Yunohost.
+ Logs can be found in /var/log/yunohost/categories/operation"
+ special_time: "{{ ynh_autoupdate.special_time }}"
+ user: root
+ job: "yunohost tools update && \
+ yunohost tools upgrade system && \
+ yunohost tools upgrade apps"
+ cron_file: ynh_autoupdate_cron
+ when: ynh_autoupdate.scheduled == "true"
--
GitLab