Différences

Ci-dessous, les différences entre deux révisions de la page.

--- cron [Le 24/03/2021, 09:47]
bcag2 [Autres Considérations] which
+++ cron [Le 03/03/2024, 12:57] (Version actuelle)
86.202.8.12 [Distinction avec Anacron] meilleure présentation
@@ Ligne 5: / Ligne 5: @@
 ====== Programmer des tâches avec CRON ======
+===== Qu'est-ce que Cron  =====
+**Cron** est un programme pour exécuter automatiquement des scripts, des commandes ou des logiciels à une date et une heure spécifiée précise, ou selon un cycle défini à l’avance
+Chaque utilisateur a un fichier **crontab**, lui permettant d'indiquer les actions à exécuter.\\
+Cron est parfois appelé « planificateur de tâches » ou « gestionnaire de tâches planifiées ».
+====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 PC).
+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.
-===== Qu'est-ce que Cron ? =====
+Les 2 logiciels peuvent être utilisés sur un PC régulièrement éteint, mais Anacron a le gros avantage de lancer tous les traitements en retard à chaque allumage du PC, même si ceux-ci sont peu nombreux. Avec Cron, des allumages PC trop intermittents risquent d'annuler une grande partie des traitements programmés.
-**Cron** est un programme pour exécuter automatiquement des scripts, des commandes ou des logiciels à une date et une heure spécifiée précise, ou selon un cycle défini à l’avance. Chaque utilisateur a un fichier **crontab**, lui permettant d'indiquer les actions à exécuter.
+===== Comment fonctionne Cron  =====
-Cron est parfois appelé « planificateur de tâches » ou « gestionnaire de tâches planifiées ».
+Les tâches planifiées cron sont définies au niveau du système dans le fichier /etc/crontab et dans le dossier /etc/cron.d/\\
+Pour modifier vos tâches planifiées tapez : **crontab -e** (lance un éditeur du fichier crontab)\\
+Les tâches définies dans **crontab** sont par principe exécutées par //[[root|root]]// (l'utilisateur avec le maximum de droits), sans demande de mot de passe. Cela permet d'exécuter potentiellement n'importe quelle tâche système, d'où un certain risque : soyez prudent, et abstenez-vous si vous ne maitrisez pas bien ce que vous faite.
+Voici une courte description de la structure d'une entrée dans un fichier crontab. Les champs à renseigner sont __dans l'ordre__ (un champ qu'on ne souhaite pas renseigner doit être rempli avec une *) :
-===== Comment fonctionne Cron ? =====
+    * //minute// de lancement (les minutes se numérotent de 0 à 59)
+    * //heure// de lancement (les heures se numérotent de 0 à 23)
-Les tâches planifiées cron sont définies au niveau du système dans le fichier /etc/crontab et dans le dossier /etc/cron.d/\\
+    * //jours dans le mois// de lancement (les jours se numérotes de 1 à 31)
-Il est déconseillé de modifier directement le fichier /etc/crontab. Les tâches qui y sont définies sont implicitement exécutées par //root//
+    * //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.
-Voici une courte description de la structure d'une entrée dans un fichier crontab.\\
+Récapitulatif des 5 premiers champs :
-Les champs, dans l'ordre(( Le mois et le jour de la semaine permettent une abréviation (suivant les jours et mois en anglais), telle que **jan** pour janvier, **thu** pour jeudi (Thursday).)) :
+| | 1er | 2nd | 3è | 4è | 5è |
-    * //minute//,
+| | * | * | * | * | *  |
-    * //heure//,
+| id | minute | heure | jour dans le mois | mois | jour de la semaine  |
-    * //jours dans le mois//,
+| valeur | 0-59 | 0-23 | 1-31 | 1-12 ou jan, feb, mar… | 1-7 ou mon, tue, wed… |
-    * //mois//.
-    * //jour de la semaine//
-  * La commande à lancer.
 ----
 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  <code>0 0 13 1 5 tâche</code>  la tâche sera exécutée le 13 janvier ET tous les vendredis.
+Exemple avec  <code>0 0 13 1 5 tâche</code>
+La "tâche" (non définie ici) sera exécutée 0mn et 0H après le démarrage, le 13e jour du 1er mois (janvier) __ET__ tous les vendredis (5e J. de la semaine).
----- L'exemple ci-dessous exécutera ///usr/bin/apt-get update//, chaque jour, de chaque mois à 03:05 (le **cron** fonctionne sur 24 h) avec les droits de l'utilisateur **nomdutilisateur**.
+---- 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**.
 <code>
 3  * *  * nomdutilisateur /usr/bin/apt-get update
 </code>
----- Vous pouvez faire tourner **cron** toutes les 5 minutes tout au long de la journée de travail (9am-5pm) avec un message :
+---- Vous pouvez faire tourner **cron** toutes les 5 minutes, entre 9H à 17H, 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) :
 <code>
 */5 9-17 * * mon,tue,wed,thu,fri wall "Où en es tu ?"
 </code>
 ou vous rappeler un anniversaire à 9h du matin le 10 janvier chaque année :
 <code>
 9 10 jan  * echo "C'est l'anniversaire de ta Maman aujourd'hui !" >>~/readme
@@ Ligne 61: / Ligne 70: @@
     * @midnight
     * @hourly
+Exemples de lancements de tâches :
+chaque demie-heure (***/30** est une instruction, pas deux)
+<code>*/30 * * * * commande</code>
+chaque heure, au début de l'heure (0 minute au démarrage de l'heure) :
+<code>0 * * * * commande</code>
+chaque heure, à la 30e minute de l'heure :
+<code>30 * * * * commande</code>
+chaque heure, mais uniquement entre 9h00 et 5h00
+<code>0 9-5 * * * commande</code>
 Cf. aussi :
    man 5 crontab
@@ Ligne 74: / Ligne 95: @@
 ===== 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**, tapez :
+Pour examiner les tâches planifiées de l'utilisateur courant (le contenu de votre **crontab**), tapez :
 <code bash>
@@ Ligne 104: / Ligne 125: @@
 ===== Lancement graphique =====
-Si vous avez besoin d'une interface graphique par exemple pour utiliser zenity, kdialog, dialog ou encore totem, vlc, ... Il vous faudra effectuer plusieurs choses :
+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|zenity]], kdialog, dialog ou encore [[totem|totem]], [[vlc|vlc]], ... Il vous faudra ajouter un **DISPLAY=:0** devant la commande lancée. Exemple :
-° ajouter un DISPLAY=:0 devant la commande dans le cron.
-Exemple :
 <code>
 */5 * * * * DISPLAY=:0 zenity --info --text="Toto va bien"
@@ Ligne 113: / Ligne 132: @@
 <note important>Il est parfois nécessaire de faire "xhost +" dans un terminal pour autoriser l'accès à X</note>
-° 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. D'autre part il est grandement conseillé de mettre le chemin absolu vers les exécutables et fichiers.
+===== Caractères UTF8 =====
-Exemple :
+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 =====
+Cron n'a pas de PATH par défaut. Il est donc __grandement conseillé__ de mettre le chemin absolu vers les exécutables et fichiers. Exemple :
 <code>
 #!/bin/bash
@@ Ligne 125: / Ligne 147: @@
 ===== 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, semines, mois les fichiers contenu dans les dossiers /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 dossiers /etc/cron.hourly, daily, weekly, 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 dossier /etc/cron.hourly et de le rendre exéctable. De même s'il s'agit d'une tâche quotidienne (daily), hebdomadaire (weekly) ou mensuelle (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 dossier /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).
@@ Ligne 133: / Ligne 155: @@
 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/crond.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 :
+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 :
 <code>* * * * * nom_utilisateur /bin/touch /home/me/ding_dong</code>
@@ Ligne 142: / Ligne 164: @@
 <code>sudo crontab -e</code>
 Remarque : 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 et 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.
+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.
+==== Répertoires ====
+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 **PATH** ne sont pas connues.
-<note important>
-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 PATH ne sont pas connues.
 Il faut donc soit mettre les emplacements complets des exécutables dans les commandes et les scripts appelés par cron, soit définir PATH dans le fichier crontab :
@@ Ligne 155: / Ligne 175: @@
 PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
 </code>
-Il peut être utile d'identifié le chemin où se trouve votre exécutable, exemple avec python :
+Il peut être utile d'identifier le chemin où se trouve votre exécutable, exemple avec python :
 <code bash>
 which python3
-# peut retourné par exemple
+# peut par exemple retourner
 /home/mon-compte/miniconda3/bin/python3
 </code>
-</note>
+De même, 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 :
+<code bash>
+* * * * * cd /home/mon-compte/wokspace/ && /home/mon-compte/miniconda3/bin/python3 mon_script.py
+</code>
+==== 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 :
@@ Ligne 171: / Ligne 197: @@
 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 :
-<code>MAILTO:jean.dupont@example.com</code>
+<code>MAILTO="jean.dupont@example.com"</code>
-**Attention**, pour que cela fonctionne il faut que votre machine soit capable d'envoyer des courriels.
+**Attention**, pour que cela fonctionne il faut que votre machine soit capable d'envoyer des courriels. (voir par exemple : [[msmtp|MSMTP]] ou [[postfix_systeme_satellite|Système Satellite pour Postfix]], [[exim4-satellite|Système satellite pour exim4]])
 Pour plus d'informations, lisez les pages du //man// pour **cron** et **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|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 un tâche n'est pas en retard.
+Sur une machine qui n'est pas allumée en permanence, **[[anacron|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.
 ==== Log ====
-Par défaut on retrouve des log de commandes CRON dans ///var/log/syslog// mais ce n'est pas très pratique.\\
+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
@@ Ligne 191: / Ligne 217: @@
 sudo systemctl restart cron
 </code>
-Il ne reste plus qu'à surveiller les log de CRON:
+Il ne reste plus qu'à surveiller les logs de CRON:
 <code bash>
 sudo tail -f /var/log/cron.log
 </code>
-et si vous voulez 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 de vos ligne CRON <code bash> > /dev/null 2>&1</code> pour rediriger les messages ET les erreurs vers le « trou noir ».
+et si vous voulez 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 de vos lignes CRON <code bash> > /dev/null 2>&1</code> pour rediriger les messages ET les erreurs vers le « trou noir ».
 ===== Liens =====
   * [[https://help.ubuntu.com/community/CronHowto]] (EN)