Geplante Aufgaben
Free & PremiumDie Seite Geplante Aufgaben ist eine Oberfläche für cron auf deinem Mac: Du lässt beliebige Befehle nach Zeitplan laufen, ohne ein Terminal offen zu halten oder deine crontab zu bearbeiten. Typische Fälle sind php artisan schedule:run, ein Queue-Worker, ein npm run build oder ein regelmäßiger Datenbank-Export. Jede Aufgabe zeigt ihr letztes Ergebnis und ihre Ausgabe.
Was du hier machst
- Eine Aufgabe anlegen, bearbeiten und löschen.
- Den Zeitplan festlegen mit Cron-Ausdruck oder Vorlage.
- Aufgaben ausführen und Ergebnisse lesen.
- Ohne geöffnete App ausführen: das Timing an macOS übergeben, damit Aufgaben auch bei geschlossener App laufen.
Aufbau der Seite
| Bereich | Inhalt |
|---|---|
| Kopf | Neue Aufgabe, in Free daneben der Zähler „x / 3 kostenlos“. |
| Hinweis Auch ohne geöffnete App ausführen | Zustand der Zeitplanung durch macOS, mit Einrichten und Einstellungen. |
| Aufgaben | Eine Karte je Aufgabe mit Name, Zeitplan, letztem Ergebnis, Befehl und letzter Ausgabe. |
Gibt es noch keine Aufgabe, steht dort „Noch keine geplanten Aufgaben. Erstelle eine, um einen Befehl nach Zeitplan auszuführen.“ mit Neue Aufgabe.
Auf der Kommandozeile verwaltest du dieselben Aufgaben mit wd cron: list, run, enable, disable, add, edit und delete. Mehr dazu unter Aufgaben, Backups und Logs.
Aufgaben auf deinen Servern haben eine eigene Seite: Remote › Cronjobs.
Free und Premium
In Free legst du bis zu drei Aufgaben an, mit vollem Funktionsumfang. Der Zähler „x / 3 kostenlos“ steht oben. Premium hebt das Limit auf.
Das Limit verhindert das Anlegen einer vierten Aufgabe. Versuchst du es, erscheint Kostenloses Limit erreicht. Fällst du später von Premium auf Free zurück, wird nichts gelöscht: Die drei ältesten Aufgaben laufen weiter, alle weiteren sind gesperrt, bis Premium wieder aktiv ist. Gesperrte Aufgaben laufen nicht, Jetzt ausführen und Pausieren sind aus, und beim Bearbeiten lässt sich nur der Name ändern. Löschen geht weiterhin.
Die Zeitplanung ohne geöffnete App ist in Free enthalten.
Aufgabe anlegen Free & Premium
Mit Neue Aufgabe legst du einen Befehl mit Zeitplan an. Der Befehl läuft mit deinen Rechten über die Shell, in einem Ordner deiner Wahl, und findet php, node und die anderen Werkzeuge von WebDonkey ohne vollen Pfad.
So findest du es
Seitenleiste Lokal › Geplante Aufgaben, oben rechts Neue Aufgabe. Auf der Kommandozeile legt wd cron add "<Name>" --schedule "*/15 * * * *" --command "<Befehl>" eine Aufgabe an, optional mit --dir und --paused.
So gehst du vor
- Klick Neue Aufgabe.
- Name: zum Beispiel „Laravel-Scheduler“.
- Befehl: zum Beispiel
php artisan schedule:run. Er läuft über die Shell, Pipes,&&und Umgebungsvariablen funktionieren also. - Arbeitsverzeichnis (optional): der Ordner, in dem der Befehl startet. Tippe den Pfad oder nimm Wählen. Ohne Angabe ist es dein Home-Ordner.
- Zeitplan (cron expression): Vorgabe ist
*/15 * * * *, alle 15 Minuten. Tippe einen eigenen Ausdruck oder klick eine Vorlage an (siehe Der Zeitplan). - Aktiviert (nach Zeitplan ausführen): ist angehakt. Nimmst du den Haken weg, läuft die Aufgabe nur, wenn du Jetzt ausführen klickst.
- Klick Speichern. Der Knopf ist erst aktiv, wenn Name, Befehl und ein gültiger Zeitplan da sind.
Ist Aktiviert an, erinnert der Dialog: „Geplante Läufe brauchen ein laufendes WebDonkey. Was verpasst wurde, während es zu war, wird beim nächsten Öffnen nachgeholt.“ Wie du das änderst, steht unter Ohne geöffnete App ausführen.
php, node und andere Werkzeuge
Ein bloßer Werkzeugname wie php, node oder composer meint die Version, die du in WebDonkey gewählt hast, dieselbe wie im Terminal von WebDonkey. Ein Befehl braucht also keinen Pfad wie /opt/homebrew/bin/php.
- Liegt das Arbeitsverzeichnis im Projektordner einer Site, nutzt
phpdie PHP-Version dieser Site und ihre php.ini. Bei verschachtelten Sites gilt die innerste. - Willst du bewusst eine andere Version, gib den vollen Pfad zur Binary an.
- PHP liest die php.ini von WebDonkey samt gemeinsamer php.ini, nicht die von Homebrew.
Bearbeiten und löschen
- Der Stift auf der Karte (Bearbeiten) öffnet Aufgabe bearbeiten mit denselben Feldern. Wechselst du zwischendurch die Seite, bleibt dein Entwurf erhalten. Schließt du den Dialog, verwirft WebDonkey ihn.
- Der Papierkorb (Löschen) fragt Aufgabe löschen?. Gelöscht ist die Aufgabe dann ganz.
- Bei einer gesperrten Aufgabe (nach dem Wechsel zu Free) ist nur der Name änderbar. Der Dialog sagt: „Nur der Name ist änderbar. Die Aufgabe läuft erst wieder, wenn Premium aktiv ist.“
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Kostenloses Limit erreicht | In Free gibt es höchstens drei Aufgaben. | Lösch eine Aufgabe oder aktiviere Premium. |
| „Keine gültige cron expression.“ | Der Zeitplan ist kein gültiger 5-Feld-Ausdruck. | Prüf den Ausdruck oder nimm eine Vorlage. |
| Ergebnis Exit 127 | Der Befehl wurde nicht gefunden. | Prüf die Schreibweise oder gib den vollen Pfad an. |
| Der Befehl findet seine Dateien nicht | Er startet im Home-Ordner. | Trag das Arbeitsverzeichnis ein. |
Siehe auch
Der Zeitplan Free & Premium
Wann eine Aufgabe läuft, legst du mit einem Cron-Ausdruck fest, so wie in einer crontab. Für die häufigen Fälle gibt es Vorlagen zum Anklicken. Dieselbe Schreibweise gilt für den Zeitplan eines Backup-Sets.
So findest du es
Seitenleiste Lokal › Geplante Aufgaben, Neue Aufgabe oder der Stift auf einer Karte, dann das Feld Zeitplan (cron expression).
Aufbau eines Ausdrucks
Ein Ausdruck hat fünf Felder, durch Leerzeichen getrennt:
Minute Stunde Tag-des-Monats Monat Wochentag
| Feld | Werte |
|---|---|
| Minute | 0 bis 59 |
| Stunde | 0 bis 23 |
| Tag des Monats | 1 bis 31, oder L für den letzten Tag des Monats |
| Monat | 1 bis 12 oder JAN bis DEC |
| Wochentag | 0 bis 7 oder SUN bis SAT. 0 und 7 sind Sonntag, 1 ist Montag. |
In jedem Feld gehen * (jeder Wert), einzelne Zahlen, Bereiche (1-5), Listen (1,15) und Schritte (*/15, 8-18/2). Namen darfst du groß oder klein schreiben. Sind Tag des Monats und Wochentag beide eingeschränkt, reicht es, wenn einer der beiden passt, wie bei cron.
Beispiele
| Ausdruck | Wann |
|---|---|
*/15 * * * * |
alle 15 Minuten |
0 * * * * |
jede volle Stunde |
0 3 * * * |
täglich um 03:00 |
0 9 * * 1-5 |
werktags um 09:00 |
0 3 * * 1 |
jeden Montag um 03:00 |
30 2 1 * * |
am Ersten jedes Monats um 02:30 |
0 23 L * * |
am letzten Tag jedes Monats um 23:00 |
Vorlagen
Statt zu tippen, klickst du unter dem Feld eine Vorlage an:
| Vorlage | Ausdruck |
|---|---|
| Jede Minute | * * * * * |
| Alle 15 Minuten | */15 * * * * |
| Stündlich | 0 * * * * |
| Täglich um 03:00 | 0 3 * * * |
| Werktags um 09:00 | 0 9 * * 1-5 |
| Montags um 03:00 | 0 3 * * 1 |
Die passende Vorlage ist hervorgehoben. Entspricht dein Ausdruck einer Vorlage, steht ihr Name unter dem Feld, sonst die Erklärung „Fünf Felder: Minute Stunde Tag-des-Monats Monat Wochentag.“
Prüfung
WebDonkey prüft den Ausdruck beim Tippen. Ist er ungültig, steht „Keine gültige cron expression.“ unter dem Feld, und Speichern bleibt aus. So kann keine Aufgabe entstehen, die nie läuft.
Gut zu wissen
- Alle Zeiten sind deine lokale Uhrzeit.
- Bei der Zeitumstellung im Frühjahr läuft eine Uhrzeit, die es nicht gibt (etwa 02:30), zur ersten Minute danach. Eine Uhrzeit, die es im Herbst zweimal gibt, läuft nur beim ersten Mal.
- War der Mac oder die App aus, als eine Aufgabe fällig war, holt WebDonkey das beim nächsten Start nach.
- Soll die Aufgabe auch ohne geöffnete App laufen, passt nicht jeder Ausdruck. Jede Minute (
*im Minutenfeld),Lund sehr fein aufgeteilte Zeitpläne bleiben bei der App, siehe Ohne geöffnete App ausführen.
Siehe auch
Aufgaben ausführen und Ergebnisse lesen Free & Premium
Jede Aufgabe ist eine Karte auf der Seite Geplante Aufgaben. Sie zeigt den Zeitplan, das Ergebnis des letzten Laufs und die Ausgabe des Befehls. Von hier startest du eine Aufgabe sofort, pausierst sie oder setzt sie fort.
So findest du es
Seitenleiste Lokal › Geplante Aufgaben. Auf der Kommandozeile zeigt wd cron list alle Aufgaben mit Zeitplan, letztem und nächstem Lauf, wd cron run führt eine aus und gibt ihre Ausgabe aus. Mehr dazu unter Aufgaben, Backups und Logs.
Die Karte
| Element | Bedeutung |
|---|---|
| Name | Der Name der Aufgabe. |
| Zeitplan | Der Cron-Ausdruck als Etikett, etwa */15 * * * *. |
| Pausiert | Die Aufgabe läuft nicht nach Zeitplan. |
| OK (grün) | Der letzte Lauf endete erfolgreich (Exit-Code 0). |
| Exit n (rot) | Der letzte Lauf endete mit diesem Exit-Code. Die Ausgabe darunter zeigt meist, warum. |
| Befehl | Der Befehl, der läuft. |
| Ausgabe | Was der Befehl beim letzten Lauf ausgegeben hat, Standardausgabe und Fehlerausgabe zusammen, höchstens 64 KB. |
Eine gesperrte Aufgabe (nach dem Wechsel zu Free) ist gedämpft und trägt den Hinweis „Über dem Free-Limit, Premium schaltet frei“.
Aktionen
| Knopf | Was er tut |
|---|---|
| Jetzt ausführen | Startet die Aufgabe sofort, unabhängig vom Zeitplan. Während sie läuft, steht dort Läuft…. |
| Ein-/Aus-Symbol (Pausieren bzw. Fortsetzen) | Schaltet den Zeitplan aus und wieder ein, ohne die Aufgabe zu löschen. |
| Stift (Bearbeiten) | Öffnet Aufgabe bearbeiten, siehe Aufgabe anlegen. |
| Papierkorb (Löschen) | Fragt Aufgabe löschen? und löscht sie. |
Eine Aufgabe läuft nie zweimal gleichzeitig, egal ob sie die App, der Hintergrunddienst oder ein Klick gestartet hat. Läuft sie schon, sagt WebDonkey, dass diese Aufgabe bereits läuft, und startet keinen zweiten Lauf.
Nachvollziehen
- Jeder Lauf, auch jeder geplante, steht mit Exit-Code, Dauer und Auslöser im WebDonkey-Protokoll. Dort siehst du auch, wenn eine Aufgabe nicht zur geplanten Zeit gelaufen ist, weil der Mac aus war.
- Ein geplanter Lauf meldet sein Ergebnis in der Glocke: ein Häkchen bei Erfolg, sonst den Exit-Code mit der ersten Zeile der Ausgabe. Das schaltest du unter Benachrichtigungen bei Geplante Aufgabe gelaufen ab. Ein Lauf mit Jetzt ausführen meldet sich nicht, sein Ergebnis siehst du auf der Karte.
Gut zu wissen
Geplante Läufe brauchen ein laufendes WebDonkey. Was verpasst wurde, während die App zu war, holt WebDonkey beim nächsten Öffnen nach. Wie Aufgaben auch bei geschlossener App laufen, steht unter Ohne geöffnete App ausführen.
Siehe auch
Ohne geöffnete App ausführen Free
Geplante Aufgaben und geplante Backups laufen normalerweise in WebDonkey selbst. Ist die App zu, passiert zur geplanten Zeit nichts. Verpasstes holt WebDonkey beim nächsten Öffnen nach, es geht also nichts verloren, es passiert nur später. Für ein nächtliches Backup ist das zu spät. Deshalb kannst du das Timing an macOS übergeben: Dann starten Aufgaben und Backups auch bei geschlossener App und sogar, wenn niemand angemeldet ist.
So findest du es
- Auf den Seiten Geplante Aufgaben und Backups oben der Hinweis Auch ohne geöffnete App ausführen.
- In Einstellungen › System der Bereich Auch ohne die App nach Zeitplan laufen. Der Knopf Einstellungen im Hinweis führt direkt dorthin.
So richtest du es ein
- Klick im Hinweis oder in den Einstellungen Einrichten.
- macOS fragt einmalig nach deinem Administrator-Passwort. Während WebDonkey einrichtet, steht dort Wird eingerichtet ….
- Der Hinweis zeigt danach Eingerichtet und darunter, wie viele deiner Zeitpläne ohne die App laufen, etwa „3 von 4 laufen ohne die App“.
- Liegen Projekte in Dokumente, Schreibtisch, iCloud Drive oder auf einer externen Platte, gib dem WebDonkey-Runner in den Systemeinstellungen von macOS unter Datenschutz & Sicherheit › Festplattenvollzugriff den Zugriff. Das kann keine App für dich erledigen.
Ist alles eingerichtet, blendest du den Hinweis auf der jeweiligen Seite mit dem × (Hinweis ausblenden) aus. Er kommt von selbst wieder, wenn etwas nicht mehr stimmt.
Die Zustände
| Zustand | Bedeutung | Was du tust |
|---|---|---|
| Nicht eingerichtet | Aufgaben und Backups laufen nur bei geöffneter App. | Einrichten, wenn du es brauchst. |
| Eingerichtet | macOS startet deine Zeitpläne selbst. | nichts |
| Update nötig | WebDonkey wurde seit der Einrichtung aktualisiert, die Einträge nutzen noch die alte Version. | Einrichten noch einmal, das ersetzt sie mit einer einzigen Passwort-Abfrage. |
| Freigabe fehlt | Die Berechtigung ist weg, etwa weil sie im System entfernt wurde. | Einrichten noch einmal. |
In den Einstellungen
Unter Einstellungen › System, Bereich Auch ohne die App nach Zeitplan laufen:
| Knopf | Was er tut |
|---|---|
| Einrichten | Richtet die Zeitplanung ein, siehe oben. |
| Einträge neu aufbauen | Schreibt die Einträge aller Aufgaben und Sets neu, etwa wenn ein Zeitplan nicht wie erwartet läuft. |
| Abschalten | Nimmt alle Einträge aus macOS. Danach laufen Zeitpläne wieder nur bei geöffneter App. |
| Entfernen | Erscheint nur, wenn aus einer früheren Version noch ein Hilfsprogramm mit Administratorrechten installiert ist, das nicht mehr gebraucht wird. |
Zwei Dinge vorher
- Dein Benutzerkonto: Diese Läufe nutzen dein Konto, mit genau deinen Rechten. Dateien, die dabei entstehen, gehören dir.
- Festplattenvollzugriff: Für Dokumente, Schreibtisch, iCloud Drive oder externe Laufwerke braucht der WebDonkey-Runner einmalig „Festplattenvollzugriff“ in den Systemeinstellungen.
Welche Zeitpläne macOS übernimmt
macOS übernimmt einen Zeitplan nur, wenn er in höchstens 96 Kalendereinträge passt. WebDonkey braucht einen Eintrag für jede Kombination der Werte, die du in Minute, Stunde, Tag, Monat und Wochentag aufzählst. Ein Feld mit * zählt einmal. Ein * im Minutenfeld, also jede Minute, übernimmt macOS nie.
| Zeitplan | Einträge | Ohne App? |
|---|---|---|
*/15 * * * * (alle 15 Minuten) |
4 | ja |
*/15 * * * 1-5 (alle 15 Minuten, werktags) |
20 | ja |
0 * * * 1-5 (stündlich an Werktagen) |
5 | ja |
0 3 * * * (täglich um 03:00) |
1 | ja |
* * * * * (jede Minute) |
nein, * im Minutenfeld |
|
0 23 L * * (am Monatsletzten) |
nein, L |
|
*/10 8-18 * * 1-5 (alle 10 Minuten von 8 bis 18 Uhr an Werktagen) |
330 | nein, über 96 |
Was nicht passt, bleibt bei der App und läuft, sobald du sie öffnest. Die Grenze verhindert, dass macOS deinen Mac ständig aufweckt. Ist nicht alles abgedeckt, erklärt das ein Satz in den Einstellungen, und die Zählung „x von y laufen ohne die App“ zeigt, wie viele es sind.
Was im Hintergrund passiert
- Für jede Aufgabe und jedes geplante Backup-Set mit Zeitplan legt WebDonkey einen eigenen Systemeintrag (LaunchDaemon) unter
/Library/LaunchDaemonsan. macOS startet zur geplanten Zeit den WebDonkey-Runner, der die Aufgabe aus WebDonkeys Datenbank liest und ausführt. - Änderst du eine Aufgabe oder ein Set, zieht WebDonkey den Eintrag nach.
- Eine Aufgabe läuft nie doppelt: Läuft sie schon, weil die App sie gestartet hat, startet der Runner keinen zweiten Lauf, und umgekehrt.
- Was der Runner tut, steht im WebDonkey-Protokoll mit Geschrieben von Hintergrunddienst. Geht dabei etwas schief, meldet WebDonkey es in der Glocke: bei geöffneter App innerhalb einer Minute, sonst beim nächsten Öffnen.
- Ein Backup bei geschlossener App sichert die Dateien. Datenbanken, deren Server dann nicht läuft, lässt es aus und nennt sie, siehe Zeitplan, Speicherort und Aufbewahrung.