Skip to content

Latest commit

 

History

History
211 lines (151 loc) · 12 KB

guide.fr-ca.md

File metadata and controls

211 lines (151 loc) · 12 KB
title excerpt updated
Créer des tâches automatisées (CRON) sur votre hébergement web
Découvrez comment créer des tâches CRON pour automatiser vos tâches planifiées sur un hébergement web
2025-02-20
<style> pre { font-size: 14px !important; } pre.bgwhite { background-color: #fff !important; color: #000 !important; font-family: monospace !important; padding: 5px !important; margin-bottom: 5px !important; } pre.bgwhite code { background-color: #fff !important; border: solid 0px transparent !important; font-family: monospace !important; font-size: 0.90em !important; color: #000 !important; } .small { font-size: 0.90em !important; } </style>

Objectif

Sur votre hébergement Web OVHcloud, vous pouvez utiliser des scripts pour automatiser certaines opérations. La création d'une tâche planifiée (« tâche CRON ») est le moyen le plus simple de s'assurer que vos scripts s'exécutent à des moments spécifiques sans que d'autres actions soient nécessaires de votre part.

Découvrez comment créer des tâches CRON pour automatiser vos tâches planifiées sur un hébergement web.

Warning

OVHcloud met à votre disposition des services dont la configuration, la gestion et la responsabilité vous incombent. Il vous revient de ce fait d’en assurer le bon fonctionnement.

Nous mettons à votre disposition ce guide afin de vous accompagner au mieux sur des tâches courantes. Néanmoins, nous vous recommandons de faire appel à un prestataire spécialisé et/ou de contacter l’éditeur du service si vous éprouvez des difficultés. En effet, nous ne serons pas en mesure de vous fournir une assistance. Plus d’informations dans la section « Aller plus loin » de ce guide.

Prérequis

En pratique

Rendez-vous dans votre espace client OVHcloud{.external}. Cliquez sur l'onglet Web Cloud{.action}, puis sur Hébergements{.action}.

Sélectionnez l'hébergement concerné, cliquez sur l'onglet Plus{.action} puis sur Cron{.action}.

Dans cette section, vous aurez un aperçu de vos tâches planifiées et de leurs paramètres.

cron control panel{.thumbnail}

Création d'une tâche automatisée

Étape 1 : Définition des paramètres généraux

Pour créer une tâche CRON, cliquez sur le bouton Ajouter une planification{.action} à droite. Vous pouvez personnaliser les paramètres de la tâche dans la nouvelle fenêtre.

adding scheduling{.thumbnail}

Option Description
Commande à exécuter Définissez le chemin d'accès au fichier contenant votre script. Exemple : www/jobs/cron.php
Language Sélectionnez la version PHP utilisée par le script.
Activation Choisissez si la tâche sera active après sa création ou activée ultérieurement.
Logs par e-mail Si nécessaire, sélectionnez un contact (administrateur ou technicien) auquel un rapport sera envoyé en cas d'erreur d'exécution. Vous pouvez également fournir une autre adresse de messagerie.
Description Saisissez une description pour suivre l'exécution de vos tâches.

Cliquez sur Suivant{.action} pour passer à l'étape 2.

Étape 2 : Définition de la fréquence

L'interface offre deux modes pour configurer la fréquence de votre tâche. Utilisez le Mode Simple pour une sélection d'options de planification simplifiée pour les débutants. Si vous préférez entrer directement une fréquence, semblable à un format de table CRON (crontab), choisissez le Mode expert.

Mode simple
Utilisez les menus déroulants pour spécifier l'heure, les jours d'un mois, les jours de la semaine et les mois de la tâche.
cron frequency{.thumbnail}

[!primary]

Le formulaire Jours{.action} permet de définir des fréquences d'exécution sur un cycle mensuel.

Le formulaire Jours de la semaine{.action} permet de définir des fréquences d'exécution complémentaires mais sur un cycle hebdomadaire.

Mode expert
Entrez des valeurs numériques comme dans une crontab. Les astérisques indiquent chaque valeur de la période, ce qui signifie que la tâche s'exécuterait en continu une fois par heure tous les jours dans cet exemple.
cron frequency{.thumbnail}

Vous pouvez basculer entre les deux modes pendant la configuration pour visualiser les modifications en conséquence. Notez également les limitations lors de la planification d'une tâche sur un hébergement Web.

cron control panel{.thumbnail}

Étape 3 : Fin de l'installation

Le récapitulatif vous rappelle les paramètres configurés, y compris la notation crontab sur la fréquence d'exécution. Si tout est correct, cliquez sur Valider{.action}.

cron confirmation{.thumbnail}

La tâche sera prête dans quelques minutes. Vous pouvez alors modifier tous ses paramètres ou supprimer la tâche en cliquant sur ...{.action} dans la table de présentation de votre panneau de configuration OVHcloud.

Modifier ou supprimer une tâche planifiée

Cliquez sur les onglets ci-dessous pour afficher successivement chacune des 4 étapes.

[!tabs] Etape 1

Connectez-vous à votre espace client OVHcloud, puis rendez-vous dans la partie Web Cloud{.action}.

Web Cloud{.thumbnail}

Etape 2

Cliquez sur le menu Hébergements{.action}, puis choisissez l'hébergement web concerné.

Web Hosting{.thumbnail}

Etape 3

Sur la page qui s'affiche, cliquez sur l'onglet Plus{.action} puis sur Cron{.action}.

Etape 4

Dans le tableau qui apparaît, cliquez sur le bouton ...{.action} situé à droite de la tâche planifiée concernée.

Choisissez parmi les boutons Modifier{.action} ou Supprimer{.action} en fonction de l'action que vous souhaitez réaliser sur la tâche planifiée.

Limitations des tâches planifiées sur votre hébergement Web

Étape Description
Planification horaire Vous remarquerez que le champ "Minutes" est désactivé dans l'interface (défini par « ? » dans la vue crontab). Une tâche ne peut être exécutée qu'une fois par heure, c'est la fréquence de répétition la plus faible pouvant être spécifiée.
Durée La durée d'exécution d'une tâche est de 60 minutes. Si un script dépasse cette durée d'exécution, il sera automatiquement arrêté par le système.
Variables Vous ne pouvez définir que des variables dans un script. Les ajouter à l'URL appelant le script ne fonctionnera pas (Exemple : www/jobs/cron.php?variable=value).
Limite de données Une tâche ne peut générer que 5 Mo de données (stdin/stderr). Par exemple, si un script écrit des données dans un fichier .txt, l'exécution s'arrête automatiquement lorsque le fichier atteint 5 Mo.
Scripts produisant des erreurs Si un script est défectueux, il sera automatiquement désactivé après 10 tentatives d'exécution échouées. Le rapport d'erreur ne sera envoyé que lorsque les 10 tentatives auront échoué.
Corrigez votre script en fonction du rapport d'erreur reçu puis réactivez la « tâche CRON » dans le panneau de configuration (cliquez sur ...{.action} puis sur Modifier{.action}).
Rapports d'exécution Les rapports ne seront envoyés à l'adresse électronique sélectionnée qu'une fois par jour (pendant les heures de nuit).

Dépannage

Test de votre script avec un navigateur Web

Un test simple pour voir si votre script produira une erreur est de l'exécuter dans un navigateur Web. Par exemple, si le chemin d'accès de votre script est « www/cron.php » et que votre domaine d'hébergement est « mypersonaldomain.ovh », vous devez utiliser l'URL « http://mypersonaldomain.ovh/cron.php ». Si aucune erreur ne s'affiche mais que le script ne fonctionne pas comme prévu, suivez les suggestions ci-dessous.

Vérification de l'utilisation des chemins absolus

Veillez toujours à utiliser des chemins d'accès absolus aux fichiers de vos scripts. La constante « DIR », par exemple, peut aider à recevoir le chemin courant dans les scripts PHP (documentation PHP).

Vérification des logs d'éxecution

Dans [les logs] de votre hébergement Web, accessibles depuis votre espace client OVHcloud{.external}, vous verrez la catégorie de log intitulée « CRON ».

Consultez notre guide « Consulter les statistiques et les logs de mon site hébergé sur une offre mutualisée » pour plus de détails.

Exemple de logs
  • Exemple de fin de script correctement exécuté

[2023-08-11 00:36:01] ## OVH ## START - 2023-08-11 00:36:01.524384 executing: /usr/local/php7.2/bin/php /homez.161/myftpusername/www/myscript.sh
[2023-08-11 00:36:01] 
[2023-08-11 00:36:01] ## OVH ## END - 2023-08-10 22:39:44.086166 exitcode: 0
  • Exemple d'échec en raison d'un dépassement du temps d'exécution

[2023-08-11 00:36:01] ## OVH ## START - 2023-08-11 00:36:01.524384 executing: /usr/local/php7.2/bin/php /homez.161/myftpusername/www/sleep.sh

[2023-08-11 01:36:01] ## OVH ## ERROR - CRON TASK INTERRUPTED BY OVH - reason: your script duration exceeded the maximum permitted (3600 seconds)
[2023-08-11 01:36:01] ## OVH ## END - 2023-08-11 01:36:01.086166 exitcode: 0
  • Exemple d'échec car le fichier de script est introuvable dans le chemin d'accès spécifié

[2023-08-11 00:36:01] ## OVH ## START - 2023-08-11 00:36:01.524384 executing: /usr/local/php7.2/bin/php /homez.161/myftpusername/www/noscript.sh

[2023-08-11 00:36:01] ## OVH ## ERROR command '/homez.161/myftpusername/www/noscript.sh' not found
[2023-08-11 00:36:01] ## OVH ## END - 2023-08-11 00:36:01.086166 exitcode: 255
  • Exemple d'échec en raison d'une erreur d'autorisation (chmod) ou d'une configuration incorrecte du fichier .ovhconfig

[2023-08-11 18:07:10] ## OVH ## Your job could not be initiated for an unknown reason.
[2023-08-11 18:07:10]
[2023-08-11 18:07:10] ## OVH ## END - 2023-08-11 18:07:10.969840 exitcode: 255

Aller plus loin

Configurer le fichier .ovhconfig de son hébergement web

Utiliser l’accès SSH de son hébergement web

Consulter les statistiques et les logs de mon site hébergé sur une offre mutualisée

Pour des prestations spécialisées (référencement, développement, etc), contactez les partenaires OVHcloud.

Si vous souhaitez bénéficier d'une assistance à l'usage et à la configuration de vos solutions OVHcloud, nous vous proposons de consulter nos différentes offres de support.

Échangez avec notre communauté d'utilisateurs.