Solution communautaire

Exécutez des tâches planifiées sur ZimaOS avec Zima Cron

An official January 2026 IceWhale tutorial for installing Zima Cron through zpkg and creating interval or cron-expression tasks. Later replies reported inconsistent persistence after reboot, including an open issue where zima-cron.service becomes inactive.

Zima Cron est l’un des rares outils de planification publiés directement pour ZimaOS plutôt qu’ajoutés sous la forme d’un conteneur Docker générique. Le tutoriel d’IceWhale de janvier 2026 montre comment l’installer avec zpkg, créer des tâches basées sur des intervalles ou des expressions cron, vérifier leur exécution dans les journaux et l’utiliser pour des scripts, des sauvegardes ou la maintenance courante.

Le fil source contient également un deuxième élément important, que la version courte de cet article avait auparavant trop condensé : la persistance après redémarrage était incohérente selon les systèmes. Certains utilisateurs de ZimaOS 1.5.3 et 1.5.4 ont perdu toutes leurs tâches planifiées ou ont constaté zima-cron.service inactives après un redémarrage, tandis qu’un environnement de test propre a montré que les tâches persistaient après le redémarrage. Il faut donc retenir qu’il s’agit d’un « planificateur officiel avec une réserve concernant la persistance selon la version », et non simplement de « l’installer puis l’oublier ».

Installer Zima Cron avec le gestionnaire de paquets officiel zpkg

Le tutoriel d’IceWhale commence dans le terminal de ZimaOS et utilise :

zpkg install zima_cron

La source indique explicitement qu’aucun redémarrage n’est nécessaire après l’installation. Zima Cron devrait ensuite apparaître dans la liste des applications de l’interface web de ZimaOS.

Tableau de bord ZimaOS affichant Zima Cron installé dans la liste des applications après l’exécution de zpkg install zima_cron
Le tutoriel d’IceWhale montre Zima Cron apparaître comme application immédiatement après l’installation via zpkg.

Créer une tâche de test sûre avant de planifier quoi que ce soit d’important

Le tutoriel officiel utilise délibérément une tâche d’écriture dans un journal, inoffensive et exécutée toutes les minutes, plutôt qu’une commande de maintenance destructive. C’est une bonne pratique pour tout planificateur : vérifier que le moteur s’exécute, que la planification est correctement interprétée et que la sortie est écrite à l’emplacement prévu avant d’automatiser des sauvegardes ou des redémarrages de services.

Écran de création d’une tâche dans Zima Cron, avec le nom de la tâche, la commande, le type de planification et les champs d’intervalle
L’éditeur de tâches prend en charge une commande ainsi qu’une planification par intervalles ou une expression cron standard.

L’exemple officiel ajoute un horodatage à un fichier journal :

bash -c 'echo "$(date "+%Y-%m-%d %H:%M:%S") zima cron works" >> /DATA/zima_cron_test.log'

Comme cette commande se contente d’ajouter du texte, elle convient pour vérifier la planification sans modifier l’état de l’application.

Utiliser la planification par intervalles pour les répétitions simples

Un calendrier par intervalles convient lorsque l’heure exacte n’a pas d’importance. Par exemple, pour effectuer une vérification légère de l’état de santé toutes les quelques minutes ou une tâche de nettoyage toutes les quelques heures.

Pour les tâches importantes, rappelez-vous que « toutes les 24 heures » n’équivaut pas toujours à « tous les jours à 4 h du matin », en particulier après des redémarrages de service. Utilisez une expression cron lorsqu’une heure précise compte.

Utiliser des expressions cron standard pour les planifications basées sur le calendrier

Le tutoriel officiel présente également la syntaxe cron standard. Par exemple :

*/5 * * * *

s’exécute toutes les cinq minutes. Une expression cron normale peut représenter des planifications quotidiennes, hebdomadaires, mensuelles ou propres à certains jours de la semaine, ce qui rend Zima Cron plus flexible qu’un simple intervalle fixe.

Avant de déployer une expression complexe, testez-la avec une commande de journalisation sans danger et vérifiez au moins deux exécutions réussies.

Vérifier l’exécution dans Zima Cron et dans le fichier de sortie

Liste des tâches Zima Cron affichant une tâche de test planifiée avec des journaux d’exécution répétés réussis
Le tutoriel officiel vérifie le planificateur au moyen de l’état de la tâche et de journaux d’exécution répétés, plutôt que de supposer qu’une tâche enregistrée s’exécute réellement.

Un test complet doit vérifier à la fois l’interface du planificateur et l’effet attendu — par exemple, l’ajout de nouvelles lignes dans /DATA/zima_cron_test.log. Cela permet de détecter les cas où une tâche existe dans l’interface, mais où sa commande échoue à cause des autorisations, des chemins, de la syntaxe de guillemets ou de binaires manquants.

La planification des redémarrages d’applications nécessite de définir correctement la limite de commande

Un utilisateur a demandé comment redémarrer Home Assistant tous les jours à 4 h du matin. Le fil n’a reçu aucune commande officielle d’IceWhale pour gérer une application installée spécifique ; cet article ne doit donc pas en inventer une. Zima Cron peut exécuter des commandes shell, mais la commande exacte pour une application dépend de la manière dont cette application est gérée par ZimaOS et de la sécurité d’un redémarrage en dehors de la couche de gestion des applications.

Utilisez le planificateur pour les commandes que vous avez déjà vérifiées manuellement. Ne faites pas votre premier test sur le redémarrage d’une application en production.

La réserve majeure : certains utilisateurs ont perdu leurs tâches après un redémarrage

Le 26 janvier, un utilisateur de ZimaOS 1.5.3 a signalé que les tâches enregistrées disparaissaient après un redémarrage. 777-Spider a répondu qu’IceWhale allait examiner le problème. D’autres utilisateurs ont ensuite reproduit un comportement similaire, ce qui en a fait un véritable problème de fiabilité plutôt qu’un simple malentendu isolé.

Plus tard, une installation propre et contrôlée s’est apparemment comportée correctement : zima-cron.service est resté actif, les tâches sont restées visibles après le redémarrage et la journalisation s’est poursuivie. Cela semblait prometteur, mais ce n’était pas la fin de l’histoire.

Les tests propres et les tests en conditions réelles ont produit des résultats différents

Un autre participant a ensuite installé Zima Cron via zpkg, a créé une tâche, puis a signalé après le redémarrage que les tâches avaient disparu et qu’il était impossible d’en créer de nouvelles. L’état de son service indiquait :

zima-cron.service
Chargé : chargé
Actif : inactif (arrêté)

Cela contredisait directement le résultat obtenu sur un système propre, où le service démarrait automatiquement et où les tâches persistaient. La bonne interprétation est que les problèmes de persistance dépendaient de l’environnement ou de la version, et n’étaient pas résolus de manière concluante pour tous les utilisateurs.

Points à vérifier après un redémarrage

Le fil de discussion recommandait de vérifier si le service était toujours actif et si l’installation avait été effectuée correctement via zpkg. Pour un déploiement critique, le contrôle qualité minimal après redémarrage doit être le suivant :

  1. Redémarrez volontairement la machine ZimaOS.
  2. Confirmez que Zima Cron apparaît toujours.
  3. Confirmez que la tâche enregistrée reste visible.
  4. Confirmez que le service backend est actif.
  5. Attendez la prochaine exécution planifiée.
  6. Vérifiez le résultat réel de la tâche, et pas seulement son état dans l’interface.

Le problème de persistance a également été signalé publiquement

Le projet Zima Cron comporte un ticket public décrivant la perte de tâches et l’inactivité du service après un redémarrage. Avant de lui confier la maintenance sans surveillance, vérifiez l’état actuel du rapport sur la persistance après redémarrage.

Ne faites pas d’un planificateur non testé votre seul déclencheur de sauvegarde

Zima Cron est utile pour l’automatisation, mais une sauvegarde planifiée qui disparaît silencieusement après un redémarrage est pire qu’une sauvegarde manuelle dont vous savez qu’elle n’a pas été exécutée. Si la tâche est importante, combinez les tests du planificateur avec des vérifications indépendantes de l’état des sauvegardes et une vérification de la restauration.

FAQ de Zima Cron

La commande d’installation de Zima Cron est-elle officielle ?

Oui. zpkg install zima_cron a été publié par 777-Spider dans le tutoriel IceWhale.

Peut-il utiliser des expressions cron classiques ?

Oui. Le tutoriel officiel prend en charge à la fois les planifications par intervalle et les expressions cron standard.

Les tâches survivent-elles vraiment au redémarrage ?

Aucune garantie universelle ne peut être déduite du fil de discussion d’origine. Certains tests sur des installations propres ont réussi, tandis que d’autres systèmes en version 1.5.x perdaient régulièrement des tâches ou laissaient le service inactif.

Que dois-je faire avant de lui confier une tâche critique ?

Effectuez un véritable test de redémarrage, vérifiez que la tâche reste définie et confirmez que la commande s’exécute correctement par la suite.