Crear y gestionar copias de seguridad con WP-CLI

Con wp cloneworx-backup backup inicias una copia de seguridad sin plan y gestionas las copias de la lista: mostrar, bloquear, comprobar, descargar, borrar. wp cloneworx-backup retention muestra qué copias antiguas se eliminan y, si lo deseas, las borra de inmediato.

¿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: fecha, hora y un identificador de 32 caracteres. El nombre de trabajo lo muestra backup list. En los ejemplos aparece como <Job>.
• Un destino lo nombras en --targets con su identificador, por ejemplo local-1. Los identificadores los muestra wp cloneworx-backup target list.
• 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 de los comandos están en inglés.
• backup run, backup check, backup delete y retention run comprueban primero el usuario: el comando debe ejecutarse como el usuario al que pertenecen las carpetas del plugin. El sitio web no podría cambiar ni borrar más adelante los archivos que cree otro usuario. --force omite la comprobación.

Iniciar una copia de seguridad sin plan: run

backup run inicia de inmediato una copia de seguridad y la lleva en este proceso hasta el final. La copia no pertenece a ningún plan. Un plan de copia lo ejecutas con wp cloneworx-backup plan run; más al respecto en Gestionar planes de copia de seguridad con WP-CLI.

Parámetro	Significado	Valores permitidos
--roots	Qué se respalda. Sin el parámetro, el plugin lo respalda todo.	Raíces, separadas por comas: db, wp-config, wp-content, wp-core, wp-mu-plugins, wp-plugins, wp-themes, wp-uploads, wp-root
--targets	Adónde va la copia de seguridad. Sin el parámetro, va a todos los destinos utilizables.	Identificadores de destinos utilizables, separados por comas
--no-snapshot	Lee la base de datos sin instantánea. Lo predeterminado es la instantánea.	sin valor
--background	El comando solo inicia la copia de seguridad. El sitio web la continúa por sí mismo.	sin valor
--max-per-step	Termina cada paso tras ese número de entradas o filas. El parámetro sirve para el diagnóstico.	número entero
--force	Se ejecuta también como otro usuario.	sin valor

Una raíz es una parte con nombre del sitio web: la base de datos o una carpeta. Qué hay en cada raíz lo explica Ajustes y alcance con WP-CLI.

# Respaldar todo en cada destino utilizable
wp cloneworx-backup backup run

# Respaldar solo base de datos y subidas en un destino
wp cloneworx-backup backup run --roots=db,wp-uploads --targets=local-1

# Iniciar la copia de seguridad y dejarla al sitio web
wp cloneworx-backup backup run --background

Mientras la copia de seguridad se ejecuta, el comando escribe una línea por paso: la fase, las entradas y los bytes completados y el tiempo restante, en cuanto el plugin lo conoce. Al final indica el número de pasos y de advertencias. Debajo aparece el resumen: raíces, destinos, tamaño guardado, el espacio por ubicación, la base de datos, los archivos, las partes y por destino el resultado de la transferencia.

Tras una copia buena, el mismo proceso lleva el trabajo posterior: el plugin borra copias obsoletas y limpia en los destinos restos de trabajos cancelados.

Si la copia termina con un error, el comando indica los últimos mensajes del trabajo, el estado por destino y el motivo. Con un error en un destino, debajo aparece sin cambios el mensaje del destino, en la línea target:.

Con --background, el comando vuelve de inmediato. El progreso lo muestra entonces wp cloneworx-backup job status.

Listar las copias de seguridad: list

backup list muestra las copias de seguridad de la lista, la más reciente primero. Sin acción, wp cloneworx-backup backup hace lo mismo.

Parámetro	Significado	Valores permitidos
--limit	Cuántas copias de seguridad muestra la salida.	De 1 a 100, predeterminado 20

# Mostrar las últimas 20 copias de seguridad
wp cloneworx-backup backup list

# Mostrar solo las últimas 5
wp cloneworx-backup backup list --limit=5

Cada línea nombra una copia de seguridad: nombre de trabajo, estado, plan, final, tamaño y por destino el estado de la copia allí. Al final de la línea aparece locked si la copia está bloqueada. La última línea dice cuántas copias muestra la salida y cuántas hay.

Estado en la salida	En el filtro de estado de la página Copia de seguridad
running	En curso
success	Completa
warnings	Con advertencias
error	Fallida
aborted	Cancelada

En la columna del plan aparece el identificador del plan, por ejemplo plan-1. manual indica una copia de seguridad sin plan, import una copia importada y rediscovered una copia recuperada en un destino.

Bloquear una copia de seguridad y desbloquearla: lock, unlock

backup lock bloquea una copia de seguridad. Una copia bloqueada nunca se borra automáticamente y no cuenta para Máx. copias. Solo se puede borrar a mano después de backup unlock. Ninguna de las dos acciones tiene parámetros.

# Bloquear una copia de seguridad
wp cloneworx-backup backup lock <Job>

# Desbloquear la copia
wp cloneworx-backup backup unlock <Job>

El comando confirma el bloqueo o su fin en una frase. Más sobre el bloqueo: Proteger una copia de seguridad contra el borrado.

Comprobar una copia de seguridad: check

backup check lee una copia de seguridad en cada destino en el que está completa o marcada como dañada: una nueva comprobación puede cambiar el resultado. No se restaura nada. El plugin comprueba si cada archivo está con su tamaño, si el archivo de información es válido, si cada parte coincide con su suma de comprobación y si cada bloque se puede leer. Una carpeta local la lee en el sitio. De un destino remoto obtiene una parte tras otra en la carpeta de trabajo.

Parámetro	Significado	Valores permitidos
--targets	Comprueba solo en estos destinos. Sin el parámetro: en cada destino en el que la copia está completa o marcada como dañada.	Identificadores, separados por comas
--background	El comando solo inicia la comprobación. El sitio web continúa el trabajo por sí mismo.	sin valor
--max-per-step	Termina cada paso tras ese número de bloques. El parámetro sirve para el diagnóstico.	número entero
--force	Se ejecuta también como otro usuario.	sin valor

# Comprobar una copia de seguridad en todos sus destinos
wp cloneworx-backup backup check <Job>

# Comprobar solo en un destino
wp cloneworx-backup backup check <Job> --targets=local-1

La salida tiene una línea por destino con el resultado:

Resultado	Significado
ok	La copia de seguridad es legible y completa allí. La línea indica partes, entradas y bytes leídos.
damaged or incomplete	La copia de seguridad está dañada o incompleta allí. La línea indica los hallazgos.
not checked	El destino no ha respondido. Es una advertencia, no un daño.
not complete at this target	La copia de seguridad no está completa en este destino.

La última línea suma el total. Si un destino no supera la comprobación, la copia cuenta allí como dañada: ya no se cuenta para Máx. copias y nunca se borra automáticamente. Más al respecto: Comprobar una copia de seguridad.

Escribir una copia de seguridad como archivo: download

backup download escribe una copia de seguridad como un archivo tar en el servidor. El archivo contiene una carpeta con el nombre de trabajo y, dentro, el archivo de información, el índice y las partes. El plugin lee en el primer destino local en el que la copia está completa.

Parámetro	Significado	Valores permitidos
--to	El archivo que escribe el comando. Obligatorio. El archivo no debe existir todavía y su carpeta debe permitir escritura.	Ruta de un archivo

# Escribir la copia de seguridad como archivo tar
wp cloneworx-backup backup download <Job> --to=/tmp/backup.tar

El comando indica el archivo, su tamaño, el número de archivos que contiene y el destino en el que ha leído. Si la copia de seguridad no está completa en ningún destino local, termina con un error. Una copia que solo está en destinos remotos la recoges de allí con un programa propio, por ejemplo con tu programa FTP. Más al respecto: Descargar una copia de seguridad.

El mismo archivo lo vuelve a aceptar wp cloneworx-backup import; consulta Restaurar e importar con WP-CLI.

Borrar una copia de seguridad: delete

backup delete borra una copia de seguridad en cada destino en el que está. Con su última copia, la copia de seguridad desaparece de la lista. Antes de borrar, el comando pregunta.

Parámetro	Significado	Valores permitidos
--targets	Borra solo en estos destinos. Las copias de los demás destinos se conservan. Mientras quede una copia, la copia de seguridad permanece en la lista.	Identificadores, separados por comas
--yes	Borra sin pregunta de seguridad.	sin valor
--force	Se ejecuta también como otro usuario.	sin valor

# Borrar una copia de seguridad en todas partes, con confirmación
wp cloneworx-backup backup delete <Job>

# Borrar solo la copia de un destino, sin pregunta de confirmación
wp cloneworx-backup backup delete <Job> --targets=local-1 --yes

• Una copia bloqueada la rechaza el comando. Desbloquéala primero.
• Una copia en curso la rechaza el comando. Cancélala primero: wp cloneworx-backup job abort.
• Una entrada sin copia, por ejemplo una copia de seguridad fallida o cancelada, desaparece de inmediato de la lista, sin pregunta de seguridad y sin trabajo.

El borrado se ejecuta como trabajo en este proceso. Al final, el comando indica cuántas copias se han borrado y cuántos intentos han fallado. Más al respecto: Eliminar una copia de seguridad.

Mostrar y borrar copias obsoletas: retention

El plugin conserva por plan de copia y por destino tantas copias buenas como indique Máx. copias en el plan. Las más antiguas se eliminan. Las copias bloqueadas no cuentan y nunca se eliminan automáticamente. La copia buena más reciente nunca se elimina. Esto ocurre por sí solo después de cada copia buena. Con wp cloneworx-backup retention lo ves de antemano o lo inicias a mano.

Acción	Finalidad
retention list	Muestra qué copias se eliminarían ahora. No borra nada. Sin acción, el comando hace lo mismo.
retention run	Borra esas copias ahora y lleva el trabajo en este proceso.

Parámetro	Significado	Valores permitidos
--plan	Solo este grupo. Sin el parámetro: cada plan y las copias sin plan.	Identificador de un plan, por ejemplo plan-1, o manual
--force	Solo run: se ejecuta también como otro usuario.	sin valor

# Mostrar lo que se borraría
wp cloneworx-backup retention list

# Borrar ahora, solo para un plan
wp cloneworx-backup retention run --plan=plan-1

# Borrar ahora, solo copias de seguridad sin plan
wp cloneworx-backup retention run --plan=manual

retention list nombra por línea una copia de seguridad, el destino y el grupo: el nombre del plan o manual. La última línea cuenta los borrados. Si no se elimina nada, el comando lo dice en una frase. retention run indica al final cuántas copias se han borrado.

Consulta también

• La página «Copia de seguridad»
• Crear una copia de seguridad ahora mismo
• Definir cuántas copias de seguridad se conservan
• Gestionar planes de copia de seguridad con WP-CLI
• Estado, registros y soporte con WP-CLI