CHAMPREP Code Runner
Der CHAMPREPCode-Runner (champrep-code-runner) ist ein kleines Programm, das Sie auf einem Rechner installieren, den Sie kontrollieren. Es stellt eine Verbindung zu CHAMPREPCode her, ruft die CI/CD-Jobs Ihrer Pipelines ab, führt sie aus und sendet das Protokoll, den Status sowie etwaige Artefakte zurück. Ihr Code und Ihre Build-Tools verbleiben auf Ihrem Rechner.
Runner oder CLI?
Abschnitt betitelt „Runner oder CLI?“CHAMPREP verfügt über zwei Befehlszeilenprogramme. Es handelt sich um separate Downloads mit separaten Befehlen:
| CHAMPREP Code-Runner | CHAMPREP CLI | |
|---|---|---|
| Befehl | champrep-code-runner | champrep |
| Wer verwendet sie | Ein Build-Rechner, Server oder eine VM | Sie an Ihrem Terminal |
| Was es leistet | Führt CI/CD-Jobs für CHAMPREPCode-Pipelines aus | Arbeitet mit CHAMPREPDiensten, einschließlich Code, über ein Terminal |
| Installation über | code-downloads.champrep.com | cli.champrep.com |
| Dokumente | Dieser Abschnitt | CLI Referenz |
Wenn Sie möchten, dass Pipelines auf Ihren eigenen Rechnern ausgeführt werden, benötigen Sie den Runner. Wenn Sie überCHAMPREP ein Terminal arbeiten möchten, benötigen Sie die CLICLI. Viele Teams nutzen beides.
So funktioniert es
Abschnitt betitelt „So funktioniert es“- Sie erstellen einen Runner in CodeCHAMPREP (einen Projekt-, Gruppen- oder Instanz-Runner) und legen fest, welche Jobs er ausführt: seine Tags, ob er nicht getaggte Jobs ausführt und ob er nur geschützte Branches und Tags ausführt.
- Sie installieren
champrep-code-runnerauf einem Rechner und Registrieren mit dem Authentifizierungstoken des Runners. - Sie run in einem Terminal oder als Dienst, der beim Systemstart gestartet wird.
- Der Runner fragt bei CodeCHAMPREP über ausgehendes HTTPS nach Aufträgen und führt jeden einzelnen mit seiner executor (Shell, Docker oder Kubernetes) und übermittelt die Ergebnisse zurück.
Der Runner stellt ausschließlich ausgehende Verbindungen her. Sie müssen keinen eingehenden Port öffnen.
Executoren
Abschnitt betitelt „Executoren“| Executor | Führt jeden Auftrag aus | Verwenden Sie es für |
|---|---|---|
shell | Direkt auf dem Host, als Benutzer des Runners | Vertrauenswürdige Projekte, die die Tools des Hosts benötigen |
docker | In einem neuen Container, der auf dem Image des Jobs basiert | Isolierte, reproduzierbare Builds |
kubernetes | In einem Pod in Ihrem Cluster | Skalierung von Builds auf einem bereits von Ihnen betriebenen Cluster |
Der Shell-Executor verfügt über keine Isolierung zwischen Jobs und dem Host. Verwenden Sie ihn daher nur für Projekte, denen Sie vertrauen.
Erste Schritte
Abschnitt betitelt „Erste Schritte“- Installieren Sie den Runner.
- Registrieren Sie es mit einem Runner-Token.
- Starten Sie ihn und halten Sie ihn mit dem Runner-Befehle.
Sollte etwas nicht funktionieren, lesen Sie bitte Fehlerbehebung.