Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Jobe
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Jobe führt kleine Programmieraufgaben über eine HTTP-Schnittstelle aus und dient unter anderem als Ausführungsdienst für Moodle CodeRunner.
Voraussetzungen und Grenzen
Diese Anleitung beschreibt eine native Installation auf Ubuntu 26.04 LTS (amd64) mit Apache und PHP, ohne Docker. Für den Einstieg werden Python 3, C und C++ eingerichtet. Weitere Sprachen können später ergänzt werden.
Die offizielle Anleitung behandelt vor allem Ubuntu 22.04. Die hier beschriebenen Anpassungen für Ubuntu 26.04 wurden anhand des Quellstands bfca53c vorbereitet, aber nicht vollständig auf dem Zielsystem ausgeführt. Die HTTP- und Ausführungstests am Ende sind deshalb erforderlich, bevor du diesen Aufbau verwendest.
Rechnerwahl: Verwende einen eigenen Testrechner oder eine separate Ubuntu-VM ohne persönliche Daten. Jobe legt Systembenutzer und privilegierte sudo-Regeln an. Sein runguard begrenzt Prozesse und Ressourcen, ersetzt aber keine vollständig abgeschottete virtuelle Maschine. Die API wird hier nur über 127.0.0.1:8081 bereitgestellt. Vor einem späteren Einsatz mit Moodle sind eigene Zugriffsregeln und eine Prüfung der Netzwerktrennung erforderlich.
Die Anleitung setzt voraus, dass noch keine Jobe-Installation und keine gleichnamigen Systembenutzer vorhanden sind. Apache muss eingerichtet werden können; auf einem Rechner mit bestehendem nginx, Apache oder PHP-FPM ist die Webserverkonfiguration vorher abzustimmen. Insbesondere darf Apache nicht ungeplant einen bereits belegten Port 80 übernehmen.
Pakete installieren
1. Paketlisten aktualisieren
Damit Ubuntu die aktuellen Paketversionen kennt.
sudo apt update
2. Webserver und Werkzeuge installieren
Installiert PHP für Apache, die von Jobe benötigten PHP-Module und Werkzeuge zum Bauen des Ausführungshelfers. Ein Datenbankserver ist für diesen Aufbau nicht erforderlich.
sudo apt install apache2 libapache2-mod-php php-cli php-mbstring php-intl php-xml php-curl acl git build-essential libcgroup-dev python3 curl ca-certificates sudo nano
3. PHP-Erweiterungen prüfen
Alle ausgegebenen Werte müssen true sein. Besonders die Funktionen für gemeinsamen Speicher und Semaphoren werden für die Jobverwaltung benötigt.
php -r 'var_dump(extension_loaded("intl"), extension_loaded("mbstring"), function_exists("sem_get"), function_exists("shm_attach"));'
Apache vor dem Download absichern
4. Zugriff auf den künftigen Quellordner sperren
Öffne diese neue Apache-Konfiguration und füge den folgenden Inhalt ein. Sie verhindert, dass der standardmäßige DocumentRoot den Quellcode über Port 80 ausliefert. Nur das öffentliche Verzeichnis erhält später einen lokalen Zugang.
sudo nano /etc/apache2/conf-available/jobe-local-access.conf
<Directory /var/www/html/jobe>
AllowOverride None
Require all denied
</Directory>
<Directory /var/www/html/jobe/public>
Options -Indexes +FollowSymLinks
AllowOverride All
Require local
</Directory>
Speichere mit Strg+O, bestätige mit Enter und beende nano mit Strg+X. Verwende dieselben Tasten auch bei den späteren Konfigurationsdateien.
5. Zugriffskonfiguration aktivieren
Macht die neuen Verzeichnisregeln für Apache verfügbar.
sudo a2enconf jobe-local-access
6. Rewrite-Modul aktivieren
Jobe bringt im öffentlichen Verzeichnis Regeln für seine URLs mit.
sudo a2enmod rewrite
7. Lokalen API-Endpunkt anlegen
Öffne die neue Site-Datei und trage den nachfolgenden Inhalt ein. Der zusätzliche Port wird ausschließlich an Loopback gebunden. Der Alias erhält den von den Jobe-Testwerkzeugen erwarteten Pfad /jobe/.
sudo nano /etc/apache2/sites-available/jobe-local.conf
Listen 127.0.0.1:8081
<VirtualHost 127.0.0.1:8081>
ServerName localhost
DocumentRoot /var/www/html/jobe/public
Alias /jobe/ /var/www/html/jobe/public/
ErrorLog ${APACHE_LOG_DIR}/jobe-error.log
CustomLog ${APACHE_LOG_DIR}/jobe-access.log combined
</VirtualHost>
8. Lokale Site aktivieren
Nimmt die zusätzliche Site in die Apache-Konfiguration auf.
sudo a2ensite jobe-local
9. Apache-Konfiguration prüfen
Die Ausgabe muss Syntax OK enthalten. Behebe Fehler, bevor du fortfährst.
sudo apache2ctl configtest
10. Apache-Einstellungen übernehmen
Aktiviert die Zugriffssperre und den lokalen Port, bevor Jobe heruntergeladen wird.
sudo systemctl restart apache2
Jobe einrichten
11. Quellcode in den vorgesehenen Ordner laden
Der Installer erwartet Jobe unter /var/www/jobe oder /var/www/html/jobe. Verwende keinen symbolischen Link aus einem anderen Verzeichnis. Der Zielordner darf noch nicht existieren.
sudo git clone https://github.com/trampgeek/jobe.git /var/www/html/jobe
12. Geprüften Stand auswählen
Verwendet den oben genannten Commit einschließlich der Sicherheitskorrekturen aus September 2026. Die veraltete Versionszeile am Anfang der README ist hierfür nicht maßgeblich.
sudo git -C /var/www/html/jobe checkout --detach bfca53c0a449815d5c228353260c37b9f6e57f3d
13. Anzahl gleichzeitiger Jobs begrenzen
Öffne die Jobe-Konfiguration und ändere die vorhandene Zeile für $jobe_max_users auf den folgenden Wert. Zwei gleichzeitige Jobs reichen für den lokalen Einstieg und begrenzen den anfänglichen Ressourcenbedarf. Lass debugging ausgeschaltet. Die Schlüsselprüfung bleibt für diesen ausschließlich lokalen Test im voreingestellten Zustand deaktiviert.
sudo nano /var/www/html/jobe/app/Config/Jobe.php
public int $jobe_max_users = 2;
14. Installationsordner öffnen
Das Installationsskript verwendet das aktuelle Verzeichnis für seine Pfade.
cd /var/www/html/jobe
15. Nativen Installer ausführen
Das Skript erzeugt die Jobe-Benutzer, Arbeitsverzeichnisse und sudo-Regeln und übersetzt runguard sowie den Aufräumhelfer. Es benötigt einen laufenden Apache zur Erkennung des Webserverbenutzers. Fahre nur fort, wenn die Installation ohne Fehler abgeschlossen wird.
sudo ./install
16. Programmdateien root zuordnen
Der Installer macht zunächst große Teile des Projektbaums für den Webserver schreibbar. Für diesen Aufbau wird der Code anschließend root zugeordnet. Auch die über sudo gestarteten Helfer und ihre übergeordneten Verzeichnisse müssen gegen Austausch durch den Webserver geschützt sein.
sudo chown -R root:root /var/www/html/jobe
17. Schreibrechte für Code beschränken
Verhindert Änderungen am Programmbaum durch Gruppe und andere Benutzer. Die Ausführungsrechte der vom Installer gebauten Helfer bleiben erhalten.
sudo chmod -R go-w /var/www/html/jobe
18. Webserver-Leserechte einrichten
Eine ACL erlaubt Apache das Lesen und Durchqueren des Programmbaums. Sie gibt ihm keine Schreibrechte auf Code oder privilegierte Helfer. Die root-eigenen Verzeichnisse verhindern deren Austausch.
sudo setfacl -R -m u:www-data:r-X /var/www/html/jobe
19. Laufzeitverzeichnis dem Webserver zuordnen
Nur writable innerhalb des Projektbaums muss für Logs und Framework-Caches beschreibbar bleiben. Die vom Installer eingerichteten Verzeichnisse unter /home/jobe und /var/log/jobe behalten ihre gesonderten Rechte.
sudo chown -R www-data:www-data /var/www/html/jobe/writable
20. UTF-8 für Apache einstellen
Öffne die Umgebungsdatei. Ersetze die vorhandene Einstellung für LANG durch die folgende Zeile, damit Programmausgaben mit Umlauten korrekt verarbeitet werden.
sudo nano /etc/apache2/envvars
export LANG=C.UTF-8
21. sudo-Regeln prüfen
Die Ausgabe darf keine Syntaxfehler enthalten. Die Jobe-Regeln müssen auf die Helfer im tatsächlichen Installationsordner zeigen.
sudo visudo -c
22. Apache neu starten
Übernimmt die UTF-8-Umgebung und startet die Anwendung mit den endgültigen Dateirechten.
sudo systemctl restart apache2
Installation prüfen
23. Sprachliste abrufen
Die Antwort soll eine JSON-Liste mit den verfügbaren Sprachen enthalten. Beim ersten Aufruf muss Jobe die vorhandenen Interpreter und Compiler erkennen; das kann länger dauern.
curl --fail --show-error http://127.0.0.1:8081/jobe/index.php/restapi/languages
24. Eigenen Python-Code ausführen
Dieser Test prüft zusätzlich die Jobvergabe und Programmausführung. Erwartet werden outcome mit dem Wert 15 und die Ausgabe Jobe funktioniert in stdout.
curl --fail --show-error \
--header 'Content-Type: application/json' \
--data '{"run_spec":{"language_id":"python3","sourcecode":"print(\"Jobe funktioniert\")","sourcefilename":"probe.py"}}' \
http://127.0.0.1:8081/jobe/index.php/restapi/runs
25. Bind-Adresse prüfen
Port 8081 muss an 127.0.0.1 gebunden sein. Andere Apache-Ports gehören zur allgemeinen Apache-Konfiguration und werden durch die zusätzliche Site nicht entfernt.
sudo ss -ltnp 'sport = :8081'
Bei HTTP-Fehlern prüfe das Jobe-Fehlerprotokoll. Eine erfolgreiche Sprachliste allein reicht nicht: Auch der Ausführungstest muss funktionieren. Werden Sandbox- oder PHP-Fehler gemeldet, ist der Aufbau noch nicht einsatzbereit.
sudo tail -n 50 /var/log/apache2/jobe-error.log
Für eine spätere Anbindung von Moodle müssen der lokale Listener und die Zugriffsregel bewusst auf den vorgesehenen Client angepasst werden. Richte dabei eine eigene API-Schlüsselkonfiguration und Netzbeschränkung ein; öffne diesen Dienst nicht allgemein für das Internet. Die Details der Jobe-Schnittstelle stehen im offiziellen Repository.
Deinstallieren
Die folgenden Schritte sind nur für die in dieser Anleitung neu eingerichtete Instanz bestimmt. Sie löschen deren Benutzer, Cache und Arbeitsdaten. Sichere benötigte Daten vorher und warte, bis alle Jobs beendet sind.
1. Lokale Site deaktivieren
Entfernt den zusätzlichen Listener aus der aktiven Konfiguration.
sudo a2dissite jobe-local
2. Apache neu starten
Beendet die bisherigen Webprozesse und übernimmt die deaktivierte Site.
sudo systemctl restart apache2
3. Privilegierte Jobe-Freigaben entfernen
Entzieht dem Webserver die Jobe-spezifischen sudo-Berechtigungen. Der Deinstaller entfernt diese Datei nicht selbst.
sudo rm -- /etc/sudoers.d/jobe-sudoers
4. Installationsordner öffnen
Der Deinstaller benötigt dieses Arbeitsverzeichnis.
cd /var/www/html/jobe
5. Jobe-Systemkonten und Arbeitsdaten entfernen
Das Projektskript entfernt die Jobe-Workerbenutzer sowie unter anderem /home/jobe und /var/log/jobe. Verwende es nicht, wenn diese Benutzer noch für eine andere Jobe-Instanz gebraucht werden.
sudo ./install --uninstall
6. Ins Home-Verzeichnis wechseln
Verlässt den Ordner, der anschließend gelöscht wird.
cd ~
7. Programmordner löschen
Entfernt den Jobe-Quellcode samt lokaler Einstellungen und Framework-Caches.
sudo rm -rf -- /var/www/html/jobe
8. Zugriffskonfiguration deaktivieren
Die Sperre für den inzwischen entfernten Ordner wird nicht mehr benötigt.
sudo a2disconf jobe-local-access
9. Site-Datei entfernen
Entfernt die von dieser Anleitung angelegte Listener-Konfiguration.
sudo rm -- /etc/apache2/sites-available/jobe-local.conf
10. Zugriffskonfiguration entfernen
Löscht ausschließlich die zusätzliche Jobe-Konfiguration.
sudo rm -- /etc/apache2/conf-available/jobe-local-access.conf
11. Apache-Konfiguration übernehmen
Apache, PHP und Compiler bleiben für andere Anwendungen installiert.
sudo systemctl reload apache2
Prüfen: Für Port 8081 soll keine Jobe-Listenerzeile mehr erscheinen. Kontrolliere außerdem mit sudo visudo -c, dass die verbleibenden sudo-Regeln gültig sind.
sudo ss -ltnp 'sport = :8081'
Lizenz und Betriebsart
Jobe steht unter MIT. Docker ist optional; dieses Kapitel verwendet weiterhin die native Installation.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.