Los comandos de un vistazo – cloneworx Ayuda

Los destinos, los planes de copia, las copias de seguridad, la restauración y los ajustes de cloneworx Backup también los controlas en la línea de comandos, sin navegador. Aquí están todos los comandos del plugin con sus acciones y las reglas que rigen para cada comando.

¿Aún no tienes WP-CLI configurado en tu servidor? Entonces empieza por Instalar WP-CLI.

Cómo se construye un comando

Cada comando empieza por «wp cloneworx-backup». Después siguen el comando, la acción, si hace falta un nombre, y los parámetros. Un parámetro empieza por dos guiones.

# Comando target, acción test, destino local-1
wp cloneworx-backup target test local-1

# Comando plan, acción run, plan plan-1, parámetro --background
wp cloneworx-backup plan run plan-1 --background

Ejecutas los comandos en la carpeta de tu sitio web, es decir, donde está WordPress.
Si omites la acción, rige la acción predeterminada del comando. wp cloneworx-backup target es lo mismo que wp cloneworx-backup target list.
Las salidas están en inglés y no se traducen.
La ayuda de WP-CLI indica para cada comando las acciones y los parámetros, por ejemplo wp help cloneworx-backup target.

Todos los comandos

La acción en negrita es la predeterminada y rige si no indicas ninguna acción.

Comando	Acciones	Para qué	Más al respecto
`target`	list, add, edit, remove, test, check, cleanup, moved, copy, sites, adopt, rebuild	Mostrar, crear, cambiar, quitar y probar destinos. Comprobar las copias de seguridad de un destino, limpiar restos, responder a un conflicto de huella, recuperar copias de seguridad tras una pérdida total.	Gestionar destinos con WP-CLI
`plan`	list, add, edit, pause, resume, remove, run	Mostrar, crear, cambiar, pausar, activar, eliminar y ejecutar de inmediato planes de copia.	Gestionar planes de copia de seguridad con WP-CLI
`backup`	run, list, lock, unlock, check, download, delete	Crear una copia de seguridad sin plan. Mostrar, bloquear, comprobar, escribir como archivo y borrar copias de seguridad.	Crear y gestionar copias de seguridad con WP-CLI
`retention`	list, run	Mostrar qué copias antiguas se eliminarían según Máx. copias, o borrarlas ahora.	Crear y gestionar copias de seguridad con WP-CLI
`restore`	precheck, run, status, keep, undo	Ejecutar la comprobación previa, iniciar una restauración, mostrar su estado, conservarla o deshacerla.	Restaurar e importar con WP-CLI
`import`	ninguna; el comando toma la ruta de un archivo y el parámetro `--target`	Guardar un archivo de copia de seguridad en un destino de este sitio web y añadirlo a la lista de copias.	Restaurar e importar con WP-CLI
`scheduler`	status, tick	Mostrar la programación. Con tick, comprobar si un plan está pendiente e iniciarlo: esa es la línea para el cron del sistema.	Programación y cron del sistema con WP-CLI
`settings`	list, get, set, reset	Mostrar, leer, establecer y restablecer a los valores predeterminados los ajustes del sitio web.	Ajustes y alcance con WP-CLI
`scope`	roots, tables, exclusions, all	Mostrar qué pertenece al sitio web. Establecer las reglas de exclusión y las tablas de las que solo se guarda la estructura.	Ajustes y alcance con WP-CLI
`status`	ninguna	Mostrar el estado del sitio web: el mismo resultado que el panel de estado de la página Resumen.	Estado, registros y soporte con WP-CLI
`logs`	ninguna	Listar los archivos de registro o escribirlos todos en un archivo tar.	Estado, registros y soporte con WP-CLI
`support`	ninguna	Mostrar el informe de soporte o escribirlo en un archivo.	Estado, registros y soporte con WP-CLI
`debug`	on, off, status	Activar y desactivar la depuración en el registro. Pasadas 24 horas se desactiva sola.	Estado, registros y soporte con WP-CLI
`notify`	status, check, test	Mostrar el estado de las notificaciones, comprobar ahora si hay copias de seguridad atrasadas, enviar un correo de prueba.	Estado, registros y soporte con WP-CLI
`news`	status, subscribe, unsubscribe	Mostrar, iniciar o terminar la suscripción a las novedades de cloneworx Backup.	Estado, registros y soporte con WP-CLI
`job`	run, status, abort, probe, filelist, dbexport, files	Llevar hasta el final el trabajo en curso, mostrar su estado o cancelarlo. Iniciar la ejecución de prueba y los trabajos de diagnóstico.	Estado, registros y soporte con WP-CLI

Nombrar destino, plan y copia de seguridad

Qué	Así lo nombras	Dónde lo encuentras
Destino	Tras la acción, con su identificador (`local-1`, `sftp-1`) o su nombre. En los parámetros `--targets` y `--target` va el identificador.	`wp cloneworx-backup target list`
Plan	Tras la acción, con su identificador (`plan-1`) o su nombre. En el parámetro `--plan` va el identificador.	`wp cloneworx-backup plan list`
Copia de seguridad	Con su nombre de trabajo: fecha, hora y un identificador de 32 caracteres.	`wp cloneworx-backup backup list`

En el nombre de un destino no importan las mayúsculas y minúsculas. En el nombre de un plan esto vale para las letras de la a a la z; los caracteres especiales los escribes tal como aparecen en el nombre. Un nombre con espacios lo pones entre comillas: wp cloneworx-backup plan run "Copia diaria".

Con qué usuario trabajas

WP-CLI se ejecuta a menudo como un usuario distinto del sitio web. El sitio web no podría cambiar ni borrar más adelante los archivos y carpetas que un comando crea entonces. Por eso, casi todos los comandos que cambian algo o inician un trabajo comprueban primero si estás trabajando como el usuario al que pertenecen las carpetas del plugin. Si no, se interrumpen y nombran ambos usuarios. En el ejemplo de abajo, web y vuser son el usuario y el grupo del sitio web; pon los de tu sitio web.

# Ejecutar como usuario del sitio web (ejemplo: web y vuser)
sudo -u web -g vuser -H wp cloneworx-backup backup run

Las acciones list y status no comprueban el usuario: las listas y los estados los muestras con cualquier usuario. settings tampoco lo comprueba al establecer valores, porque el comando solo escribe en la base de datos.
También se ejecutan sin comprobación backup lock, backup unlock, backup download, job run, job abort, logs y support.
Con --force, un comando se ejecuta de todos modos y solo advierte. El riesgo se mantiene: lo que crea pertenece al usuario equivocado.
restore run, restore keep y restore undo no conocen --force. Una restauración escribe en el propio sitio web.

En este proceso o en segundo plano

La copia de seguridad, la comprobación, la limpieza, la restauración y la importación se ejecutan como trabajo en muchos pasos cortos. Sin más parámetros, el comando lleva el trabajo por sí mismo hasta el final. Muestra por cada paso una línea con el progreso y al final el resultado. La pausa entre pasos de los ajustes la omite.

Una excepción es la restauración: el cambio al estado restaurado lo cede el comando al servidor web y espera hasta que esté hecho. Más al respecto: Restaurar e importar con WP-CLI.

Con --background, el comando solo inicia el trabajo. El sitio web lo continúa entonces por sí mismo: mediante la autollamada del servidor, con WP-Cron como red de seguridad. El estado lo muestra wp cloneworx-backup job status.

Comando	Acciones con `--background`
`target`	check, cleanup, adopt, rebuild
`plan`	run
`backup`	run, check
`restore`	run, keep, undo
`import`	el propio comando
`scheduler`	tick
`job`	probe, filelist, dbexport, files

Un trabajo por sitio web

Solo se ejecuta un trabajo a la vez. Si ya hay uno en marcha, el comando rechaza el inicio y nombra el trabajo en curso: Another job is active: …. One job per site.

Contraseñas y claves

La línea de comandos nunca acepta contraseñas ni claves. Cualquier valor aparecería allí en la lista de procesos y en el historial de la shell. Por eso, los destinos con credenciales los configuras en la página Destinos. Después puedes probarlos, comprobarlos y usarlos en un plan también en la línea de comandos.

El parámetro --path

--path es un parámetro de WP-CLI, no del plugin: indica la ruta a WordPress cuando no estás en la carpeta del sitio web. La carpeta de un destino local la estableces con --set-path.

# La ruta a WordPress: una opción de WP-CLI
wp cloneworx-backup status --path=/pfad/zur/website

# La carpeta de un destino local: un ajuste del destino
wp cloneworx-backup target add local --set-path=/var/backups

La misma ruta que el servidor web

Ejecuta WP-CLI con la ruta por la que también el servidor web accede al sitio web. La huella de la instalación contiene la ruta en el servidor. Por otra ruta, por ejemplo un enlace simbólico, la misma instalación parece una copia: el plugin anota un conflicto de huella y no escribe ni borra nada en ese destino.

Consulta también