Zum Inhalt springen
Documentation

Registrieren Sie einen Runner

Durch die Registrierung wird ein Rechner mit einem Runner verbunden, den Sie in CHAMPREPCode erstellt haben. Sie benötigen den Runner- Authentifizierungstoken, das mit ccrt_.

  1. Öffnen Sie Ihr Projekt (oder Ihre Gruppe) und gehen Sie zu Einstellungen > CI/CD > Runner.
  2. Auswählen Neuer Runner.
  3. Wählen Sie aus, welche Jobs angenommen werden sollen:
    • Tags: Jobs mit tags: Nur auf Runners ausführen, die über alle diese Optionen verfügen.
    • Unmarkierte Jobs ausführen: Gibt an, ob auch Jobs ohne Tags angenommen werden.
    • Geschützt: Führen Sie nur Jobs von geschützten Branches und Tags aus.
  4. Auswählen Runner erstellen und kopieren Sie das Token. Es wird nur einmal angezeigt.

Behandeln Sie das Token wie ein Passwort. Jeder, der es besitzt, kann Ihre Jobs übernehmen.

Der einfachste Weg, in einem Terminal auf dem Rechner:

Terminal-Fenster
champrep-code-runner register --url https://code.champrep.com

Der Runner fragt nach dem Token (ohne es anzuzeigen) und nach dem Executor. Er überprüft das Token und speichert den Runner anschließend in seiner Konfigurationsdatei.

Um dies zu skripten, übergeben Sie das Token über die Standardeingabe oder aus einer Datei, damit es niemals in Ihrem Shell-Verlauf oder in der Prozessliste erscheint:

Terminal-Fenster
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \
--url https://code.champrep.com --token-stdin \
--name build-01 --executor shell
Terminal-Fenster
champrep-code-runner register --url https://code.champrep.com \
--token-file /root/runner-token --executor docker --docker-image alpine:3.24

Unter Windows über eine PowerShell-Eingabeaufforderung mit erhöhten Rechten:

Terminal-Fenster
$env:RUNNER_TOKEN | champrep-code-runner.exe register `
--url https://code.champrep.com --token-stdin --name win-build-01 `
--executor shell --shell pwsh

OptionBedeutung
--urlIhre CHAMPREPCode-Adresse, zum Beispiel https://code.champrep.com.
--token-stdin / --token-file PATHLesen Sie das Token aus der Standardeingabe oder aus einer Datei ein.
--name NAMEDer Name des Runners auf diesem Rechner (Standard: der Hostname).
--executorshell, docker oder kubernetes.
--shellFür den Shell-Executor: bash, sh, pwsh oder powershell.
--docker-image IMAGEStandard-Job-Image für die Docker- und Kubernetes-Executoren.
--kubernetes-namespace NSFühren Sie Kubernetes-Jobs in diesem Namespace aus.
--limit NMaximal N Jobs gleichzeitig für diesen Runner.
--non-interactiveNiemals nachfragen; bei fehlendem Wert als Fehler auswerten.
--config PATHVerwenden Sie diese Konfigurationsdatei (siehe unten).

CHPCODE_RUNNER_URL und CHPCODE_RUNNER_TOKEN kann ersetzt werden --url und die Token-Optionen.

Wenn Sie ihn alsDatei
root (Linux, macOS)/etc/champrep-runner/config.toml
Eine Eingabeaufforderung mit erhöhten Rechten oder der Dienst (Windows)%ProgramData%\champrep-runner\config.toml
Jeder andere Benutzer~/.champrep-runner/config.toml

CHPCODE_RUNNER_CONFIG oder --config Wählen Sie eine andere Datei aus. Die Datei ist nur für ihren Eigentümer lesbar. Ein Rechner kann mehrere Runner hosten: Registrieren Sie sich erneut mit einem anderen --name.

Terminal-Fenster
champrep-code-runner run # in this terminal
champrep-code-runner service install # or as a service that starts at boot

Siehe Runner-Befehle , um seinen Status zu überprüfen, ihn anzuhalten und vieles mehr.