Zum Inhalt springen
Documentation

Installieren Sie den Runner

Der Runner ist eine einzige Binärdatei für macOS, Linux und Windows auf amd64 und arm64. Veröffentlichungen finden Sie unter code-downloads.champrep.com.

  • macOS 12 oder höher, Linux oder Windows 10, 11 oder Server 2019 oder höher.
  • Git 2.24 oder höher auf PATH. Unter Windows: Git für Windows.
  • Ausgehende HTTPS-Verbindung zu code.champrep.com.
  • Für den Docker-Executor: Docker Engine 25 oder höher, auf der Linux-Container ausgeführt werden.
  • Für den Kubernetes-Executor: Zugriff auf den Cluster, in dem die Jobs ausgeführt werden.

Terminal-Fenster
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | sh

Das Installationsprogramm erkennt Ihr Betriebssystem und Ihre Architektur, lädt die neueste Version herunter und gleicht sie mit der Release-Datei ab SHA256SUMS, und installiert es in /usr/local/bin (Sie werden gefragt, ob sudo bei Bedarf). Ohne Schreibzugriff und ohne sudo, die Installation erfolgt unter ~/.local/bin.

Überprüfen Sie die Installation:

Terminal-Fenster
champrep-code-runner version

In PowerShell:

Terminal-Fenster
irm https://code-downloads.champrep.com/install/runner.ps1 | iex

Das Installationsprogramm überprüft die Prüfsumme und führt die Installation unter %LOCALAPPDATA%\CHAMPREP\bin. Um den Runner als Windows-Dienst auszuführen, kopieren Sie die Binärdatei zunächst an einen festen Speicherort, zum Beispiel C:\Program Files\CHAMPREP\champrep-code-runner.exe.

Bei Neuinstallationen wird die aktuellste Version verwendet. Um eine bestimmte Version zu installieren, legen Sie CHPCODE_RUNNER_VERSION für das Installationsprogramm:

Terminal-Fenster
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | CHPCODE_RUNNER_VERSION=0.1.1 sh
Terminal-Fenster
$env:CHPCODE_RUNNER_VERSION = '0.1.1'; irm https://code-downloads.champrep.com/install/runner.ps1 | iex

Setzen Sie die Variable auf sh, nach dem Pipe-Zeichen, nicht auf curl. Jede Version bleibt verfügbar: releases.json listet alle Versionen auf, beginnend mit der neuesten.

Um das Programm an einem anderen Ort zu installieren, nehmen Sie folgende Einstellungen vor: CHPCODE_INSTALL_DIR auf dieselbe Weise.

Jede Version enthält einen Ordner mit einer ausführbaren Datei pro Plattform und einer SHA256SUMS Datei:

https://code-downloads.champrep.com/releases/<version>/runner/champrep-code-runner-<os>-<arch>
https://code-downloads.champrep.com/releases/<version>/runner/SHA256SUMS

<os> ist darwin, linux oder windows (Windows-Dateien enden auf .exe), und <arch> ist amd64 oder arm64. Überprüfen Sie die heruntergeladene Datei, bevor Sie sie ausführen:

Terminal-Fenster
shasum -a 256 -c SHA256SUMS --ignore-missing

Bereits ausgeführte Runner funktionieren auch nach der Veröffentlichung einer neuen Version weiter, sodass Sie das Upgrade durchführen können, wann es Ihnen passt:

  1. Beenden Sie den Runner. Laufende Jobs werden zunächst beendet: champrep-code-runner service stop (oder Strg+C im Terminal).
  2. Führen Sie das Installationsprogramm erneut aus, optional mit CHPCODE_RUNNER_VERSION.
  3. Starten Sie das Programm: champrep-code-runner service start (oder champrep-code-runner run).

Ihre Registrierung und Konfiguration bleiben erhalten. Um zu einer früheren Version zurückzukehren, installieren Sie diese auf dieselbe Weise.

Terminal-Fenster
champrep-code-runner service uninstall # if you installed the service
champrep-code-runner unregister --all # remove this machine's runners
sudo rm /usr/local/bin/champrep-code-runner

Löschen Sie anschließend den Runner in CodeCHAMPREP (Einstellungen > CI/CD > Runner), um sein Token zu widerrufen.