Anlegen eines Supervisor Jobs in ISPConfig

Anlegen eines Supervisorjobs in ISPConfig

Viele Anwendungen, die Symfony als Basis haben, beispielsweise Drupal, Joomla, Magento, PrestaShop und Shopware 6, setzen vermehrt darauf, dass deren Aufgaben über einen Supervisor-Task getriggert werden.

Für Timme Hosting Kunden haben wir im ISPConfig eine Funktion hinterlegt, mit der Sie komfortabel Supervisor-Tasks erstellen und verwalten können. Diese Funktion steht allen Servern aus der aktuellsten Generation zur Verfügung.

Wie Sie Supervisorjobs in der Verwaltungsoberfläche Ihres Webservers anlegen, erklären wir in den nachfolgenden Schritten.

Managed vServer, Managed Server & ScaleServer: Loggen Sie sich bitte über Ihr Server Control Panel ein.


1

  • Loggen Sie sich ein (siehe Hinweis).
  • Wählen Sie im Hauptmenü den Punkt "Webseiten".

Ergebnis: Die Seite "Webseiten" wird angezeigt.


Klicken Sie auf das Bild, um es zu vergrößern.

2

  • Im Untermenü befindet sich der Punkt "Kommandozeile".
  • Wählen Sie hier "Supervisor Jobs".

Ergebnis: Der Bereich Supervisor Jobs wird geöffnet. Hier können neue Supervisorjobs angelegt und bestehende bearbeitet werden.



3

  • Sie befinden sich im Bereich Supervisor Jobs.
  • Über den Button "Neuen Supervisor Job anlegen" erstellen Sie einen neuen Supervisorjob.

Ergebnis: Es öffnet sich das Formular Supervisor Job.



4

Füllen Sie das Formular aus.

1. Website wählen

  • Wählen Sie per Dropdown die Website, für die der Supervisorjob angelegt werden soll.

2. Auszuführender Befehl

Geben Sie in dieses Textfeld einen der folgenden Werte ein:

  • Pfad zur PHP-Version sowie Pfad zum auszuführenden Skript.
    Beispiel: [php] {Stammordner}/web/supervisor.php
    Der Platzhalter [php] wird durch die PHP-Version der Website ersetzt.
  • Der Platzhalter {Stammordner} wird durch /var/www/clients/clientX/webY ersetzt.
  • Falls Sie eine andere PHP Version für Ihren Supervisorjob nutzen möchten als die, die in der Website eingestellt ist, können Sie auch einen absoluten Pfad zu einer PHP Version angeben, zum Beispiel: '/opt/php-8.1/bin/php [...]'.

Hinweis: Die PHP-Einstellungen, die für eine Website gelten, gelten auch für Supervisorjobs.

3. Ausführungspfad
Dieses Feld ist optional. Geben Sie hier das Verzeichnis an, in welchem die auszuführende Datei liegt. Dies hat den Vorteil, dass Sie in Ihren Skripten oder Programmen relative Pfade verwenden können. Viele Skripte setzen dies sogar voraus, weshalb diese Angabe sogar empfehlenswert ist.

4. Prozessmaximum
Legen Sie mit dieser Einstellung die Anzahl der parallel laufenden Instanzen des Supervisorjobs fest.

5. stopwaitsecs
Mit dieser Einstellung legen Sie fest, wie viele Sekunden supervisord warten soll, bis der Prozess nach einem "Stop"-Befehl tatsächlich beendet ist, bevor er zwangsbeendet wird.

6. Aktiv
Wenn die Schaltfläche auf "aus" steht, wird der Supervisorjob nicht ausgeführt. Mit dieser Funktion können Sie Supervisorjobs vorübergehend deaktivieren, ohne sie zu löschen.

7. Beschreibung
Dieses Feld ist optional. Hier können Sie eine eigene Beschreibung einfügen. So lassen sich Supervisorjobs später eindeutig einer Aktion zuordnen.

8. Speichern
Bestätigen Sie die Eingabe mit einem Klick auf den grünen Button "Speichern".

Ergebnis: Das Formular ist ausgefüllt und bestätigt. Wenige Sekunden später sehen Sie die Statusmeldung „Die Server-Aktion supervisor wurde erfolgreich ausgeführt“.



5

Beispiel im Bild Supervisorjob:

[php] {Stammordner}/web/bin/console messenger:consume --time-limit=300 --memory-limit=256M

Supervisor wechselt in das Ausführungsverzeichnis, in diesem Fall in den Stammordner

/var/www/clients/ClientX/webY

und startet dort immer genau einmal den Befehl

/opt/php-X/bin/php /var/www/clients/clientX/webY/web/bin/console messenger:consume --time-limit=300 --memory-limit=256M

Sofern Supervisor den Prozess beenden soll, wird 10 Sekunden darauf gewartet, bis der Prozess beendet wurde. Danach wird der Prozess hart beendet.

Weitere Beispiele für Intervallangaben:

  • Prozessmaximum von 1 auf 4 erhöhen:
    Bedeutung: Nun laufen immer genau 4 dieser Prozesse parallel.

Sie haben einen Supervisorjob in ISPConfig angelegt.

Supervisor-Job kontrollieren oder neu starten

Supervisor eignet sich besonders für eigene Anwendungen, zum Beispiel in Python oder Node.js (etwa Nuxt), die auf einem internen Port laufen. ISPConfig leitet Ihre Website dann sicher per SSL auf diesen Port weiter. Supervisor startet den Prozess als Benutzer Ihrer Website, überwacht ihn und kann ihn jederzeit vollständig neu starten.

Ändert sich der Code Ihrer Anwendung, zum Beispiel nach einem Deployment, sollten Sie den Supervisor-Job neu starten. Erst dann arbeitet der Prozess mit dem neuen Stand. Für den Neustart gibt es zwei Wege, die sich beide in automatische Abläufe einbauen lassen.

Über die ISPConfig-API

Mit der API-Funktion sites_supervisor_restart starten Sie einen Supervisor-Job neu, ohne sich im Server Control Panel anzumelden. Sie übergeben dabei die ID des Supervisor-Jobs. Der API-Benutzer braucht dafür die Berechtigung „Webseiten-Supervisor-Funktionen“. Ein Beispielskript und die Einrichtung der API finden Sie in unserer Anleitung ISPConfig API: Schnittstelle zur Automatisierung.

Über die Kommandozeile

Auf Wunsch richten wir für Ihre Website ein Verwaltungsscript für Supervisor ein. Schreiben Sie uns dazu ein Support-Ticket mit der Website und der ID des Supervisor-Jobs. Der Aufwand beträgt ca. 15 bis 20 Minuten und wird gemäß unserer Preisliste als individueller Support abgerechnet.

Das Script liegt danach im Ordner private Ihrer Website. Sein Name enthält die Nummern von Kunde und Website, zum Beispiel supervisorc2w9 für die Website unter /var/www/clients/client2/web9. Melden Sie sich per SSH an und wechseln Sie in den Stammordner der Website.

Status aller Prozesse des Supervisor-Jobs abfragen:

private/supervisorc2w9 status all

Ergebnis:

client2-web9-3:client2-web9-3-0   RUNNING   pid 2855882, uptime 0:20:32

Supervisor-Job neu starten:

private/supervisorc2w9 restart all

Ergebnis:

client2-web9-3:client2-web9-3-0: stopped
client2-web9-3:client2-web9-3-0: started

Startet der Supervisor-Job mehrere Prozesse (Prozessmaximum größer als 1), sprechen Sie statt mit all einzelne Prozesse über ihre Nummer an. Die Nummer steht am Ende des Prozessnamens, die Zählung beginnt bei 0:

private/supervisorc2w9 status 0

Tipp: Nehmen Sie den Befehl restart all in Ihr Deployment-Script auf. Dann läuft Ihr Supervisor-Job nach jedem Deployment automatisch mit dem neuen Stand.

Finden Sie den passenden Tarif

Unser Tarifberater hilft Ihnen dabei, das passende Paket zu finden. Bei Fragen berät Sie unser Sales-Team sehr gerne unter +49 (0) 4131 / 22 78 1-25 oder sales@timmehosting.de.

Bitte beachten Sie: Der Tarifberater dient nur der groben Orientierung. Ihr tatsächlicher Bedarf kann durch den Ressourcenbedarf Ihrer Anwendung(en), tageszeitabhängige/saisonale/aktionsbedingte Schwankungen des Besucheraufkommens, geplantes Wachstum und weitere Faktoren von der Empfehlung abweichen.

  • 1
  • 2
  • 3
  • 4
  • 5

Was möchten Sie hosten?

Möchten Sie einen oder mehrere Shops hosten? (Eine Multishop-Installation gilt als ein Shop.)

Möchten Sie eine oder mehrere Websites hosten? (Eine Multisite-Installation gilt als eine Website.)

Wieviele Besucher haben Sie insgesamt pro Tag?

Wieviele Besucher haben Sie insgesamt pro Tag?

Wieviele Besucher haben Sie insgesamt pro Tag?

Wieviele Artikel haben Sie insgesamt in Ihrem Shop/Ihren Shops (inkl. Varianten)?

Wieviele Artikel haben Sie insgesamt in Ihrem Shop/Ihren Shops (inkl. Varianten)?

Wieviel Speicherplatz benötigen Sie insgesamt?

Wieviel Speicherplatz benötigen Sie insgesamt?

Wieviel Speicherplatz benötigen Sie insgesamt?

Wir empfehlen Ihnen folgende Lösungen:

ScaleServer oder Web Hosting

Zu den ScaleServer Paketen Zu den Web Hosting Paketen

Wir empfehlen Ihnen folgende Lösungen:

ScaleServer oder Shop Hosting

Zu den ScaleServer Paketen Zu den Shop Hosting Paketen

Wir empfehlen Ihnen folgende Lösungen:

Managed vServer oder ScaleServer

Zu den Managed vServer Paketen Zu den ScaleServer Paketen

Wir empfehlen Ihnen folgende Lösungen:

Managed Server oder ScaleServer

Zu den Managed Server Paketen Zu den ScaleServer Paketen

Wir empfehlen Ihnen unsere

Managed Server

Zu den Managed Server Paketen