Créer et gérer les sauvegardes avec WP-CLI

Avec wp cloneworx-backup backup, tu lances une sauvegarde sans plan et tu gères les sauvegardes de la liste : afficher, verrouiller, vérifier, télécharger, supprimer. wp cloneworx-backup retention affiche quelles anciennes sauvegardes seront retirées et les supprime immédiatement si tu le souhaites.

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.

Ce qui vaut pour toutes les actions

• Tu nommes une sauvegarde par le nom de sa tâche : date, heure et un identifiant de 32 caractères. backup list affiche le nom de la tâche. Dans les exemples, il est noté <Job>.
• Tu nommes une destination dans --targets par son identifiant, par exemple local-1. wp cloneworx-backup target list affiche les identifiants.
• Une seule tâche s’exécute à la fois par site. Si une tâche est déjà en cours, chaque commande qui lance une tâche se termine par une erreur et nomme la tâche en cours.
• Les sorties des commandes sont en anglais.
• backup run, backup check, backup delete et retention run vérifient d’abord l’utilisateur : la commande doit s’exécuter en tant que l’utilisateur à qui appartiennent les dossiers de l’extension. Le site ne pourrait plus modifier ni supprimer par la suite les fichiers qu’un autre utilisateur crée. --force passe outre la vérification.

Lancer une sauvegarde sans plan : run

backup run lance immédiatement une sauvegarde et la mène jusqu’au bout dans ce processus. La sauvegarde n’appartient à aucun plan. Un plan de sauvegarde s’exécute avec wp cloneworx-backup plan run ; pour en savoir plus, consulte Gérer les plans de sauvegarde avec WP-CLI.

Paramètre	Signification	Valeurs autorisées
--roots	Ce qui est sauvegardé. Sans ce paramètre, l’extension sauvegarde tout.	Racines, séparées par des virgules : db, wp-config, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
--targets	Où va la sauvegarde. Sans ce paramètre, elle va vers chaque destination utilisable.	Identifiants de destinations utilisables, séparés par des virgules
--no-snapshot	Lit la base de données sans instantané. L’instantané est le choix par défaut.	sans valeur
--background	La commande ne fait que lancer la sauvegarde. Le site la poursuit lui-même.	sans valeur
--max-per-step	Termine chaque étape après ce nombre d’entrées ou de lignes. Ce paramètre sert au diagnostic.	nombre entier
--force	S’exécute aussi en tant qu’un autre utilisateur.	sans valeur

Une racine est une partie nommée du site : la base de données ou un dossier. Ce qui se trouve dans quelle racine est expliqué dans Réglages et périmètre avec WP-CLI.

# Tout sauvegarder vers chaque destination utilisable
wp cloneworx-backup backup run

# Sauvegarder seulement la base de données et les téléversements vers une destination
wp cloneworx-backup backup run --roots=db,wp-uploads --targets=local-1

# Lancer la sauvegarde et la laisser au site
wp cloneworx-backup backup run --background

Pendant que la sauvegarde s’exécute, la commande écrit une ligne par étape : la phase, les entrées et octets traités et le temps restant, dès que l’extension le connaît. À la fin, elle indique le nombre d’étapes et d’avertissements. En dessous figure le résumé : racines, destinations, taille stockée, l’espace par emplacement, la base de données, les fichiers, les parties et, par destination, le résultat du transfert.

Après une bonne sauvegarde, le même processus mène le post-traitement : l’extension supprime les sauvegardes obsolètes et nettoie sur les destinations les restes des tâches interrompues.

Si la sauvegarde se termine par une erreur, la commande indique les derniers messages de la tâche, l’état par destination et la raison. Pour une erreur sur une destination, le message de la destination figure en dessous, inchangé, dans la ligne target:.

Avec --background, la commande revient immédiatement. wp cloneworx-backup job status affiche alors la progression.

Lister les sauvegardes : list

backup list affiche les sauvegardes de la liste, la plus récente en premier. Sans action, wp cloneworx-backup backup fait la même chose.

Paramètre	Signification	Valeurs autorisées
--limit	Combien de sauvegardes la sortie affiche.	1 à 100, par défaut 20

# Afficher les 20 dernières sauvegardes
wp cloneworx-backup backup list

# Afficher seulement les 5 dernières
wp cloneworx-backup backup list --limit=5

Chaque ligne indique une sauvegarde : nom de la tâche, statut, plan, fin, taille et, par destination, l’état de la sauvegarde là-bas. À la fin de la ligne figure locked si la sauvegarde est verrouillée. La dernière ligne dit combien de sauvegardes la sortie affiche et combien il y en a.

Statut dans la sortie	Dans le filtre d’état de la page Sauvegarde
running	En cours
success	Complète
warnings	Avec avertissements
error	Échouée
aborted	Interrompue

Dans la colonne du plan figure l’identifiant du plan, par exemple plan-1. manual désigne une sauvegarde sans plan, import une sauvegarde importée et rediscovered une sauvegarde retrouvée sur une destination.

Verrouiller une sauvegarde et la déverrouiller : lock, unlock

backup lock verrouille une sauvegarde. Une sauvegarde verrouillée n’est jamais supprimée automatiquement et n’est pas comptée dans Sauvegardes max.. Elle ne peut être supprimée à la main qu’après backup unlock. Les deux actions n’ont pas de paramètres.

# Verrouiller une sauvegarde
wp cloneworx-backup backup lock <Job>

# Déverrouiller la sauvegarde
wp cloneworx-backup backup unlock <Job>

La commande confirme le verrouillage ou sa fin en une phrase. Plus de détails sur le verrouillage : Protéger une sauvegarde contre la suppression.

Vérifier une sauvegarde : check

backup check lit une sauvegarde sur chaque destination où elle est complète ou notée comme endommagée : une nouvelle vérification peut changer le résultat. Rien n’est réécrit. L’extension vérifie que chaque fichier est présent avec sa taille, que le fichier d’information est valide, que chaque partie correspond à sa somme de contrôle et que chaque bloc peut être lu. Elle lit un dossier local sur place. Depuis une destination distante, elle récupère une partie après l’autre dans le dossier de travail.

Paramètre	Signification	Valeurs autorisées
--targets	Ne vérifie que sur ces destinations. Sans ce paramètre : sur chaque destination où la sauvegarde est complète ou notée comme endommagée.	Identifiants, séparés par des virgules
--background	La commande ne fait que lancer la vérification. Le site poursuit la tâche lui-même.	sans valeur
--max-per-step	Termine chaque étape après ce nombre de blocs. Ce paramètre sert au diagnostic.	nombre entier
--force	S’exécute aussi en tant qu’un autre utilisateur.	sans valeur

# Vérifier une sauvegarde sur toutes ses destinations
wp cloneworx-backup backup check <Job>

# Vérifier seulement sur une destination
wp cloneworx-backup backup check <Job> --targets=local-1

La sortie a une ligne par destination avec le résultat :

Résultat	Signification
ok	La sauvegarde y est lisible et complète. La ligne indique les parties, les entrées et les octets lus.
damaged or incomplete	La sauvegarde y est endommagée ou incomplète. La ligne indique les constats.
not checked	La destination n’a pas répondu. C’est un avertissement, pas un dommage.
not complete at this target	La sauvegarde n’est pas complète sur cette destination.

La dernière ligne fait le total. Si une destination échoue, la sauvegarde y est considérée comme endommagée : elle n’est plus comptée dans Sauvegardes max. et n’est jamais supprimée automatiquement. Pour en savoir plus : Vérifier une sauvegarde.

Écrire une sauvegarde dans un fichier : download

backup download écrit une sauvegarde sous forme de fichier tar sur le serveur. Le fichier contient un dossier portant le nom de la tâche, avec à l’intérieur le fichier d’information, l’index et les parties. L’extension lit sur la première destination locale où la sauvegarde est complète.

Paramètre	Signification	Valeurs autorisées
--to	Le fichier que la commande écrit. Obligatoire. Le fichier ne doit pas encore exister, et son dossier doit être accessible en écriture.	Chemin d’un fichier

# Écrire la sauvegarde sous forme de fichier tar
wp cloneworx-backup backup download <Job> --to=/tmp/backup.tar

La commande indique le fichier, sa taille, le nombre de fichiers qu’il contient et la destination sur laquelle elle a lu. Si la sauvegarde n’est complète sur aucune destination locale, elle se termine par une erreur. Une sauvegarde qui ne se trouve que sur des destinations distantes, tu la récupères de là-bas avec ton propre programme, par exemple ton programme FTP. Pour en savoir plus : Télécharger une sauvegarde.

wp cloneworx-backup import accepte le même fichier en retour ; voir Restaurer et importer avec WP-CLI.

Supprimer une sauvegarde : delete

backup delete supprime une sauvegarde sur chaque destination où elle se trouve. Avec sa dernière copie, la sauvegarde disparaît de la liste. Avant la suppression, la commande demande confirmation.

Paramètre	Signification	Valeurs autorisées
--targets	Ne supprime que sur ces destinations. Les copies sur les autres destinations restent. Tant qu’il reste une copie, la sauvegarde reste dans la liste.	Identifiants, séparés par des virgules
--yes	Supprime sans demande de confirmation.	sans valeur
--force	S’exécute aussi en tant qu’un autre utilisateur.	sans valeur

# Supprimer une sauvegarde partout, avec demande de confirmation
wp cloneworx-backup backup delete <Job>

# Supprimer seulement la copie sur une destination, sans demande de confirmation
wp cloneworx-backup backup delete <Job> --targets=local-1 --yes

• La commande refuse une sauvegarde verrouillée. Déverrouille-la d’abord.
• La commande refuse une sauvegarde en cours. Interromps-la d’abord : wp cloneworx-backup job abort.
• Une entrée sans copie, par exemple une sauvegarde échouée ou interrompue, disparaît immédiatement de la liste, sans demande de confirmation et sans tâche.

La suppression s’exécute comme une tâche dans ce processus. À la fin, la commande indique combien de sauvegardes ont été supprimées et combien de tentatives ont échoué. Pour en savoir plus : Supprimer une sauvegarde.

Afficher et supprimer les sauvegardes obsolètes : retention

L’extension conserve par plan de sauvegarde et par destination autant de bonnes sauvegardes que Sauvegardes max. l’indique dans le plan. Les plus anciennes sont retirées. Les sauvegardes verrouillées ne sont pas comptées et ne sont jamais retirées automatiquement. La bonne sauvegarde la plus récente n’est jamais retirée. Cela se fait de soi-même après chaque bonne sauvegarde. Avec wp cloneworx-backup retention, tu le vois à l’avance ou tu le déclenches à la main.

Action	Objectif
retention list	Affiche quelles sauvegardes seraient retirées maintenant. Ne supprime rien. Sans action, la commande fait la même chose.
retention run	Supprime ces sauvegardes maintenant et mène la tâche dans ce processus.

Paramètre	Signification	Valeurs autorisées
--plan	Seulement ce groupe. Sans ce paramètre : chaque plan et les sauvegardes sans plan.	Identifiant d’un plan, par exemple plan-1, ou manual
--force	Seulement run : s’exécute aussi en tant qu’un autre utilisateur.	sans valeur

# Afficher ce qui serait supprimé
wp cloneworx-backup retention list

# Supprimer maintenant, pour un seul plan de sauvegarde
wp cloneworx-backup retention run --plan=plan-1

# Supprimer maintenant, seulement les sauvegardes sans plan
wp cloneworx-backup retention run --plan=manual

retention list indique par ligne une sauvegarde, la destination et le groupe : le nom du plan ou manual. La dernière ligne compte les suppressions. Si rien n’est retiré, la commande le dit en une phrase. retention run indique à la fin combien de sauvegardes ont été supprimées.

Voir aussi

• La page « Sauvegarde »
• Créer une sauvegarde tout de suite
• Définir combien de sauvegardes sont conservées
• Gérer les plans de sauvegarde avec WP-CLI
• État, journaux et support avec WP-CLI