Piston

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Piston führt Quellcode über eine lokale HTTP-API mit separat installierten Sprachlaufzeiten aus.

Vorbemerkungen

  • Docker-Ausnahme: Diese Anleitung beschreibt Ubuntu 26.04 LTS (amd64) mit Docker und cgroup v2. Der offizielle Piston-Aufbau benötigt einen privilegierten Container; Docker ist hier ausdrücklich vorgesehen und damit eine begründete Ausnahme zur sonst containerfreien Vorgabe dieses Buchs.
  • Sicherheit: Verwende für Piston einen separaten Ausführungsrechner oder eine virtuelle Maschine. Die API wird in dieser Anleitung ausschließlich an 127.0.0.1 (localhost) gebunden, besitzt jedoch keine Authentifizierung – alle lokalen Programme können die API erreichen.
  • Sprachlaufzeiten: Der Piston-Kerncontainer enthält noch keine Compiler oder Interpreter; diese werden nach dem Start über die Paket-API separat installiert.
  • Alternative ohne Docker: Wer Code direkt ohne Docker ausführen möchte, findet in Jobe oder dem eigenen Runner mit bubblewrap und systemd-run native Alternativen.

Installation

1. Paketlisten aktualisieren

Damit apt die aktuellen Versionen aller benötigten Pakete aus den Ubuntu-Quellen kennt.

sudo apt update

2. Docker und Hilfswerkzeuge installieren

Installiert Docker und das Compose-Plugin direkt aus den offiziellen Ubuntu-Paketquellen, ohne fremde Installationsskripte.

sudo apt install docker.io docker-compose-v2 curl ca-certificates

3. Docker starten

Aktiviert den Docker-Dienst sofort und sorgt dafür, dass er auch nach einem Systemneustart automatisch läuft.

sudo systemctl enable --now docker

4. Docker prüfen

Prüft, ob Docker-Client und Docker-Daemon ordnungsgemäß gestartet sind und reagieren.

sudo docker version

5. Compose prüfen

Stellt sicher, dass das Compose-Plugin für Docker funktionsfähig ist.

sudo docker compose version

6. cgroup-Version prüfen

Piston benötigt cgroup v2. Die Ausgabe muss cgroup2fs lauten.

stat -fc %T /sys/fs/cgroup

7. Projektordner anlegen

Erstellt einen eigenen Ordner für die Piston-Konfiguration und die Daten.

mkdir ~/piston-lab

8. In den Projektordner wechseln

Alle weiteren Konfigurationsbefehle beziehen sich auf diesen Ordner.

cd ~/piston-lab

9. Compose-Konfiguration anlegen

Erstellt die Datei compose.yaml. Der Port 2000 wird gezielt nur an 127.0.0.1 gebunden, und ein Docker-Volume speichert die nachinstallierten Sprachpakete dauerhaft.

cat > compose.yaml <<'EOF'
services:
  api:
    image: ghcr.io/engineer-man/piston:latest
    privileged: true
    restart: unless-stopped
    ports:
      - "127.0.0.1:2000:2000"
    volumes:
      - packages:/piston/packages
    tmpfs:
      - /tmp:exec
volumes:
  packages:
EOF

10. Konfiguration testen

Prüft die compose.yaml auf Syntaxfehler, bevor der Dienst gestartet wird.

sudo docker compose config --quiet

11. Image herunterladen

Lädt das offizielle Piston-Container-Image aus der GitHub-Container-Registry herunter.

sudo docker compose pull

12. Image-Digest festhalten

Ermittelt den kryptografischen Prüfwert (Digest) des geladenen Images zur Dokumentation des genauen Softwarestands.

sudo docker image inspect ghcr.io/engineer-man/piston:latest --format '{{index .RepoDigests 0}}'

13. Piston starten

Startet den Piston-Dienst als Hintergrundcontainer.

sudo docker compose up -d

14. Sprachliste abrufen

Fragt die verfügbaren Sprachlaufzeiten ab. Unmittelbar nach dem Start ist diese Liste noch leer.

curl --fail --show-error http://127.0.0.1:2000/api/v2/runtimes

15. Python-Laufzeit installieren

Lädt über die Paket-API von Piston die aktuelle Python-Laufzeitumgebung in das Docker-Volume herunter.

curl --fail --show-error \
  --header 'Content-Type: application/json' \
  --data '{"language":"python","version":"*"}' \
  http://127.0.0.1:2000/api/v2/packages

Prüfung

1. Installierte Laufzeit prüfen

Prüft, ob Python jetzt in der Liste der installierten Laufzeiten aufgeführt wird.

curl --fail --show-error http://127.0.0.1:2000/api/v2/runtimes

2. Eigenen Programmcode ausführen

Sendet ein kleines Python-Skript an die API zur Ausführung in der Sandbox. Erwartet wird der Rückgabecode 0 und die Ausgabe Piston bereit.

curl --fail --show-error \
  --header 'Content-Type: application/json' \
  --data '{"language":"python","version":"*","files":[{"name":"probe.py","content":"print(\"Piston bereit\")"}],"run_timeout":3000,"run_memory_limit":134217728}' \
  http://127.0.0.1:2000/api/v2/execute

3. Zeitbegrenzung testen

Sendet eine Endlosschleife, um zu prüfen, ob Piston die Ausführung nach Ablauf des Zeitlimits zuverlässig abbricht.

curl --fail --show-error \
  --header 'Content-Type: application/json' \
  --data '{"language":"python","version":"*","files":[{"content":"while True: pass"}],"run_timeout":1000,"run_cpu_time":1000}' \
  http://127.0.0.1:2000/api/v2/execute

4. Dienst-Protokolle einsehen

Bei Fehlern lassen sich die Ausgaben des Piston-Containers anzeigen.

sudo docker compose logs --tail=80 api

Deinstallation

1. Container stoppen und entfernen

Beendet den Piston-Dienst im Ordner ~/piston-lab.

cd ~/piston-lab && sudo docker compose down

2. Sprachpakete und Volumes löschen

Entfernt auch das Docker-Volume mit den heruntergeladenen Sprachpaketen.

cd ~/piston-lab && sudo docker compose down --volumes

3. Entfernung prüfen

Stellt sicher, dass keine Piston-Container mehr vorhanden sind.

sudo docker compose ps --all

4. Projektordner löschen

Entfernt den Konfigurationsordner.

rm -rf ~/piston-lab

5. Docker optional deinstallieren

Falls Docker ausschließlich für diesen Test installiert wurde, können die Pakete wieder entfernt werden.

sudo apt purge docker.io docker-compose-v2

Quellen und Lizenz

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.

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.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.