Restaurer et importer avec WP-CLI

Avec wp cloneworx-backup restore, tu vérifies avant une restauration si elle peut réussir, tu restaures une sauvegarde et tu conserves la restauration ou tu l’annules. Avec wp cloneworx-backup import, tu ajoutes à la liste une sauvegarde issue d’un fichier.

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. wp cloneworx-backup backup list l’affiche. Dans les exemples, il est noté <Job>. Une sauvegarde avec le statut success ou warnings peut être restaurée.
• 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 sont en anglais. Le délai du retour en arrière y figure en UTC.
• Toutes les actions sauf restore status vérifient d’abord l’utilisateur : la commande doit s’exécuter en tant que l’utilisateur à qui appartiennent les dossiers de l’extension. Pour restore precheck et import, --force passe outre la vérification. Pour restore run, keep et undo, il n’y a pas de --force : le site ne pourrait plus modifier ensuite les fichiers d’un autre utilisateur.

Vérifier avant la restauration : precheck

restore precheck exécute la vérification préalable : neuf points avant qu’une restauration n’écrive quoi que ce soit. La vérification préalable ne change rien au site. Pour le test des droits, elle crée des dossiers et des tables et les supprime à nouveau.

Paramètre	Signification	Valeurs autorisées
--target	La destination sur laquelle l’extension lit la sauvegarde. Sans ce paramètre : la première destination locale où la sauvegarde est complète, sinon la première autre.	Identifiant d’une destination
--roots	Ce qui est restauré. Sans ce paramètre : chaque racine de la sauvegarde. wp-config n’est jamais restauré.	Racines, séparées par des virgules, par exemple db,wp-uploads
--include-core	Restaure le cœur de WordPress aussi sur un autre site.	sans valeur
--include-dropins	Restaure object-cache.php, advanced-cache.php et db.php aussi sur un autre site.	sans valeur
--include-htaccess	Restaure .htaccess, web.config et .user.ini aussi sur un autre site.	sans valeur
--uploads-in-place	Choisit pour les téléversements la voie sans retour en arrière, si l’espace à côté du dossier actif ne suffit pas.	sans valeur
--force	S’exécute aussi en tant qu’un autre utilisateur.	sans valeur

Les trois paramètres --include n’agissent que si la sauvegarde provient d’un autre site ou si son origine est inconnue. Sur le même site, l’extension restaure par défaut le cœur, les drop-ins et .htaccess.

# Exécuter la vérification préalable pour une sauvegarde
wp cloneworx-backup restore precheck <Job>

# Lire la sauvegarde sur une destination précise, seulement deux racines
wp cloneworx-backup restore precheck <Job> --target=local-1 --roots=db,wp-uploads

La première ligne de la sortie indique la sauvegarde, la destination sur laquelle elle a été lue, les racines et l’origine : le même site, un autre ou inconnue. Suit ensuite une ligne par point avec l’état et le constat.

État	Signification
OK	Le point est en ordre.
WARN	Quelque chose que tu devrais savoir. C’est toi qui décides. Un avertissement ne bloque jamais la restauration.
FAIL	La restauration ne peut pas démarrer.
UNKNOWN	Le point n’a pas pu être déterminé.

Point dans la sortie	Dans l’interface
readable	Sauvegarde lisible et complète
versions	Version de PHP et MySQL
space	Espace libre
permissions	Droits d’écriture sur les dossiers cibles
packet	max_allowed_packet par rapport à la plus grande ligne
collations	Collations
fingerprint	Même site web
db_rights	Droits de base de données (test)
loopback	Auto-requête possible

Sous les points figure ce qui n’est pas restauré et pourquoi. Enfin, la sortie liste les différences entre la sauvegarde et ce site : par ligne, la valeur dans la sauvegarde et la valeur ici. Le risque de ces différences, tu le vérifies toi-même. Si un point a l’état FAIL, la commande se termine par une erreur. Chaque point est expliqué dans La vérification préalable de la restauration : chaque point expliqué.

Restaurer une sauvegarde : run

restore run restaure les racines choisies. Cela se passe ainsi :

1. La vérification préalable s’exécute comme première phase. Un FAIL termine la tâche avant que quoi que ce soit ne soit écrit.
2. L’extension prépare les fichiers à côté des dossiers actifs et importe la base de données dans des tables à côté des tables actives. Le site continue de fonctionner pendant ce temps.
3. Les téléversements et les fichiers du dossier racine sont basculés par l’extension fichier par fichier, sans mode maintenance.
4. La base de données, le cœur, les mu-plugins, les extensions, les thèmes et le reste de wp-content sont basculés par l’extension dans le mode maintenance de WordPress. Cette étape s’exécute dans le serveur web : la commande la confie via l’auto-requête et attend.
5. Le nouveau site se confirme lui-même. Si la confirmation n’arrive pas dans les 60 secondes, la même étape rebascule, et le site fonctionne de nouveau dans l’ancien état.

Si l’auto-requête n’arrive pas au serveur web dans les 60 secondes, la commande interrompt la restauration avant le basculement. L’extension reprend ce qui avait été basculé jusque-là, et le site continue de fonctionner dans son état précédent. Seuls les téléversements remplacés sur place avec --uploads-in-place restent remplacés.

Ne sont jamais restaurés l’extension elle-même avec ses dossiers et ses tables, ainsi que wp-config.php. Les fichiers des téléversements et du dossier racine qui ne sont pas dans la sauvegarde restent en place. Les tables de ce site qui ne sont pas dans la sauvegarde restent ; le résultat les nomme.

Paramètre	Signification	Valeurs autorisées
--target, --roots, --include-core, --include-dropins, --include-htaccess, --uploads-in-place	Comme pour restore precheck.	comme ci-dessus
--remove-extra-uploads	Déplace les téléversements absents de la sauvegarde vers l’état précédent. Avec restore undo, ces téléversements reviennent. Par défaut, ils restent en place.	sans valeur
--accept-damaged	Restaure aussi une sauvegarde avec des entrées endommagées et omet précisément ces entrées. Sans ce paramètre, la restauration se termine avant que quoi que ce soit ne soit basculé et indique le nombre d’entrées endommagées.	sans valeur
--without-confirmation	Bascule dans ce processus, sans la confirmation du nouveau site. Pour les serveurs où l’auto-requête ne fonctionne pas.	sans valeur
--background	La commande ne fait que lancer la restauration. Le site la poursuit lui-même.	sans valeur

# Restaurer la sauvegarde entière
wp cloneworx-backup restore run <Job>

# Restaurer seulement la base de données
wp cloneworx-backup restore run <Job> --roots=db

# Restaurer seulement les plugins et les thèmes
wp cloneworx-backup restore run <Job> --roots=wp-plugins,wp-themes

La commande écrit une ligne de progression par étape. Pendant que le serveur web bascule, la commande signale toutes les dix secondes qu’elle attend. À la fin figure le résultat : la sauvegarde et la destination, les racines, le nombre d’entrées écrites, les fichiers hors de la sauvegarde, la base de données avec tables et lignes, la durée du basculement, la voie de la confirmation et la réponse de la page d’accueil. La dernière ligne indique le nombre d’avertissements et le moment jusqu’auquel l’ancien état est conservé.

Après une restauration de la base de données, ta session dans l’administration de WordPress peut être invalide. Reconnecte-toi alors.

Tant que le retour en arrière d’une restauration est ouvert, aucune nouvelle restauration ne démarre. Conserve d’abord la restauration ouverte ou annule-la.

Afficher l’état d’une restauration : status

restore status affiche la restauration en cours. S’il n’y en a aucune, la commande affiche la restauration dont le retour en arrière est ouvert. Avec le nom de tâche d’une restauration, elle affiche précisément celle-ci. L’action n’a pas de paramètres.

# Afficher la restauration en cours ou le retour en arrière ouvert
wp cloneworx-backup restore status

Pour une restauration en cours, la sortie indique la phase et la progression. Pour une restauration terminée, elle indique le statut, le retour en arrière avec son délai et le résultat comme après restore run.

Conserver ou annuler la restauration : keep, undo

Action	Objectif
restore keep	Conserve la restauration : l’extension supprime l’ancien état, les anciens dossiers et les anciennes tables. Ensuite, il n’y a plus de retour en arrière.
restore undo	Annule la restauration : l’extension ramène l’ancien état. Les téléversements remplacés sur place restent tels que la restauration les a écrits.

Sans nom de tâche, les deux actions prennent la restauration dont le retour en arrière est ouvert. Avec --background, la commande ne fait que lancer, et le site poursuit la tâche lui-même.

# Conserver la restauration
wp cloneworx-backup restore keep

# Annuler la restauration
wp cloneworx-backup restore undo

La sortie indique combien d’entrées ont été supprimées et combien de tables ont été supprimées ou remises en place. Si tu ne décides rien, l’extension conserve la restauration d’elle-même après 7 jours. Pour en savoir plus : Conserver ou annuler une restauration.

Si l’administration de WordPress est inaccessible

Pour une restauration depuis la ligne de commande, tu n’as besoin ni de te connecter à l’administration de WordPress ni d’un navigateur. Tu as besoin de l’accès au serveur et de WP-CLI. Les commandes existent tant que WP-CLI peut charger WordPress avec l’extension.

1. Cherche la sauvegarde : wp cloneworx-backup backup list.
2. Exécute la vérification préalable et lis la ligne loopback. Avec OK, l’auto-requête arrive. Avec WARN, elle n’arrive pas : la restauration ne fonctionne alors qu’avec --without-confirmation. Avec UNKNOWN, l’extension n’a pas encore testé l’auto-requête sur ce serveur.
3. Lance la restauration avec restore run. Si l’auto-requête arrive, la restauration se déroule comme décrit ci-dessus.
4. Si la restauration s’interrompt parce que l’auto-requête n’arrive pas, le site continue de fonctionner dans son état précédent. Relance alors la restauration, avec --without-confirmation.
5. Vérifie le site. Si quelque chose ne va pas, restore undo ramène l’ancien état.

# Étape 1 : chercher la sauvegarde
wp cloneworx-backup backup list

# Étape 2 : la vérification préalable
wp cloneworx-backup restore precheck <Job>

# Étape 3 : la restauration
wp cloneworx-backup restore run <Job>

# Étape 4 : basculer dans ce processus
wp cloneworx-backup restore run <Job> --without-confirmation

# Étape 5 : si nécessaire, ramener l’état précédent
wp cloneworx-backup restore undo

Importer une sauvegarde depuis un fichier : import

import accepte un fichier de sauvegarde qui se trouve sur ce serveur : le fichier tar issu du téléchargement d’une sauvegarde. L’extension lit le fichier par parties, vérifie chaque partie de la sauvegarde par rapport à sa somme de contrôle et stocke la sauvegarde sur la destination que tu indiques. Ensuite, la sauvegarde figure dans la liste, sous le nom de tâche de la sauvegarde d’origine. Comme date, backup list indique le moment de l’import.

Indication	Signification	Valeurs autorisées
<Datei>	Le fichier de sauvegarde. Obligatoire. L’indication figure directement après import.	Chemin d’un fichier tar sur ce serveur
--target	La destination sur laquelle la sauvegarde est stockée. Obligatoire.	Identifiant d’une destination utilisable
--background	La commande lit le fichier et ne fait que lancer l’import. Le site poursuit la tâche lui-même.	sans valeur
--max-per-step	Termine chaque étape de la vérification après ce nombre de parties. Ce paramètre sert au diagnostic.	nombre entier
--force	S’exécute aussi en tant qu’un autre utilisateur.	sans valeur

# Importer un fichier de sauvegarde vers la destination local-1
wp cloneworx-backup import /tmp/backup.tar --target=local-1

La commande indique d’abord la taille lue et le nom de tâche de la sauvegarde contenue dans le fichier, puis la progression de l’import. À la fin figure quand et sur quel site la sauvegarde a été créée, sur quelle destination elle se trouve maintenant, combien de parties ont été vérifiées et quelles racines elle contient.

La commande se termine par une erreur

• si le fichier n’est pas un fichier de sauvegarde de cette extension ou s’il est incomplet,
• si une partie ne correspond pas à sa somme de contrôle : rien n’est alors stocké,
• si la même sauvegarde se trouve déjà sur cette destination,
• s’il existe dans la liste une autre sauvegarde portant le même nom,
• si l’espace pour le fichier manque dans le dossier de travail,
• si le fichier dépasse 32 GiB.

Si la même sauvegarde ne se trouvait jusqu’ici que sur une autre destination, son entrée dans la liste reçoit la nouvelle destination en plus.

Voir aussi

• Restaurer le site à partir d’une sauvegarde
• Restaurer une sauvegarde sur un autre site
• Restaurer les uploads quand l’espace ne suffit pas
• Importer une sauvegarde depuis un fichier
• Créer et gérer les sauvegardes avec WP-CLI