Zima Cron è uno dei pochi strumenti di pianificazione pubblicati direttamente per ZimaOS anziché aggiunto come container Docker generico. Il tutorial di IceWhale del gennaio 2026 mostra come installarlo con zpkg, crea attività basate su intervalli o espressioni cron, verifica l’esecuzione tramite i log e usalo per script, backup o manutenzione ordinaria.
Il thread originale contiene anche una seconda informazione importante che la versione breve precedente di questo articolo aveva sintetizzato eccessivamente: la persistenza dopo il riavvio era incoerente tra i sistemi. Alcuni utenti di ZimaOS 1.5.3 e 1.5.4 perdevano tutte le attività pianificate o scoprivano zima-cron.service inattivo dopo il riavvio, mentre un ambiente di test pulito ha mostrato che le attività sopravvivevano al riavvio. La conclusione corretta è quindi “pianificatore ufficiale con una limitazione di persistenza dipendente dalla versione”, non semplicemente “installalo e dimenticatene”.
Installa Zima Cron con il gestore di pacchetti ufficiale zpkg
Il tutorial di IceWhale parte dal terminale di ZimaOS e utilizza:
zpkg install zima_cronLa fonte afferma esplicitamente che dopo l’installazione non è necessario alcun riavvio. Zima Cron dovrebbe quindi comparire nell’elenco delle app dell’interfaccia web di ZimaOS.
zpkg.Crea un’attività di test sicura prima di pianificare qualsiasi operazione importante
Il tutorial ufficiale utilizza deliberatamente un’attività di registrazione innocua di un minuto, anziché un comando di manutenzione distruttivo. È un buon approccio per qualsiasi pianificatore: verifica che il backend venga eseguito, che la pianificazione venga interpretata correttamente e che l’output venga scritto nella posizione prevista prima di automatizzare backup o riavvii dei servizi.
L’esempio ufficiale aggiunge un timestamp a un file di log:
bash -c 'echo "$(date "+%Y-%m-%d %H:%M:%S") zima cron works" >> /DATA/zima_cron_test.log'Poiché questo comando aggiunge solo testo, è adatto per verificare la pianificazione senza modificare lo stato dell’applicazione.
Usa la pianificazione a intervalli per le ripetizioni semplici
Una pianificazione a intervalli è appropriata quando l’orario esatto non è importante. Gli esempi includono un controllo dello stato leggero ogni pochi minuti o un’attività di pulizia ogni diverse ore.
Per le attività importanti, ricorda che “ogni 24 ore” non equivale sempre a “ogni giorno alle 4:00”, soprattutto dopo i riavvii dei servizi. Usa un'espressione cron quando è importante un orario preciso.
Usa espressioni cron standard per le pianificazioni basate sul calendario
Il tutorial ufficiale mostra anche la sintassi cron standard. Ad esempio:
*/5 * * * *viene eseguito ogni cinque minuti. Un'espressione cron normale può rappresentare pianificazioni giornaliere, settimanali, mensili o specifiche per i giorni della settimana, rendendo Zima Cron più flessibile rispetto al solo intervallo fisso.
Prima di distribuire un'espressione complessa, testala con un comando di registrazione innocuo e verifica almeno due esecuzioni riuscite.
Verifica l'esecuzione in Zima Cron e nel file di output
Un test completo dovrebbe verificare sia l'interfaccia dello scheduler sia l'effetto previsto, ad esempio nuove righe in /DATA/zima_cron_test.log. Questo consente di individuare i casi in cui un'attività esiste nell'interfaccia, ma il relativo comando non riesce a causa di autorizzazioni, percorsi, virgolette o binari mancanti.
La pianificazione dei riavvii delle app richiede il giusto confine del comando
Un utente ha chiesto come riavviare Home Assistant ogni giorno alle 4:00. La discussione non ha ricevuto da IceWhale un comando ufficiale per gestire una specifica app installata, quindi questo articolo non dovrebbe inventarne uno. Zima Cron può eseguire comandi shell, ma il comando esatto per un'applicazione dipende da come tale app viene gestita da ZimaOS e dal fatto che riavviarla al di fuori del livello di gestione delle app sia sicuro.
Usa lo scheduler per comandi che hai già verificato manualmente. Non fare del riavvio di un'applicazione in produzione il primo test.
La principale avvertenza: alcuni utenti hanno perso le attività dopo il riavvio
Il 26 gennaio, un utente di ZimaOS 1.5.3 ha segnalato che le attività salvate scomparivano dopo il riavvio. 777-Spider ha risposto che IceWhale avrebbe verificato il problema. Altri utenti hanno poi riprodotto un comportamento simile, trasformandolo in un reale problema di affidabilità anziché in un semplice malinteso isolato.
In seguito, a quanto riferito, un'installazione pulita e controllata ha funzionato correttamente: zima-cron.service rimaneva attivo, le attività restavano visibili dopo il riavvio e la registrazione continuava. Sembrava promettente, ma non era la fine della storia.
Test puliti e test nel mondo reale hanno prodotto risultati diversi
Un partecipante successivo ha installato Zima Cron tramite zpkg, aveva creato un'attività e aveva poi riferito, dopo il riavvio, che le attività erano scomparse e che non era più possibile crearne di nuove. Lo stato del servizio mostrava:
zima-cron.service
Caricato: caricato
Attivo: inattivo (morto)Ciò contraddiceva direttamente il risultato ottenuto su un sistema pulito, in cui il servizio si avviava automaticamente e le attività persistevano. L'interpretazione corretta è che i problemi di persistenza dipendevano dall'ambiente o dalla build e non erano stati risolti in modo conclusivo per ogni utente.
Cosa verificare dopo un riavvio
La discussione consigliava di verificare se il servizio fosse ancora attivo e se l'installazione fosse stata eseguita correttamente tramite zpkg. Per una distribuzione critica, i controlli QA minimi dopo il riavvio dovrebbero essere:
- Riavvia deliberatamente la macchina ZimaOS.
- Conferma che Zima Cron sia ancora presente.
- Conferma che l'attività salvata rimanga visibile.
- Conferma che il servizio backend sia attivo.
- Attendi la prossima esecuzione pianificata.
- Verifica l'output effettivo dell'attività, non solo lo stato nell'interfaccia.
Il problema della persistenza è stato segnalato anche pubblicamente
Il progetto Zima Cron presenta un issue pubblico che descrive la perdita delle attività e un servizio inattivo dopo il riavvio. Prima di affidargli la manutenzione non presidiata, verifica lo stato attuale della segnalazione sulla persistenza dopo il riavvio.
Non fare affidamento su un pianificatore non testato come unico avviatore dei backup
Zima Cron è utile per l'automazione, ma un backup pianificato che scompare silenziosamente dopo un riavvio è peggio di un backup manuale che sai non essere stato eseguito. Se l'attività è importante, combina i test del pianificatore con controlli indipendenti dello stato dei backup e verifiche del ripristino.
Domande frequenti su Zima Cron
Il comando di installazione di Zima Cron è ufficiale?
Sì. zpkg install zima_cron è stato pubblicato da 777-Spider nel tutorial di IceWhale.
Può usare le normali espressioni cron?
Sì. Il tutorial ufficiale supporta sia le pianificazioni a intervalli sia le espressioni cron standard.
Le attività sopravvivono sicuramente al riavvio?
Non è possibile fornire alcuna garanzia universale sulla base della discussione originale. Alcuni test in ambienti puliti hanno avuto esito positivo, mentre altri sistemi 1.5.x hanno perso ripetutamente le attività o lasciato il servizio inattivo.
Cosa dovrei fare prima di affidargli un'attività critica?
Esegui un test di riavvio effettivo, verifica che l'attività rimanga definita e conferma che il comando venga eseguito correttamente in seguito.
