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. Erstellen Sie den Runner in CodeCHAMPREP
Abschnitt betitelt „1. Erstellen Sie den Runner in CodeCHAMPREP“- Öffnen Sie Ihr Projekt (oder Ihre Gruppe) und gehen Sie zu Einstellungen > CI/CD > Runner.
- Auswählen Neuer Runner.
- 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.
- Tags: Jobs mit
- 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.
2. Registrieren Sie den Rechner
Abschnitt betitelt „2. Registrieren Sie den Rechner“Der einfachste Weg, in einem Terminal auf dem Rechner:
champrep-code-runner register --url https://code.champrep.comDer 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:
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \ --url https://code.champrep.com --token-stdin \ --name build-01 --executor shellchamprep-code-runner register --url https://code.champrep.com \ --token-file /root/runner-token --executor docker --docker-image alpine:3.24Unter Windows über eine PowerShell-Eingabeaufforderung mit erhöhten Rechten:
$env:RUNNER_TOKEN | champrep-code-runner.exe register ` --url https://code.champrep.com --token-stdin --name win-build-01 ` --executor shell --shell pwsh
Allgemeine Optionen
Abschnitt betitelt „Allgemeine Optionen“| Option | Bedeutung |
|---|---|
--url | Ihre CHAMPREPCode-Adresse, zum Beispiel https://code.champrep.com. |
--token-stdin / --token-file PATH | Lesen Sie das Token aus der Standardeingabe oder aus einer Datei ein. |
--name NAME | Der Name des Runners auf diesem Rechner (Standard: der Hostname). |
--executor | shell, docker oder kubernetes. |
--shell | Für den Shell-Executor: bash, sh, pwsh oder powershell. |
--docker-image IMAGE | Standard-Job-Image für die Docker- und Kubernetes-Executoren. |
--kubernetes-namespace NS | Führen Sie Kubernetes-Jobs in diesem Namespace aus. |
--limit N | Maximal N Jobs gleichzeitig für diesen Runner. |
--non-interactive | Niemals nachfragen; bei fehlendem Wert als Fehler auswerten. |
--config PATH | Verwenden Sie diese Konfigurationsdatei (siehe unten). |
CHPCODE_RUNNER_URL und CHPCODE_RUNNER_TOKEN kann ersetzt werden --url und die Token-Optionen.
Wo die Konfiguration gespeichert ist
Abschnitt betitelt „Wo die Konfiguration gespeichert ist“| Wenn Sie ihn als | Datei |
|---|---|
| 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.
3. Starten Sie ihn
Abschnitt betitelt „3. Starten Sie ihn“champrep-code-runner run # in this terminalchamprep-code-runner service install # or as a service that starts at bootSiehe Runner-Befehle , um seinen Status zu überprüfen, ihn anzuhalten und vieles mehr.