Aller au contenu
Documentation

CHAMPREP Code Runner

Le CodeCHAMPREP Runner (champrep-code-runner) est un petit programme que vous installez sur une machine que vous contrôlez. Il se connecte à CodeCHAMPREP, récupère les tâches CI/CD de vos pipelines, les exécute, puis renvoie le journal, le statut et les éventuels artefacts. Votre code et vos outils de compilation restent sur votre machine.

CHAMPREP comporte deux programmes en ligne de commande. Il s’agit de téléchargements distincts avec des commandes distinctes :

CHAMPREP Code RunnerCHAMPREP CLI
Commandechamprep-code-runnerchamprep
Qui l’utiliseUne machine de build, un serveur ou une machine virtuelleVous, sur votre terminal
FonctionnalitésExécute les tâches CI/CD pour les pipelines CodeCHAMPREPFonctionne avec les servicesCHAMPREP, y compris Code, depuis un terminal
Installation à partir decode-downloads.champrep.comcli.champrep.com
DocsCette sectionCLI Référence

Si vous souhaitez que les pipelines s’exécutent sur vos propres machines, vous avez besoin du Runner. Si vous souhaitez travailler CHAMPREPvia un terminal, vous avez besoin de la CLICLI. De nombreuses équipes utilisent les deux.

  1. Vous créez un « runner » dans CodeCHAMPREP (un « runner » de projet, de groupe ou d’instance) et choisissez les tâches qu’il doit traiter : ses balises, s’il exécute les tâches non balisées, et s’il n’exécute que les branches et balises protégées.
  2. Vous installez champrep-code-runner sur une machine et register avec le jeton d’authentification du runner.
  3. Vous run , dans un terminal ou sous forme de service démarrant au démarrage du système.
  4. Le runner interroge CHAMPREPCode pour obtenir des tâches via une connexion HTTPS sortante, puis exécute chacune d’entre elles avec ses executor (shell, Docker ou Kubernetes), puis renvoie un rapport.

Le runner établit uniquement des connexions sortantes. Vous n’avez pas besoin d’ouvrir de port entrant.

ExécuteurExécute chaque tâcheUtilisez-le pour
shellDirectement sur l’hôte, en tant qu’utilisateur du RunnerProjets de confiance nécessitant les outils de l’hôte
dockerDans un conteneur vierge issu de l’image de la tâcheCompilations isolées et reproductibles
kubernetesDans un pod de votre clusterMise à l’échelle des builds sur un cluster que vous exploitez déjà

L’exécuteur de shell ne dispose d’aucune isolation entre les tâches et l’hôte. Utilisez-le uniquement pour les projets auxquels vous faites confiance.

  1. Installez le Runner.
  2. Enregistrez-le avec un jeton de Runner.
  3. Lancez-le et maintenez-le en cours d’exécution à l’aide de la commande Commandes du Runner.

Si quelque chose ne fonctionne pas, consultez Dépannage.