Cronjob-Funktionen

Aus manitu Wiki
Version vom 23. März 2022, 08:57 Uhr von Admin (Diskussion | Beiträge)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Vorwort

Vorwort

In diesem Wiki-Beitrag erläutern wir Ihnen, wie Sie in Ihrem Siteadmin-Bereich ganz einfach einen Cronjob einrichten können. Sie finden die Cronjob Einstellungen innerhalb Ihres Siteadmin-Bereichs unter der Oberfläche "Cronjobs".

Wie erstelle ich einen Cronjob?

Zunächst müssen Sie die "Cronjobs" Oberfläche in Ihrem Siteadmin-Bereich aufrufen. Dort angekommen, wird Ihnen eine Tabelle aufgezeigt, in der sämtliche bereits angelegten Cronjobs aufgelistet werden. Sofern Sie keine Cronjobs haben, ist diese Tabelle leer.

Cronjob erstellen

Unter der Tabelle finden Sie den Button "Neuen Cronjob erstellen". Wenn Sie diesen anwählen, werden Sie zur der Konfigurationsseite Ihres neuen Cronjobs weitergeleitet.

Status

Hier können Sie einstellen, ob der neu erstellte Cronjob direkt nach der Erstellung aktiv sein soll. Standardmäßig ist diese Einstellung auf "aktiv" gestellt. Sofern Sie wünschen, dass der Cronjob nicht direkt nach der Erstellung funktionsfähig ist, können Sie an diesem Punkt den Cronjob auf "inaktiv" schalten. Nach der Erstellung des Cronjobs können Sie diesen danach über "bearbeiten" in der Cronjob-Auflistung wieder auf "aktiv" stellen.

Status überprüfen

Beschreibung

An diesem Punkt können Sie eine personalisierte Beschreibung dem Cronjob zuweisen. Das Beschreiben von einzelnen Cronjobs schafft Übersicht über Ihre Cronjobs. Dort können Sie z. B. die Funktion des Cronjobs beschreiben, oder einen Namen festlegen. Dies ist Ihnen überlassen. Sofern keine Beschreibung erwünscht ist, können Sie das Feld frei lassen.

Typ

Unter diesem Punkt können Sie die Art des Cronjobs wählen. Hier unterscheiden wir wie folgt:

  • Befehl ausführen: Unter diesem Typ können Sie in einem weiteren Eingabefeld einen einzelnen beliebigen Befehl eintippen, welcher zu dem von Ihnen festgelegten Zeitpunkt ausführen soll. Dies ermöglicht es Ihnen kleinere Aufgabe direkt über den passenden Befehl bearbeiten zu lassen, ohne dass Sie ein ganzes Skript dafür anlegen müssen.
Typ
  • URL aufrufen: Hier können Sie in einem weiteren Eingabefeld eine URL einfügen, welche zu dem eingestellten Zeitpunkt vom Ihrem Paket aufgerufen wird. So können Sie z. B. PHP-Skripte die über eine URL aufgerufen werden, bequem einrichten. Beachten Sie hier nur, dass Sie die URL in folgendem Format angeben: https://ihreDomain.tld/webcron.php
  • PHP-Skript ausführen: Bei diesem Punkt können Sie einzelne PHP-Skripte, die in Ihrem Paket abgespeichert sind, regelmäßig über einen Cronjob ausführen lassen. Dabei geben Sie einfach den absoluten Pfad des Skripts an. Zu diesem Punkt können Sie auch gezielt die passenden und von uns angebotenen PHP-Versionen auswählen.

Häufigkeit

Häufigkeit des Cronjobs

Hier können Sie die Häufigkeit Ihres Cronjobs, sprich in welchen Intervallen Ihr Cronjob ausgeführt werden soll, einstellen. Dabei unterscheidet wir zwischen:

  • stündlich: Hier können Sie die Minute innerhalb einer Stunde angeben, wann Ihr Cronjob ausgeführt werden soll.
  • täglich: Bei diesem Punkt können Sie die Stunde und die Minute angeben, an dem Ihr Cronjob ausgeführt werden soll.
  • wöchentlich: Hier können Sie zuzüglich der Stunde und der Minute, noch einen Wochentag angeben, an dem Ihr Cronjob ausgeführt werden soll.
Häufigkeit des Cronjobs
  • monatlich: An diesem Punkt können Sie zu der Stunde und der Minute einen Tag im Monat angeben (z. B. 14), an dem Ihr Cronjob ausgeführt werden soll.
  • jährlich: Zuletzt können Sie zu diesem Punkt zu der Stunde, der Minute und dem Tag noch einen Monat wählen, an dem Ihr Cronjob ausgeführt werden soll.

Wann benachrichtigen

Benachrichtigung

Unter diesem Punkt können Sie eine Art der Benachrichtigung wählen.

  • nie: Es werden keine Benachrichtigungen verschickt, egal ob der Cronjob erfolgreich oder fehlerhaft beendet wurde.
  • bei Fehlern: Hier werden Sie benachrichtigt, falls der Cronjob fehlerhaft beendet wurde.
  • immer: Hier werden Sie über alle erfolgreichen und fehlerhaften Ausführungen des Cronjobs informiert.

Wie benachrichtigen

In dieser Auswahl können Sie den Weg wählen, wie Sie über Fehler oder erfolgreiche Vorgänge informiert werden möchten. Dabei unterscheiden wir wie folgt:

  • in Log-Datei: Hier werden alle ausgewählten Meldungen in die Log-Datei gespeichert.
  • per E-Mail: Bei dieser Auswahl werden Sie per E-Mail über Fehler und oder über erfolgreiche Vorgänge Ihres Cronjobs informiert. In dieser Auswahl müssen Sie noch weitere Einstellungen einrichten:
    • E-Mail-Adresse des Empfängers: An diesem Punkt müssen Sie die E-Mail-Adresse angeben, an welche die Benachrichtigung gesendet werden soll.
    • Betreff der E-Mail: Hier können Sie den Betreff der Mail anpassen. Dafür bieten wir auch ein paar wenige Samples an.
    • Text der E-Mail: Bei diesem Punkt können Sie den Inhalt der E-Mail anpassen.


Am Ende erläutern wir, dass wir für diese Art von E-Mails eigene Header verwenden. Mit diesen Headern können Sie nach den E-Mails filtern um diese besser in Ihrem Postfach ausfindig machen zu können.

Wie starte ich einen Cronjob für die cron.php meiner Nextcloud?

Wie oben schon angegeben gibt es die Möglichkeit einen Cronjob über ein PHP-Skript zu erstellen. Dabei haben Sie auch die Möglichkeit die cron.php Ihrer Nextcloud-Installation zu starten. Dies gewährt Ihnen, dass regelmäßige Aufgaben, die gewöhnlich erst beim Aufrufen der Nextcloud erledigt werden, im Hintergrund gestartet werden.

Welche Einstellungen muss ich dafür in meiner Nextcloud vornehmen?

Konfiguration in Nextcloud

Es ist nur eine kleine Änderung vonnöten damit Sie den Cronjob für Ihre Nextcloud erstellen können. Dabei müssen Sie nur die Hintergrund-Aufgaben in Ihren Grundeinstellungen auf "Cron" umstellen. Sie gelangen zu den Grundeinstellung in dem Sie sich in Ihrer Nextcloud einloggen und dann rechts oben auf Ihr Profil klicken. Darunter sollte sich eine Auswahl erscheinen, in der Sie "Einstellungen" auswählen. Dort angekommen müssen Sie nur noch auf der linken Spalte "Grundeinstellungen" ausfindig machen und darauf klicken.

Was muss ich in meinem Siteadmin-Bereich angeben?

Wieder im Siteadmin-Bereich Ihres Pakets angekommen begeben Sie sich einfach, wie oben angegeben, auf die "Cronjob" Übersicht Ihres Siteadmin-Bereichs. Dort angekommen müssen Sie den Typ "PHP-Skript ausführen" auswählen und den Pfad der Nextcloud cron.php angeben. Dieser könnte z. B. so /web/nextcloud/cron.php aussehen.

Dies abgeschlossen können Sie einfach wie oben beschrieben die Häufigkeit einstellen und oder ob Sie benachrichtigt werden und wie.


Bei korrekten Einstellungen wird innerhalb Ihrer Nextcloud unter den Einstellung der Hintergrund-Aufgaben mit einem grünen Punkt signalisiert, dass der Cronjob erfolgreich durchgeführt wurde.