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.
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- 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.
macOS und Linux
Abschnitt betitelt „macOS und Linux“curl -fsSL https://code-downloads.champrep.com/install/runner.sh | shDas 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:
champrep-code-runner versionWindows
Abschnitt betitelt „Windows“In PowerShell:
irm https://code-downloads.champrep.com/install/runner.ps1 | iexDas 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.
Eine bestimmte Version installieren
Abschnitt betitelt „Eine bestimmte Version installieren“Bei Neuinstallationen wird die aktuellste Version verwendet. Um eine bestimmte Version zu installieren, legen Sie
CHPCODE_RUNNER_VERSION für das Installationsprogramm:
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | CHPCODE_RUNNER_VERSION=0.1.1 sh$env:CHPCODE_RUNNER_VERSION = '0.1.1'; irm https://code-downloads.champrep.com/install/runner.ps1 | iexSetzen 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.
Manuell herunterladen
Abschnitt betitelt „Manuell herunterladen“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:
shasum -a 256 -c SHA256SUMS --ignore-missingUpgrade
Abschnitt betitelt „Upgrade“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:
- Beenden Sie den Runner. Laufende Jobs werden zunächst beendet:
champrep-code-runner service stop(oder Strg+C im Terminal). - Führen Sie das Installationsprogramm erneut aus, optional mit
CHPCODE_RUNNER_VERSION. - Starten Sie das Programm:
champrep-code-runner service start(oderchamprep-code-runner run).
Ihre Registrierung und Konfiguration bleiben erhalten. Um zu einer früheren Version zurückzukehren, installieren Sie diese auf dieselbe Weise.
Deinstallation
Abschnitt betitelt „Deinstallation“champrep-code-runner service uninstall # if you installed the servicechamprep-code-runner unregister --all # remove this machine's runnerssudo rm /usr/local/bin/champrep-code-runnerLöschen Sie anschließend den Runner in CodeCHAMPREP (Einstellungen > CI/CD > Runner), um sein Token zu widerrufen.