Zum Inhalt springen
Documentation

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.

CHAMPREP verfügt über zwei Befehlszeilenprogramme. Es handelt sich um separate Downloads mit separaten Befehlen:

CHAMPREP Code-RunnerCHAMPREP CLI
Befehlchamprep-code-runnerchamprep
Wer verwendet sieEin Build-Rechner, Server oder eine VMSie an Ihrem Terminal
Was es leistetFührt CI/CD-Jobs für CHAMPREPCode-Pipelines ausArbeitet mit CHAMPREPDiensten, einschließlich Code, über ein Terminal
Installation übercode-downloads.champrep.comcli.champrep.com
DokumenteDieser AbschnittCLI 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.

  1. 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.
  2. Sie installieren champrep-code-runner auf einem Rechner und Registrieren mit dem Authentifizierungstoken des Runners.
  3. Sie run in einem Terminal oder als Dienst, der beim Systemstart gestartet wird.
  4. 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.

ExecutorFührt jeden Auftrag ausVerwenden Sie es für
shellDirekt auf dem Host, als Benutzer des RunnersVertrauenswürdige Projekte, die die Tools des Hosts benötigen
dockerIn einem neuen Container, der auf dem Image des Jobs basiertIsolierte, reproduzierbare Builds
kubernetesIn einem Pod in Ihrem ClusterSkalierung 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.

  1. Installieren Sie den Runner.
  2. Registrieren Sie es mit einem Runner-Token.
  3. Starten Sie ihn und halten Sie ihn mit dem Runner-Befehle.

Sollte etwas nicht funktionieren, lesen Sie bitte Fehlerbehebung.