Con el comando plan gestionas tus planes de copia en la línea de comandos: mostrar, crear, cambiar, pausar, activar, ejecutar de inmediato y eliminar.
¿Aún no tienes WP-CLI configurado? Entonces empieza por Instalar WP-CLI. Lo que rige para cada comando, por ejemplo el usuario y el parámetro --force, está en Los comandos de un vistazo.
Un plan de copia reúne cuándo se ejecuta una copia de seguridad, qué contiene, adónde va y cuántas copias se conservan por destino. Un plan lo nombras con su identificador, por ejemplo plan-1, o con su nombre. En las letras de la a a la z no importan las mayúsculas y minúsculas del nombre; los caracteres especiales los escribes tal como aparecen en el nombre. Un nombre con espacios va entre comillas.
Todas las acciones excepto list comprueban si estás trabajando como el usuario al que pertenecen las carpetas del plugin. --force omite esa comprobación.
Mostrar planes: list
# Mostrar todos los planes con estado, ritmo y próxima ejecución wp cloneworx-backup plan list
La salida muestra dos líneas por plan. La primera lleva el identificador, el estado, el nombre, el ritmo con la hora de inicio y los identificadores de los destinos. La segunda indica la próxima ejecución, la última ejecución, el contenido, Máx. copias y la instantánea. La última línea cuenta los planes e indica cuántos puede haber como máximo.
| En la salida | Significado |
|---|---|
active |
El plan está activo y se ejecuta por sí solo en su próxima ejecución. |
paused |
El plan está en pausa. No hay copias programadas. |
paused (no target) |
El plan está en pausa porque ya no tiene destino. Elige un destino y podrá activarse. |
next run |
La próxima ejecución en la zona horaria del sitio web. En un plan en pausa aparece aquí un guion. |
last run |
La última ejecución con su desencadenante: schedule (programación), manual (en las páginas del plugin) o cli (línea de comandos). missed indica una ejecución perdida después. could not start significa: la última ejecución programada no pudo iniciarse. |
roots |
Qué respalda el plan, como lista de áreas. |
retention |
Máx. copias |
snapshot |
Respaldar la base de datos como instantánea: yes o no
|
Crear un plan: add
# Respaldar a diario a las 03:15 en el destino sftp-1 wp cloneworx-backup plan add --targets=sftp-1 --rhythm=daily --time=03:15 --name="Nachts" # Los domingos a las 22:00 base de datos y subidas, conservar 3 copias wp cloneworx-backup plan add --targets=local-1 --rhythm=weekly --weekday=7 --time=22:00 --roots=db,wp-uploads --retention=3 # Activar el nuevo plan wp cloneworx-backup plan resume "Nachts"
Solo es obligatorio --targets. Todo lo demás tiene un valor predeterminado.
| Parámetro | Significado | Valores permitidos |
|---|---|---|
--targets=<identificador> |
El destino del plan, en el formulario Las copias van a. Obligatorio. | El identificador de un destino utilizable, no su nombre. La versión gratuita permite un destino por plan. |
--name=<nombre> |
El nombre del plan. Sin el parámetro, el plugin asigna su propuesta. | Como máximo 100 caracteres. Vale cualquier nombre que no tenga ya otro plan. |
--rhythm=<Rhythmus> |
Ritmo |
1h, 2h, 4h, 6h, 12h, daily, weekly, monthly. Predeterminado: daily. |
--time=HH:MM |
Hora en la zona horaria del sitio web. | Hora de 0 a 23, minutos 00, 15, 30 o 45. Predeterminado: una hora aleatoria. |
--weekday=<Zahl> |
Día de la semana, con el ritmo weekly. |
De 1 para lunes a 7 para domingo. Predeterminado: 1. |
--monthday=<Tag> |
Día del mes, con el ritmo monthly. |
De 1 a 28, o last para el último día del mes. Predeterminado: 1. |
--roots=<Liste> |
Qué se respalda: las áreas, separadas por comas. | Consulta la tabla de las áreas. Predeterminado: todas. |
--retention=<Zahl> |
Máx. copias: cuántas copias buenas se conservan por destino. | De 1 a 99. Predeterminado: 7. |
--snapshot=<Wert> |
Respaldar la base de datos como instantánea |
yes o no. Predeterminado: yes. |
--force |
Omite la comprobación del usuario. |
-
Un plan nuevo está en pausa. Solo se ejecuta cuando lo activas con
resume. - La hora de inicio puede diferir de la hora indicada. Al crearlo, el plugin añade al azar de 0 a 14 minutos y conserva ese añadido. De 03:15 resulta, por ejemplo, 03:22. Así no todos los sitios web de un servidor empiezan en el mismo minuto.
-
En los ritmos de
1ha12hde la hora solo cuenta el minuto. Las ejecuciones se reparten desde las 0 horas con el intervalo del ritmo. - La versión gratuita permite dos planes. Si se alcanza el límite, el comando no crea ninguno más.
Las áreas para --roots
| Valor | En el formulario | Contenido |
|---|---|---|
db |
Base de datos | Las tablas de la base de datos que pertenecen a este sitio web. |
wp-config |
wp-config.php | El archivo wp-config.php. Una restauración nunca lo restaura. |
wp-content |
wp-content | Todo lo de wp-content que no pertenece a plugins, temas, plugins imprescindibles ni subidas. |
wp-core |
Núcleo de WordPress | Las carpetas wp-admin y wp-includes y los archivos que WordPress entrega en la carpeta raíz. |
wp-mu-plugins |
Plugins imprescindibles (mu-plugins) | La carpeta de los plugins imprescindibles. |
wp-plugins |
Plugins | La carpeta de los plugins. |
wp-themes |
Temas | La carpeta de los temas. |
wp-uploads |
Subidas (uploads) | La carpeta de las subidas. |
wp-root |
Carpeta raíz | Todo lo demás en la carpeta raíz del sitio web, por ejemplo .htaccess y robots.txt. |
Las reglas de exclusión y las tablas de las que solo se guarda la estructura rigen para todo el sitio web y, por tanto, para cada plan. Más al respecto: Definir qué se respalda.
Cambiar un plan: edit
# Cambiar la hora y desactivar la instantánea wp cloneworx-backup plan edit "Nachts" --time=04:30 --snapshot=no # Elegir otro destino wp cloneworx-backup plan edit plan-1 --targets=local-1
edit toma los mismos parámetros que add y necesita al menos uno de ellos. Solo se cambia lo que indicas. Si cambias el ritmo, el día o la hora, el plugin vuelve a calcular la próxima ejecución. El añadido aleatorio a la hora sigue siendo el mismo.
Pausar y activar: pause y resume
# Pausar el plan wp cloneworx-backup plan pause plan-1 # Activar el plan wp cloneworx-backup plan resume plan-1
resume indica en la salida la próxima ejecución. El plugin la calcula a partir de ahora: un plan que llevaba semanas en pausa no empieza en el momento en que lo activas. Un plan solo se puede activar con un destino utilizable, es decir, un destino cuya última prueba de conexión ha tenido éxito.
Un plan activo empieza por sí solo en su próxima ejecución en cuanto un planificador impulsa el sitio web. Si en la hora siguiente a la ejecución programada no llega ningún planificador, la ejecución cuenta como perdida: no se inicia nada y el plan pasa a su siguiente ejecución regular. Por eso, un sitio web sin visitantes necesita un cron del sistema: Programación y cron del sistema con WP-CLI.
Ejecutar un plan de inmediato: run
# Ejecutar el plan ahora y esperar el resultado wp cloneworx-backup plan run "Copia diaria" # Solo iniciar la copia de seguridad; el sitio web la continúa wp cloneworx-backup plan run plan-1 --background
run inicia de inmediato una copia de seguridad con el contenido y el destino del plan. Esto también funciona con un plan en pausa: solo está en pausa la programación. La copia cuenta para el plan y vale como su última ejecución. No desplaza la próxima ejecución programada.
| Parámetro | Significado |
|---|---|
--background |
El comando inicia la copia de seguridad y termina. El sitio web la continúa por sí mismo; el estado lo muestra wp cloneworx-backup job status. |
--force |
Omite la comprobación del usuario. |
Sin --background, el comando muestra por cada paso una línea con el progreso: la fase, el número de entradas, la cantidad y, en cuanto se puede estimar, el tiempo restante. Al final aparece el resultado con el número de pasos y de advertencias, debajo los detalles de base de datos, archivos y transferencia por destino. Tras una copia buena, el comando lleva también hasta el final el trabajo posterior: borra las copias que sobrepasan Máx. copias y limpia restos en los destinos.
Si la copia falla, la salida indica los últimos mensajes del trabajo, el estado por destino y el motivo. Si el plan no tiene un destino utilizable o ya hay otro trabajo en marcha, el comando no inicia nada y lo dice.
Eliminar un plan: remove
# Eliminar el plan; sus copias de seguridad se conservan wp cloneworx-backup plan remove "Nachts"
El comando no pregunta
A diferencia de la página Copia de seguridad, aquí no hay ninguna pregunta de seguridad: el plan se elimina de inmediato. Las copias que ha creado se conservan.
Si eliminas todos los planes, el plugin vuelve a crear un primer plan con el siguiente destino que añadas.
Si el comando rechaza un dato
Si un dato no es correcto, el comando no guarda nada. Nombra el campo con un código y termina con Plan settings are not valid.
| Campo | Código | Significado |
|---|---|---|
name |
required, taken, too_long
|
El nombre está vacío, ya pertenece a otro plan o tiene más de 100 caracteres. |
rhythm, weekday, monthday, snapshot
|
invalid |
El valor no está en la tabla de valores permitidos. |
roots |
required, invalid
|
La lista está vacía o nombra un área que no existe. |
targets |
required |
La lista está vacía. |
targets |
too_many |
El plan nombra más destinos de los permitidos. |
targets |
unknown |
El destino no existe o está quitado. |
targets |
not_usable |
El destino no es utilizable. Prueba primero su conexión. |
retention |
invalid, out_of_range
|
El valor no es un número entero o no está entre 1 y 99. |
state |
no_usable_target |
El plan no se puede activar porque no tiene ningún destino utilizable. |
Una hora con formato incorrecto la rechaza el comando de inmediato e indica el formato permitido. Si se ha alcanzado el número máximo de planes, informa del límite, por ejemplo At most 2 plans.