Planification et cron système avec WP-CLI – cloneworx Aide

Avec wp cloneworx-backup scheduler, tu vois quand tes plans de sauvegarde s’exécutent et tu déclenches la planification depuis la ligne de commande. La même commande est la ligne pour un cron système : ainsi, tes sauvegardes démarrent à l’heure, même si personne ne visite le site.

WP-CLI manque encore ? Le guide se trouve dans Installer WP-CLI. Toutes les commandes de l’extension sont présentées dans Les commandes en un coup d’œil.

Comment fonctionne la planification

Un plan de sauvegarde actif s’exécute à sa prochaine échéance. Pour cela, l’extension vérifie à chaque planificateur si un plan est dû. Cette vérification s’appelle un cycle. Les planificateurs sont :

le cycle propre de l’extension dans WP-Cron, toutes les 15 minutes,
un événement de réveil dans WP-Cron, placé exactement sur la prochaine échéance,
la page Vue d'ensemble ou Sauvegarde ouverte, toutes les 60 secondes,
la fin de chaque tâche,
la ligne de commande avec scheduler tick.

WP-Cron ne s’exécute que si quelqu’un appelle le site. Si un planificateur arrive dans l’heure qui suit l’échéance, le plan s’exécute. Ensuite, l’échéance est considérée comme manquée : rien ne démarre, le plan note l’échéance, écrit un avertissement dans le journal général et passe à sa prochaine échéance régulière. Un site qui n’a ni visiteurs ni cron système autour de ses échéances ne fait donc pas de sauvegardes.

Une seule tâche s’exécute à la fois. Si plusieurs plans sont dus, ils s’exécutent l’un après l’autre. Une échéance qui tombe pendant une tâche en cours est considérée comme respectée : le plan démarre directement après cette tâche.

Afficher la planification : status

scheduler status affiche l’état de la planification. L’action ne change rien et n’a pas de paramètres. Sans action, wp cloneworx-backup scheduler fait la même chose.

# Afficher l’état de la planification
wp cloneworx-backup scheduler status

La sortie est en anglais et indique de haut en bas :

Ligne	Signification
`Now`	L’heure du site et le délai de grâce : 60 minutes. Si un planificateur arrive plus tard, l’échéance est considérée comme manquée.
une ligne par plan actif	Identifiant et nom du plan, la prochaine exécution et la dernière exécution avec son déclencheur. `DUE NOW` signifie : le plan est dû maintenant. `missed` indique une échéance manquée. `could not start` signifie : le plan n’a pas pu démarrer à sa dernière échéance ; la raison figure entre parenthèses.
`Wake event`	Le moment de l’événement de réveil, ou `none`.
`Last tick`	Le dernier cycle avec son planificateur entre parenthèses, ou `never`.
`Last start on schedule`	Le dernier démarrage selon la planification : plan, sauvegarde, moment, retard et planificateur.
`Active job`	La tâche en cours d’exécution. La ligne manque si aucune n’est en cours.

S’il n’y a aucun plan actif, on y lit no active plan. Les planificateurs sont nommés ainsi dans la sortie :

Dans la sortie	Planificateur
`cron`	le cycle de l’extension dans WP-Cron
`wake`	l’événement de réveil
`rest`	la page de l’extension ouverte dans le navigateur
`cli`	la ligne de commande
`job_end`	la fin d’une tâche

Exécuter un cycle : tick

scheduler tick exécute un cycle. Ce qui se passe ensuite dépend de la situation :

Situation	Ce que fait la commande
Aucun plan n’est dû.	Elle nomme le plan avec la prochaine échéance et se termine. Si aucun plan n’est actif, elle le dit.
Un plan est dû.	Elle lance la sauvegarde du plan avec l’échéance la plus ancienne et la mène jusqu’au bout dans ce processus. Suivent ensuite le post-traitement et le prochain plan dû.
Une tâche est déjà en cours.	Elle nomme la tâche et la mène à terme dans ce processus. Un plan dû suit ensuite.
Une échéance est manquée.	Elle avertit et nomme les plans. Pour cette échéance, rien ne démarre.
Un plan dû ne peut pas démarrer.	Elle avertit et indique la raison. L’échéance est considérée comme exécutée ; la suivante est planifiée.

Paramètre	Signification	Valeurs autorisées
`--background`	La commande ne fait que lancer le plan dû. Le site poursuit la sauvegarde lui-même.	sans valeur
`--force`	S’exécute aussi en tant qu’un autre utilisateur que celui à qui appartiennent les dossiers de l’extension.	sans valeur

# Exécuter un cycle et faire avancer ici une sauvegarde due
wp cloneworx-backup scheduler tick

# Exécuter un cycle et laisser la sauvegarde au site
wp cloneworx-backup scheduler tick --background

Si une sauvegarde démarre, la commande nomme le plan, l’échéance, le retard et le nom de tâche de la sauvegarde. Suit ensuite la sortie comme pour une sauvegarde manuelle : une ligne par étape, le résultat à la fin. Elle est décrite dans Créer et gérer les sauvegardes avec WP-CLI.

Chaque cycle vérifie en outre si une sauvegarde est en retard, au plus toutes les 15 minutes.

La ligne pour le cron système

Un cron système est la planification du serveur. Il appelle le cycle toutes les cinq minutes, indépendamment des visiteurs :

# Exécuter un cycle toutes les cinq minutes
*/5 * * * * cd /pfad/zu/wordpress && wp cloneworx-backup scheduler tick --quiet

La ligne prête pour ton installation, avec le chemin vers ton WordPress, se trouve sur la page Réglages dans la tuile Planificateur. La tuile apparaît dans la vue Étendu.
La tuile affiche deux lignes. La première appelle WP-CLI comme ci-dessus. La seconde appelle wp-cron.php via l’adresse du site. Copier copie la première ligne.
Inscris la ligne dans le cron de l’utilisateur à qui appartiennent les dossiers de l’extension. Si le cron s’exécute en tant qu’un autre utilisateur, la commande se termine par une erreur et ne lance rien.
--quiet est un paramètre de WP-CLI, pas de l’extension.

Comment inscrire la ligne chez ton hébergeur, c’est expliqué dans Lancer les sauvegardes à l’heure : configurer un cron système.

Vérifier que le cron système fonctionne

Attends cinq minutes après l’inscription. scheduler status affiche alors dans la ligne Last tick un moment des dernières minutes. Si cli figure entre parenthèses, ce cycle venait de la ligne de commande.

Dans ce processus ou en arrière-plan

Appel	Qui mène la sauvegarde
`scheduler tick`	La commande elle-même, dans son processus, jusqu’au bout. Le réglage Pause entre les étapes ne s’applique pas. La commande ne se termine que lorsque la sauvegarde, le post-traitement et chaque autre plan dû sont terminés.
`scheduler tick --background`	Le site. La commande lance la sauvegarde, envoie la première auto-requête et se termine immédiatement. Ensuite, la tâche se poursuit d’elle-même via le serveur web ; WP-Cron est le filet en dessous.

Si l’auto-requête ne peut pas être envoyée, la commande avertit. WP-Cron poursuit alors la tâche. wp cloneworx-backup job status affiche la progression d’une tâche en arrière-plan.

Voir aussi