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 n’est pas encore installé ? 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 indiques une sauvegarde par le nom de sa tâche : date, heure et un identifiant de 32 caractères.
backup listaffiche le nom de la tâche. Dans les exemples, il est noté<Job>. - Tu indiques une destination dans
--targetpar son identifiant, par exemplelocal-1.wp cloneworx-backup target listaffiche 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 indique la tâche en cours.
- Les sorties des commandes sont en anglais.
-
backup run,backup check,backup deleteetretention runvé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.--forcepasse 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. Le fichier wp-config.php ne fait jamais partie d’une sauvegarde ; avec wp-config, la commande s’arrête. |
Racines, séparées par des virgules : db, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
|
--target |
Où va la sauvegarde. Obligatoire : une sauvegarde ne va jamais d’elle-même vers toutes les destinations. | L’identifiant d’une destination utilisable. Exactement une destination ; wp pro-backup run accepte plusieurs destinations avec --targets. |
--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 la destination local-1 wp cloneworx-backup backup run --target=local-1 # Sauvegarder seulement la base de données et les téléversements vers une destination wp cloneworx-backup backup run --roots=db,wp-uploads --target=local-1 # Lancer la sauvegarde et la laisser au site wp cloneworx-backup backup run --target=local-1 --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. Pendant le transfert, la phase indique la destination et, s’il y en a plusieurs, sa position, par exemple transfer to "SFTP 1" (2/3). À la fin, elle indique le nombre d’étapes et d’avertissements. Dessous figure le résumé : racines, destinations, taille enregistrée, l’espace par emplacement, la base de données, les fichiers, les parties et, par destination, le résultat du transfert. Si la sauvegarde a laissé de côté une autre installation WordPress à l’intérieur du site, la ligne not backed up indique son dossier.
Après une sauvegarde correcte, le même processus exécute 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.
Sans plan signifie : comptage à part
Une sauvegarde issue de backup run compte dans le groupe manual. Le réglage Sauvegardes max. sans plan, par défaut 7, détermine combien il en reste.
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 indique 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. Sur la page Sauvegarde, la colonne Plan affiche à leur place les mots manuel, importée et récupérée.
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. Si l’extension est en train de supprimer la sauvegarde sur une destination, backup lock refuse. 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 la taille attendue, 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 externe, 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 la sauvegarde échoue à la vérification sur une destination, elle 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 nom du fichier que la commande écrit, sans chemin. Le fichier est créé dans le dossier cloneworx-backup-exports-… du dossier des téléversements et ne doit pas encore exister. Sans ce paramètre, il s’appelle backup-<Job>.tar. |
Nom de fichier composé de lettres, de chiffres, de points, de tirets bas et de tirets |
# Écrire la sauvegarde sous forme de fichier tar wp cloneworx-backup backup download <Job> --to=backup.tar
La commande indique le fichier avec son chemin complet, 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. Tu récupères de là-bas, avec ton propre programme, une sauvegarde qui ne se trouve que sur des destinations externes, 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 |
|---|---|---|
--target |
Ne supprime que sur cette destination. Les copies sur les autres destinations restent. Tant qu’il reste une copie, la sauvegarde reste dans la liste. | L’identifiant d’une destination |
--entry-only |
Retire seulement l’entrée de la liste. La commande ne supprime rien sur les destinations, et aucune tâche ne s’exécute. Ce n’est possible que tant qu’au moins une destination n’a plus la sauvegarde, ne répond pas ou a été retirée. La commande le vérifie après la demande de confirmation : si chaque destination a encore la sauvegarde, elle se termine par une erreur. Tu supprimes sans ce paramètre une entrée sans copie, par exemple une sauvegarde échouée. | sans valeur |
--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> --target=local-1 --yes # Retirer seulement l’entrée, sans rien supprimer sur les destinations wp cloneworx-backup backup delete <Job> --entry-only
- 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. - La commande ne touche pas à une destination qui a été retirée : la sauvegarde perd seulement la référence à cette destination, rien n’y est supprimé. Les nombres à la fin ne le comptent ni comme supprimé ni comme échoué.
- 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 copies elle a supprimées et pour combien la suppression a échoué. Une destination dont le dossier appartient à une autre installation compte comme un échec et figure entre parenthèses. La ligne indique aussi une sauvegarde verrouillée entre-temps. Pour en savoir plus : Supprimer une sauvegarde.
La dernière sauvegarde correcte sur une destination
Si la sauvegarde est la dernière correcte sur une destination, la commande avertit et indique la destination. La suppression reste permise. Avec --yes, aucune demande de confirmation ne suit plus l’avertissement.
Afficher et supprimer les sauvegardes obsolètes : retention
L’extension conserve par plan de sauvegarde et par destination autant de sauvegardes correctes 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 sauvegarde correcte la plus récente n’est jamais retirée. Cela se fait de soi-même après chaque sauvegarde correcte. 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 exécute 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 signale en une phrase. retention run indique à la fin combien de sauvegardes ont été supprimées.