Restaurar e importar con WP-CLI

Con wp cloneworx-backup restore compruebas antes de una restauración si puede tener éxito, restauras una copia de seguridad y conservas la restauración o la deshaces. Con wp cloneworx-backup import incorporas a la lista una copia de seguridad desde un archivo.

¿Aún falta WP-CLI? Las instrucciones están en Instalar WP-CLI. Todos los comandos del plugin los nombra Los comandos de un vistazo.

Esto rige para todas las acciones

• Una copia de seguridad la nombras con su nombre de trabajo. Lo muestra wp cloneworx-backup backup list. En los ejemplos aparece como <Job>. Se puede restaurar una copia con el estado success o warnings.
• Por sitio web solo se ejecuta un trabajo a la vez. Si ya hay uno en marcha, cualquier comando que inicie un trabajo termina con un error y nombra el trabajo en curso.
• Las salidas están en inglés. El plazo para deshacer aparece allí en UTC.
• Todas las acciones excepto restore status comprueban primero el usuario: el comando debe ejecutarse como el usuario al que pertenecen las carpetas del plugin. En restore precheck e import, --force omite la comprobación. En restore run, keep y undo no existe --force: el sitio web no podría cambiar después los archivos de otro usuario.

Comprobar antes de la restauración: precheck

restore precheck ejecuta la comprobación previa: nueve puntos antes de que una restauración escriba algo. La comprobación previa no cambia nada en el sitio web. Para la prueba de los permisos crea carpetas y tablas y las vuelve a eliminar.

Parámetro	Significado	Valores permitidos
--target	El destino en el que el plugin lee la copia de seguridad. Sin el parámetro: el primer destino local en el que la copia está completa; si no, el primero de los demás.	Identificador de un destino
--roots	Qué se restaura. Sin el parámetro: cada raíz de la copia de seguridad. wp-config nunca se restaura.	Raíces, separadas por comas, por ejemplo db,wp-uploads
--include-core	Restaura el núcleo de WordPress también en otro sitio web.	sin valor
--include-dropins	Restaura object-cache.php, advanced-cache.php y db.php también en otro sitio web.	sin valor
--include-htaccess	Restaura .htaccess, web.config y .user.ini también en otro sitio web.	sin valor
--uploads-in-place	Elige para las subidas el camino sin vuelta atrás si el espacio junto a la carpeta activa no es suficiente.	sin valor
--force	Se ejecuta también como otro usuario.	sin valor

Los tres parámetros con --include solo tienen efecto si la copia de seguridad procede de otro sitio web o su origen es desconocido. En el mismo sitio web, el plugin restaura el núcleo, los drop-ins y .htaccess de forma predeterminada.

# Ejecutar la comprobación previa de una copia de seguridad
wp cloneworx-backup restore precheck <Job>

# Leer la copia de seguridad en un destino concreto, solo dos raíces
wp cloneworx-backup restore precheck <Job> --target=local-1 --roots=db,wp-uploads

La primera línea de la salida nombra la copia de seguridad, el destino en el que se ha leído, las raíces y el origen: el mismo sitio web, otro o desconocido. Después sigue una línea por punto con el estado y el hallazgo.

Estado	Significado
OK	El punto está en orden.
WARN	Algo que deberías saber. Tú decides. Una advertencia nunca bloquea la restauración.
FAIL	La restauración no puede iniciarse.
UNKNOWN	El punto no se pudo determinar.

Punto en la salida	En la interfaz
readable	Copia legible y completa
versions	Versión de PHP y MySQL
space	Espacio libre
permissions	Permisos de escritura en las carpetas de destino
packet	max_allowed_packet frente a la fila más grande
collations	Colaciones
fingerprint	Mismo sitio web
db_rights	Permisos de base de datos (prueba)
loopback	Autollamada posible

Debajo de los puntos se indica qué no se restaura y por qué. Por último, la salida lista las diferencias entre la copia de seguridad y este sitio web: por línea, el valor de la copia y el valor aquí. El riesgo de esas diferencias lo evalúas tú. Si un punto tiene el estado FAIL, el comando termina con un error. Cada punto lo explica La comprobación previa de la restauración: cada punto explicado.

Restaurar una copia de seguridad: run

restore run restaura las raíces elegidas. Ocurre así:

1. La comprobación previa se ejecuta como primera fase. Un FAIL termina el trabajo antes de que se escriba algo.
2. El plugin prepara los archivos junto a las carpetas activas e importa la base de datos en tablas junto a las activas. El sitio web sigue funcionando mientras tanto.
3. Las subidas y los archivos de la carpeta raíz los cambia el plugin archivo por archivo, sin modo de mantenimiento.
4. La base de datos, el núcleo, los plugins imprescindibles, los plugins, los temas y el resto de wp-content los cambia el plugin en el modo de mantenimiento de WordPress. Este paso se ejecuta en el servidor web: el comando lo cede mediante la autollamada y espera.
5. El nuevo sitio web se confirma a sí mismo. Si la confirmación no llega en 60 segundos, el mismo paso vuelve atrás y el sitio web vuelve a funcionar con el estado anterior.

Si la autollamada no llega al servidor web en 60 segundos, el comando cancela la restauración antes del cambio. El plugin revierte lo que se había cambiado hasta entonces y el sitio web sigue funcionando con su estado anterior. Solo las subidas sustituidas in situ con --uploads-in-place quedan sustituidas.

Nunca se restauran el propio plugin con sus carpetas y tablas ni wp-config.php. Los archivos de las subidas y de la carpeta raíz que no están en la copia de seguridad se quedan. Las tablas de este sitio web que no están en la copia se quedan; el resultado las nombra.

Parámetro	Significado	Valores permitidos
--target, --roots, --include-core, --include-dropins, --include-htaccess, --uploads-in-place	Como en restore precheck.	como arriba
--remove-extra-uploads	Mueve las subidas que no están en la copia de seguridad al estado anterior. Con restore undo esas subidas vuelven. De forma predeterminada se quedan.	sin valor
--accept-damaged	Restaura también una copia de seguridad con entradas dañadas y omite exactamente esas entradas. Sin el parámetro, la restauración termina antes de cambiar algo e indica el número de entradas dañadas.	sin valor
--without-confirmation	Hace el cambio en este proceso, sin la confirmación del nuevo sitio web. Para servidores en los que la autollamada no funciona.	sin valor
--background	El comando solo inicia la restauración. El sitio web la continúa por sí mismo.	sin valor

# Restaurar la copia de seguridad completa
wp cloneworx-backup restore run <Job>

# Restaurar solo la base de datos
wp cloneworx-backup restore run <Job> --roots=db

# Restaurar solo plugins y temas
wp cloneworx-backup restore run <Job> --roots=wp-plugins,wp-themes

El comando escribe una línea por paso con el progreso. Mientras el servidor web hace el cambio, el comando informa cada diez segundos de que está esperando. Al final aparece el resultado: la copia de seguridad y el destino, las raíces, el número de entradas escritas, los archivos fuera de la copia, la base de datos con tablas y filas, la duración del cambio, el camino de la confirmación y la respuesta de la página de inicio. La última línea indica el número de advertencias y el momento hasta el que se conserva el estado anterior.

Tras una restauración de la base de datos, tu inicio de sesión en el área de administración de WordPress puede quedar invalidado. Inicia sesión de nuevo en ese caso.

Mientras esté abierta la vuelta atrás de una restauración, no se inicia ninguna restauración nueva. Conserva primero la restauración abierta o deshazla.

Mostrar el estado de una restauración: status

restore status muestra la restauración en curso. Si no hay ninguna, el comando muestra la restauración cuya vuelta atrás está abierta. Con el nombre de trabajo de una restauración, muestra exactamente esa. La acción no tiene parámetros.

# Mostrar la restauración en curso o la vuelta atrás pendiente
wp cloneworx-backup restore status

En una restauración en curso, la salida indica la fase y el progreso. En una terminada, indica el estado, la vuelta atrás con su plazo y el resultado como tras restore run.

Conservar o deshacer la restauración: keep, undo

Acción	Finalidad
restore keep	Conserva la restauración: el plugin elimina el estado anterior, las carpetas anteriores y las tablas anteriores. Después ya no hay vuelta atrás.
restore undo	Deshace la restauración: el plugin devuelve el estado anterior. Las subidas que se sustituyeron in situ se quedan como las escribió la restauración.

Ambas acciones toman, sin nombre de trabajo, la restauración cuya vuelta atrás está abierta. Con --background, el comando solo inicia, y el sitio web continúa el trabajo por sí mismo.

# Conservar la restauración
wp cloneworx-backup restore keep

# Deshacer la restauración
wp cloneworx-backup restore undo

La salida indica cuántas entradas se han eliminado y cuántas tablas se han eliminado o devuelto. Si no decides nada, el plugin conserva la restauración por sí solo pasados 7 días. Más al respecto: Conservar o deshacer una restauración.

Si no se puede acceder al área de administración de WordPress

Para una restauración en la línea de comandos no necesitas iniciar sesión en el área de administración de WordPress ni un navegador. Necesitas el acceso al servidor y WP-CLI. Los comandos existen mientras WP-CLI pueda cargar WordPress con el plugin.

1. Busca la copia de seguridad: wp cloneworx-backup backup list.
2. Ejecuta la comprobación previa y lee la línea loopback. Con OK, la autollamada llega. Con WARN no llega: la restauración solo funciona entonces con --without-confirmation. Con UNKNOWN, el plugin aún no ha probado la autollamada en este servidor.
3. Inicia la restauración con restore run. Si la autollamada llega, la restauración se ejecuta como se describe arriba.
4. Si la restauración se cancela porque la autollamada no llega, el sitio web sigue funcionando con su estado anterior. Inicia entonces la restauración de nuevo, con --without-confirmation.
5. Comprueba el sitio web. Si algo no está bien, restore undo devuelve el estado anterior.

# Paso 1: buscar la copia de seguridad
wp cloneworx-backup backup list

# Paso 2: la comprobación previa
wp cloneworx-backup restore precheck <Job>

# Paso 3: la restauración
wp cloneworx-backup restore run <Job>

# Paso 4: cambiar en este proceso
wp cloneworx-backup restore run <Job> --without-confirmation

# Paso 5: si hace falta, recuperar el estado anterior
wp cloneworx-backup restore undo

Importar una copia de seguridad desde un archivo: import

import acepta un archivo de copia de seguridad que está en este servidor: el archivo tar de la descarga de una copia. El plugin lee el archivo por partes, comprueba cada parte de la copia con su suma de comprobación y guarda la copia en el destino que indiques. Después, la copia está en la lista, bajo el nombre de trabajo de la copia original. Como fecha, backup list indica el momento de la importación.

Dato	Significado	Valores permitidos
<Datei>	El archivo de copia de seguridad. Obligatorio. El dato va justo detrás de import.	Ruta de un archivo tar en este servidor
--target	El destino en el que se guarda la copia de seguridad. Obligatorio.	Identificador de un destino utilizable
--background	El comando lee el archivo y solo inicia la importación. El sitio web continúa el trabajo por sí mismo.	sin valor
--max-per-step	Termina cada paso de la comprobación tras ese número de partes. El parámetro sirve para el diagnóstico.	número entero
--force	Se ejecuta también como otro usuario.	sin valor

# Importar un archivo de copia de seguridad al destino local-1
wp cloneworx-backup import /tmp/backup.tar --target=local-1

El comando indica primero el tamaño leído y el nombre de trabajo de la copia de seguridad del archivo, después el progreso de la importación. Al final aparece cuándo y en qué sitio web se creó la copia, en qué destino está ahora, cuántas partes se han comprobado y qué raíces contiene.

El comando termina con un error

• si el archivo no es un archivo de copia de seguridad de este plugin o está incompleto,
• si una parte no coincide con su suma de comprobación: entonces no se guarda nada,
• si la misma copia ya está en este destino,
• si en la lista hay otra copia con el mismo nombre,
• si en la carpeta de trabajo falta espacio para el archivo,
• si el archivo tiene más de 32 GiB.

Si la misma copia hasta ahora solo está en otro destino, su entrada de la lista recibe el nuevo destino.

Consulta también

• Restaurar el sitio web desde una copia de seguridad
• Restaurar una copia de seguridad en otro sitio web
• Restaurar los uploads cuando no hay espacio suficiente
• Importar una copia de seguridad desde un archivo
• Crear y gestionar copias de seguridad con WP-CLI