Fiche
crontab n’a pas l’environnement de votre shell : le piège du PATH
Une tâche qui passe à la main et échoue à l’heure dite : cron ne lit ni .zshrc ni .bash_profile et fournit un PATH minimal. La commande est la bonne, l’environnement ne l’est pas.
cron ne lance pas votre shell : il lance /bin/sh avec un environnement réduit. SHELL, HOME et LOGNAME sont fournis par le démon, et le PATH reste un chemin système minimal, souvent /usr/bin:/bin. Les variables exportées dans .zshrc, .bash_profile ou .profile ne sont jamais lues, et un gestionnaire de versions comme nvm ou pyenv n’existe pas dans ce contexte. Une tâche qui appelle node, python3, date ou docker peut donc échouer à 3 h du matin alors qu’elle passe à la main.
Ce que le démon fournit, et ce qu’il ne fournit pas
La page crontab(5) est explicite : SHELL vaut /bin/sh, LOGNAME et HOME viennent de la ligne /etc/passwd du propriétaire de la table. HOME et SHELL peuvent être redéfinis dans cette table, LOGNAME non. Le PATH, lui, n’est pas fixé par la spécification : il est hérité du démon, donc du gestionnaire de services qui l’a lancé.
Les lignes NOM=valeur en tête de table sont lues par cron et définissent l’environnement des commandes. C’est le seul endroit où un PATH= s’applique à toutes les tâches du fichier, sans dépendre d’un fichier de profil que personne ne lit.
Le PATH, ou pourquoi ce n’est pas la même commande
Sur un Mac à processeur Apple, Homebrew installe dans /opt/homebrew/bin, absent du PATH minimal de cron. Sur une machine Linux, /usr/local/bin est souvent absent aussi. Le binaire n’est donc pas seulement introuvable : il peut être une autre version, plus ancienne, avec d’autres options.
Le cas de date est net. BSD date et GNU date ne lisent pas les mêmes options : -d n’existe pas sur macOS, et -r prend un fichier sous GNU alors qu’il prend un nombre de secondes sous BSD. Une tâche qui calcule la date de la veille peut donc produire un résultat différent, ou s’arrêter sur une erreur d’option, selon le date que le PATH a laissé passer.
Le % qui devient un saut de ligne
Dans la partie commande d’une ligne de table, un % non échappé est converti en saut de ligne, et tout ce qui suit le premier % est envoyé sur l’entrée standard de la commande. Écrire date +%Y-%m-%d dans une table ne produit donc pas la date attendue : il faut date +\%Y-\%m-\%d, ou déplacer la logique dans un script. C’est la cause de la moitié des entrées « qui ne font rien », avant même la question du PATH.
La méthode qui rend une tâche reproductible
- Chemins absolus pour chaque binaire :
/usr/bin/date,/opt/homebrew/bin/node, plutôt quedateounode. PATH=explicite en tête de table, avant toute commande, sans commentaire sur la même ligne.- Script enveloppe avec
#!/bin/bash,set -euo pipefail, et uncdvers le répertoire de travail, car cron démarre dansHOME. - Un verrou
flockquand la tâche peut dépasser l’intervalle, sinon les exécutions se chevauchent et se marchent dessus. - Sortie standard et sortie d’erreur redirigées vers un fichier horodaté, sinon l’échec est invisible.
Reproduire l’environnement avant de modifier la table
La commande env -i /bin/sh -c 'commande' rejoue la tâche avec un environnement vide et révèle immédiatement ce qui manque. Pour la preuve, une ligne jetable de la table peut écrire env, command -v node et pwd dans un fichier : la différence entre votre terminal et cron devient un document, pas une hypothèse.
Cette preuve se garde. Elle évite les allers-retours du type « ça marche chez moi » : le fichier montre le PATH réel, l’utilisateur réel et le répertoire réel au moment du déclenchement.
Vérifier avant d’accuser cron
Trois vérifications suffisent dans la plupart des cas. crontab -l pour l’utilisateur courant, puis avec sudo pour root, parce que la tâche est souvent installée ailleurs. Les fichiers de /etc/cron.d et de /etc/cron.daily pour les tâches système. Enfin, sur une machine Linux, systemctl list-timers : une minuterie peut exécuter la même tâche et donner l’impression que cron se déclenche deux fois.
Reste le fuseau. cron utilise celui du système, pas celui de votre terminal. Une tâche prévue à 02:30 saute une fois par an au printemps et s’exécute deux fois à l’automne. Une heure de décalage dans une table de correspondance est plus fréquente qu’un défaut de cron, et se corrige en écrivant l’heure en UTC dans le script, pas dans la table.