Planning en systeem-cron met WP-CLI – cloneworx Hulp

Met wp cloneworx-backup scheduler zie je wanneer je back-upplannen lopen, en stoot je het schema aan vanaf de opdrachtregel. Hetzelfde commando is de regel voor een systeemcron: daarmee starten je back-ups op tijd, ook als niemand de website bezoekt.

Ontbreekt WP-CLI nog? De handleiding staat in WP-CLI installeren. Alle commando’s van de plugin noemt De opdrachten in één oogopslag.

Zo werkt het schema

Een actief back-upplan loopt op zijn volgende tijdstip. Daarvoor controleert de plugin bij elke taakbron of een plan aan de beurt is. Deze controle heet tik. Taakbronnen zijn:

de eigen tik van de plugin in WP-Cron, elke 15 minuten,
een wekgebeurtenis in WP-Cron, die precies op het volgende tijdstip ligt,
de geopende pagina Overzicht of Back-up, elke 60 seconden,
het einde van elke taak,
de opdrachtregel met scheduler tick.

WP-Cron draait alleen als iemand de website bezoekt. Komt er binnen een uur na het tijdstip een taakbron, dan loopt het plan. Daarna geldt het tijdstip als gemist: er start niets, het plan noteert het tijdstip, schrijft een waarschuwing in het algemene logboek en schuift door naar zijn volgende reguliere tijdstip. Een website die rond haar tijdstippen noch bezoekers noch een systeemcron heeft, maakt daarom geen back-ups.

Er loopt altijd maar één taak tegelijk. Zijn meerdere plannen aan de beurt, dan lopen ze na elkaar. Een tijdstip dat in een lopende taak valt, geldt als gehaald: het plan start direct na die taak.

Het schema tonen: status

scheduler status toont de stand van het schema. De actie wijzigt niets en heeft geen parameters. Zonder actie doet wp cloneworx-backup scheduler hetzelfde.

# De stand van het schema tonen
wp cloneworx-backup scheduler status

De uitvoer is Engels en noemt van boven naar beneden:

Regel	Betekenis
`Now`	De tijd van de website en de respijttijd: 60 minuten. Komt een taakbron later, dan geldt het tijdstip als gemist.
per actief plan een regel	Kenmerk en naam van het plan, de volgende run en de laatste run met zijn aanleiding. `DUE NOW` betekent: het plan is nu aan de beurt. `missed` noemt een gemist tijdstip. `could not start` betekent: het plan kon op zijn laatste tijdstip niet starten; de reden staat tussen haakjes.
`Wake event`	Het tijdstip van de wekgebeurtenis, of `none`.
`Last tick`	De laatste tik met zijn taakbron tussen haakjes, of `never`.
`Last start on schedule`	De laatste start volgens schema: plan, back-up, tijdstip, vertraging en taakbron.
`Active job`	De taak die nu loopt. De regel ontbreekt als er geen loopt.

Is er geen actief plan, dan staat daar no active plan. De taakbronnen heten in de uitvoer zo:

In de uitvoer	Taakbron
`cron`	de tik van de plugin in WP-Cron
`wake`	de wekgebeurtenis
`rest`	de geopende pagina van de plugin in de browser
`cli`	de opdrachtregel
`job_end`	het einde van een taak

Een tik uitvoeren: tick

scheduler tick voert een tik uit. Wat er dan gebeurt, hangt van de situatie af:

Situatie	Wat het commando doet
Geen plan is aan de beurt.	Het noemt het plan met het volgende tijdstip en eindigt. Is geen plan actief, dan zegt het dat.
Een plan is aan de beurt.	Het start de back-up van het plan met het vroegste tijdstip en voert die in dit proces tot het einde uit. Daarna volgen het nawerk en het volgende plan dat aan de beurt is.
Er loopt al een taak.	Het noemt de taak en voert die in dit proces tot het einde uit. Een plan dat aan de beurt is, volgt daarna.
Een tijdstip is gemist.	Het waarschuwt en noemt de plannen. Voor dit tijdstip start niets.
Een plan dat aan de beurt is, kan niet starten.	Het waarschuwt en noemt de reden. Het tijdstip geldt als afgehandeld; het volgende is gepland.

Parameter	Betekenis	Toegestane waarden
`--background`	Het commando start het plan dat aan de beurt is alleen. De website voert de back-up zelf verder uit.	zonder waarde
`--force`	Loopt ook als een andere gebruiker dan de gebruiker aan wie de mappen van de plugin toebehoren.	zonder waarde

# Een tik uitvoeren en een back-up die aan de beurt is hier uitvoeren
wp cloneworx-backup scheduler tick

# Een tik uitvoeren en de back-up aan de website overlaten
wp cloneworx-backup scheduler tick --background

Start een back-up, dan noemt het commando het plan, het tijdstip, de vertraging en de taaknaam van de back-up. Daarna volgt de uitvoer zoals bij een handmatige back-up: per stap een regel, aan het einde het resultaat. Die beschrijft Back-ups maken en beheren met WP-CLI.

Elke tik controleert bovendien of een back-up achterstallig is, hoogstens elke 15 minuten.

De regel voor de systeemcron

Een systeemcron is het schema van de server. Hij roept de tik elke vijf minuten aan, onafhankelijk van bezoekers:

# Elke vijf minuten een tik uitvoeren
*/5 * * * * cd /pfad/zu/wordpress && wp cloneworx-backup scheduler tick --quiet

De kant-en-klare regel voor jouw installatie, met het pad naar jouw WordPress, staat op de pagina Instellingen in de tegel Planner. De tegel verschijnt in de weergave Uitgebreid.
De tegel toont twee regels. De eerste roept WP-CLI aan zoals hierboven. De tweede roept wp-cron.php aan via het adres van de website. Kopiëren kopieert de eerste regel.
Voer de regel in bij de cron van de gebruiker aan wie de mappen van de plugin toebehoren. Draait de cron als andere gebruiker, dan eindigt het commando met een fout en start het niets.
--quiet is een parameter van WP-CLI, niet van de plugin.

Hoe je de regel bij jouw hoster invoert, toont Back-ups op tijd starten: een systeem-cron instellen.

Controleren of de systeemcron draait

Wacht na het invoeren vijf minuten. Dan toont scheduler status in de regel Last tick een tijdstip uit de laatste minuten. Staat cli tussen haakjes, dan kwam deze tik van de opdrachtregel.

In dit proces of op de achtergrond

Aanroep	Wie de back-up uitvoert
`scheduler tick`	Het commando zelf, in zijn proces, tot het einde. De instelling Pauze tussen stappen geldt daarbij niet. Het commando eindigt pas als de back-up, het nawerk en elk verder plan dat aan de beurt is, klaar zijn.
`scheduler tick --background`	De website. Het commando start de back-up, stuurt de eerste zelfaanroep en eindigt meteen. Daarna voert de taak zichzelf via de webserver verder uit; WP-Cron is het vangnet daaronder.

Kan de zelfaanroep niet worden verzonden, dan waarschuwt het commando. WP-Cron zet de taak dan voort. De voortgang van een taak op de achtergrond toont wp cloneworx-backup job status.

Zie ook