{{tag>système administration}} ====== Programmer des tâches avec cron ====== ===== Qu'est-ce que cron ===== **[[wpfr>cron]]** est une application permettant d'exécuter automatiquement des scripts, des commandes ou d'autres applications à une date et une heure spécifiée précise, ou selon un cycle défini à l’avance. Chaque [[:utilisateur]] possède un fichier ''crontab'' associé, lui permettant d'indiquer les actions à exécuter.\\ **cron** est parfois appelé « planificateur de tâches » ou « gestionnaire de tâches planifiées ». Sur les systèmes modernes, **cron** tend à être remplacé par des [[:creer_un_service_avec_systemd#qu_est_ce_qu_un_timer|timers]] [[:systemd]]. ==== Distinction avec Anacron ==== * **cron** est plutôt utilisé pour des machines à fonctionnement permanent (comme les serveurs). * **[[:Anacron]]** est plutôt utilisé pour des machines à fonctionnement discontinu (comme les ordinateurs personnels). **cron** a plus d'options qu'**Anacron**. Comme ce dernier, il peut lancer une tâche à un intervalle déterminé : par exemple chaque 5e jour de la semaine, chaque heure, ou chaque mois. Contrairement à **Anacron**, il peut aussi lancer une tâche à un moment pré-déterminé (« le 14 janvier 2018 à 15h 30 »).\\ Limite par rapport à **Anacron** : si la machine n'est pas allumée, la tâche n'est pas lancée, et ne le sera jamais, même après le re-démarrage. Elle est perdue. Les prochaines seront évidement lancées, si la machine est allumée. **[[:Anacron]]** n'utilise que des indications de temps relatives (« une fois par jour / par semaine / par mois »). Autre différence d'avec **cron**, si vous avez demandé une tâche toute les semaines, et que votre PC est démarré seulement au bout de 10 jours, **Anacron** constatera le retard, et lancera donc la tâche juste après le démarrage de votre PC. Les 2 applications peuvent être utilisées sur un PC régulièrement éteint, mais **Anacron** a le gros avantage de lancer tous les traitements en retard à chaque allumage de l'ordinateur, même si ces derniers sont peu nombreux. Avec **cron**, des allumages PC trop intermittents risquent d'annuler une grande partie des traitements programmés. La syntaxe de **cron** est plus complexe que celle d'**Anacron**. ===== Choix de l'utilisateur cron ===== Il est important de définir clairement sous quel compte [[:utilisateur]] est lancé **cron**. Ce peut-être vous (votre //user//), ou ce peut-être //root// (utilisateur qui a tous les droits). Pour des opérations demandant normalement un mot de passe, il faudra utiliser **cron** en //root//. En effet, l'utilisateur //root// peut tout faire sans mot de passe. Soyez prudents avec ces scripts, ils peuvent tout faire, y compris casser votre système ! Pour des opérations en espace utilisateur (dans votre [[:arborescence#répertoire personnel]] ''/home/$USER''), donc sans mot de passe, utilisez le **cron** de votre compte [[:utilisateur]]. Pour lancer le **cron** de votre espace [[:utilisateur]] : ''crontab -e''. Pour consulter ce **cron** sans l'ouvrir : ''contrab -l''. Pour lancer le **cron** //root// : ''sudo crontab -e''. Pour consulter ce **cron** sans l'ouvrir : ''sudo contrab -l''. ===== Comment fonctionne cron ===== Les tâches planifiées **cron** sont définies au niveau du système dans le fichier ''/etc/crontab'' et dans le répertoire ''/etc/cron.d/''.\\ Pour modifier vos tâches planifiées entrez : ''crontab -e'' ou ''sudo crontab -e'' (lance un éditeur du fichier ''crontab''). Voici une courte description de la structure d'une entrée dans un fichier ''crontab''. Les champs à renseigner sont, //dans l'ordre// : - //minute// de lancement (les minutes se numérotent de 0 à 59) - //heure// de lancement (les heures se numérotent de 0 à 23) - //jours dans le mois// de lancement (les jours se numérotes de 1 à 31) - //mois// de lancement (les mois se numérotent de 1 à 12, ou s'énoncent par leur libellé abrégé anglais - jan ; feb ; mar ; apr ; ...) - //jour de la semaine// de lancement (les jours se numérotent de 1 (lundi) à 7 (dimanche), ou s'énoncent par leur libellé abrégé anglais - sun ; mon ; tue ; wed ; thu ; fri ; sat) - La commande à lancer. Un champ contenant une étoile ''*'' signifie '//tous//' => dans le champs "mois", ''*'' signifie donc : "//à lancer chaque mois//"). Récapitulatif des 5 premiers champs : | | 1er | 2nd | 3è | 4è | 5è | | | * | * | * | * | * | | id | minute | heure | jour dans le mois | mois | jour de la semaine | | valeur | 0-59 | 0-23 | 1-31 | 1-12 ou jan, feb, mar… | 1-7 ou mon, tue, wed… | ---- Si //jour du mois// et //mois// sont définis, //jour de la semaine// n'est pas nécessaire. Cependant, si le champ est indiqué en plus, la commande sera exécutée à la date //jour du mois// et //mois// mais AUSSI tous les //jour de la semaine// définis. Exemple avec 0 0 13 1 5 tâche La "tâche" (non définie ici) sera exécutée 0 min et 0 h après le démarrage, le 13e jour du 1er mois (janvier) //et// tous les vendredis (5e jour de la semaine). ---- L'exemple ci-dessous exécutera ''/usr/bin/apt-get update'' à 3:05 (5e minute de la 3e heure), chaque jour de chaque mois (les ''*'' dans "jour", "mois" et "jours de la semaine"), avec les droits de l'utilisateur //nomdutilisateur//. 5 3 * * * nomdutilisateur /usr/bin/apt-get update ---- Vous pouvez faire tourner **cron** toutes les 5 minutes, entre 9 h à 17 h, et uniquement du lundi au vendredi, avec un message "Où en es tu ?" (on met ''*'' pour les colonnes "jour dans le mois" et "mois", puisqu'on utilise pas ces données) : */5 9-17 * * mon,tue,wed,thu,fri wall "Où en es tu ?" ou vous rappeler un anniversaire à 9h du matin le 10 janvier chaque année : 0 9 10 jan * echo "C'est l'anniversaire de ta Maman aujourd'hui !" >>~/readme ---- Il existe des raccourcis intéressants : * ''@reboot'' se lance au boot avec les droits utilisateurs, bien commode * ''@yearly'' * ''@annually'' * ''@monthly'' * ''@weekly'' * ''@daily'' * ''@midnight'' * ''@hourly'' Exemples de lancements de tâches : chaque demie-heure (''*/30'' est une instruction, pas deux) */30 * * * * commande chaque heure, au début de l'heure (0 minute au démarrage de l'heure) : 0 * * * * commande chaque heure, à la 30e minute de l'heure : 30 * * * * commande chaque heure, mais uniquement entre 9h00 et 5h00 : 0 9-5 * * * commande Cf. aussi : man 5 crontab Vous pouvez générer le code grâce à ces outils en ligne : https://crontab.guru https://crontab-generator.org http://www.cronmaker.com ===== Commandes pour gérer les tâches planifiées cron ===== Pour examiner les tâches planifiées de l'utilisateur courant (le contenu de votre ''crontab''), entrez : crontab -l Pour modifier vos tâches planifiées entrez : crontab -e pour celles nécessitant normalement un mot de passe (qui dès lors ne sera pas demandé) : sudo crontab -e et pour modifier celles d'un autre utilisateur : sudo crontab -e -u nom_utilisateur Quand vous sortez de l'éditeur, le nouveau fichier **crontab** sera installé. Le fichier est stocké dans ''/var/spool/cron/crontabs/$USER'' mais doit seulement être modifié par l'intermédiaire de la commande ''[[man>crontab]]''. Il faut auparavant indiquer que l'utilisateur a le droit d'utiliser ''crontab''.\\ Pour cela il faut créer un fichier ''/etc/cron.allow'' et y saisir le nom des utilisateurs autorisés à utiliser ''crontab''. L'éditeur utilisé pour modifier le ''crontab'' peut être modifié par la commande : sudo update-alternatives --config editor ou par un : select-editor Lors du premier accès à ''crontab -e'' un menu apparaît et donne le choix de l'éditeur à utiliser. Certains environnements de bureau, comme KDE dans sa « Configuration du système », offrent une interface graphique pour gérer les tâches **cron**. ===== Lancement graphique ===== Par défaut, l'exécution de **cron** n'affiche rien. Si vous avez besoin de démarrer une interface graphique par exemple pour utiliser [[:zenity]], kdialog, dialog ou encore [[:totem]], [[:VLC]], ... Il vous faudra ajouter un ''DISPLAY=:0'' devant la commande lancée. Exemple : */5 * * * * DISPLAY=:0 zenity --info --text="Toto va bien" Il est parfois nécessaire de faire ''xhost +'' dans un terminal pour autoriser l'accès à [[:Xorg]]. FIXME : À mettre à jour concernant [[:Wayland]]. ===== Caractères UTF8 ===== Si vous utilisez un script nécessitant des caractères tels que des accents, n'oubliez pas d'ajouter un export **LANG="fr_FR.UTF-8"** ou **LANG="fr_BE.UTF-8"** au début de ce script. ===== Chemin des scripts, commandes à exécuter ou fichiers à utiliser ===== Une tâche **cron** est exécutée dans un shell non connecté (non-login) et non interactif. Les variables d'environnement habituelles et en particulier ''[[:variables_d_environnement#variables_liees_aux_emplacements_de_fichiers|$PATH]]'' ne sont pas connues. **cron** n'a donc pas de ''[[:variables_d_environnement#variables_liees_aux_emplacements_de_fichiers|$PATH]]'' par défaut. Il faut donc :\\ - soit mettre les emplacements //complets// des exécutables dans les commandes et les scripts appelés par **cron**, par exemple : /usr/bin/zenity --info --text="Toto va bien!" - soit ajouter une ligne de ''[[:variables_d_environnement#variables_liees_aux_emplacements_de_fichiers|$PATH]]'' dans le fichier ''crontab'', //avant// les appels de scripts. Cette ligne définie où il est très probable que se trouveront les programmes appelés : PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin - Soit faire les deux si on est très prudent :). Enfin, si le programme (script) exécuté doit sauvegarder des fichiers, il peut être utile de précéder l'exécution de votre script par un changement de répertoire : * * * * * cd /home/mon-compte/wokspace/ && /home/mon-compte/miniconda3/bin/python3 mon_script.py ===== Utilisation des répertoires /etc/cron.hourly, daily, weekly, monthly ===== Si vous avez examiné le fichier ''/etc/crontab'' de votre système, vous avez remarqué qu'il contient des tâches pour exécuter toutes les heures, jours, semaines, mois les fichiers contenus dans les répertoires ''/etc/cron.hourly'', ''/etc/cron.daily'', ''/etc/cron.weekly'', ''/etc/cron.monthly''. Si vous avez besoin qu'un script soit exécuté toutes les heures au niveau du système (par //root//), il suffit donc de le placer dans le répertoire ''/etc/cron.hourly'' et de le rendre exécutable. De même s'il s'agit d'une tâche quotidienne (//daily//), hebdomadaire (//weekly//) ou mensuelle (//monthly//). ===== Utilisation du répertoire /etc/cron.d ===== IL est possible d'éditer des services à exécuter automatiquement en rajoutant un fichier du nom que l'on souhaite dans le répertoire /etc/cron.d Attention contrairement aux lignes d'un fichier ''crontab'', elles doivent préciser quel utilisateur (nom_utilisateur dans l'exemple ci-dessous) exécute le script : * * * * * nom_utilisateur /bin/touch /home/me/ding_dong ===== Autres Considérations ===== Les commandes ci-dessus sont stockées dans un fichier ''crontab'' appartenant à votre compte d'utilisateur et exécutées avec votre niveau des permissions. Si vous voulez exécuter, régulièrement, une commande exigeant un plus haut niveau de permission (//root//), vous devez utiliser le fichier ''crontab'' //root// : sudo crontab -e Cette commande édite directement le fichier ''/var/spool/cron/crontabs/root''. Une autre façon de créer une tâche planifiée devant être exécutée par //root// est d'ajouter une entrée au fichier ''/etc/crontab'' ou de créer un nouveau fichier dans ''/etc/cron.d'' (cf. point précédent) en précisant bien //root// comme nom d'utilisateur. ==== Tests ==== Il est important de vérifier que vos travaux dans **cron** fonctionnent comme prévu. Une méthode pour faire un test est de paramétrer la tâche dans le ''crontab'' pour qu'elle s'exécute quelques minutes plus tard et contrôler le résultat, avant de mettre la synchronisation de cette tâche à la bonne heure. Vous pouvez également trouver utile d'envoyer les retours des commandes dans un fichier texte pour voir les succès ou les échecs, par exemple : echo "Sauvegarde de nuit: $(date)" >>/tmp/mybackup.log Une autre façon de contrôler la bonne exécution des tâches **cron** est d'utiliser sa capacité à envoyer des courriels. Pour cela il suffit de renseigner la variable MAILTO dans votre fichier ''crontab'', exemple : MAILTO="jean.dupont@example.com" Pour que cela fonctionne il faut que votre machine soit capable d'envoyer des courriels. (voir par exemple : [[:msmtp]] ou les systèmes satellites pour [[:postfix_systeme_satellite|Postfix]] ou [[:exim4-satellite|exim4]]). Au contraire, si vous ne voulez pas envoyer d’emails, ajouter simplement comme 1ère ligne utile ''MAILTO=""''. Pour plus d'informations, lisez les pages du //man// pour **[[man>cron]]** et ''[[man>crontab]]'' (le //man// est détaillé sur [[:tutoriel:console_ligne_de_commande|les commandes basiques]]). Sur une machine qui n'est pas allumée en permanence, **[[:anacron]]** (installé par défaut) permet de s'assurer que les taches **cron** sont bien exécutées en vérifiant à intervalles régulier si une tâche n'est pas en retard. ==== Journal ==== Par défaut on retrouve des logs de commandes **cron** dans ''/var/log/syslog'' mais ce n'est pas très pratique. Pour activer le log spécifique de **cron**:\\ Éditer le fichier ''/etc/rsyslog.d/50-default.conf'' qui est appelé par ''/etc/rsyslog.conf'' et décommenter la ligne : cron.* /var/log/cron.log Relancer //rsyslog// et //cron// sudo systemctl restart rsyslog sudo systemctl restart cron Il ne reste plus qu'à surveiller les logs de **cron**: sudo tail -f /var/log/cron.log Si on préfère des tâches silencieuses((https://unix.stackexchange.com/questions/163352/what-does-dev-null-21-mean-in-this-article-of-crontab-basics)), ajouter à la fin des lignes **cron** : > /dev/null 2>&1 pour rediriger les messages //et// les erreurs vers le « trou noir ». ===== Voir aussi ===== * **(//en//)** [[https://help.ubuntu.com/community/CronHowto]] * [[http://www.math-linux.com/spip.php?article16|Programmation des tâches régulières : crontab]] * [[:nano|Éditeur de texte GNU nano]] * [[:incron]] : effectuer une action, commande(s), scripts, etc, en cas de modifications de fichiers ou de répertoires donnés * [[https://www.easycron.com/|EasyCron - Cron Jobs Alternatives]] * [[:Anacron]] : planificateur de commande « anachronique » * [[:fcron]] : programmer des tâches devant être exécutées/ * [[https://askubuntu.com/questions/23009/why-crontab-scripts-are-not-working|why crontab scripts are not working?]] ---- //[[:Contributeurs]] : Martigo, l'entreprise Simplistay, [[:utilisateurs:krodelabestiole]].//