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.
Runner ou CLI?
Section intitulée « Runner ou CLI? »CHAMPREP comporte deux programmes en ligne de commande. Il s’agit de téléchargements distincts avec des commandes distinctes :
| CHAMPREP Code Runner | CHAMPREP CLI | |
|---|---|---|
| Commande | champrep-code-runner | champrep |
| Qui l’utilise | Une machine de build, un serveur ou une machine virtuelle | Vous, sur votre terminal |
| Fonctionnalités | Exécute les tâches CI/CD pour les pipelines CodeCHAMPREP | Fonctionne avec les servicesCHAMPREP, y compris Code, depuis un terminal |
| Installation à partir de | code-downloads.champrep.com | cli.champrep.com |
| Docs | Cette section | CLI 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.
Fonctionnement
Section intitulée « Fonctionnement »- 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.
- Vous installez
champrep-code-runnersur une machine et register avec le jeton d’authentification du runner. - Vous run , dans un terminal ou sous forme de service démarrant au démarrage du système.
- 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écuteurs
Section intitulée « Exécuteurs »| Exécuteur | Exécute chaque tâche | Utilisez-le pour |
|---|---|---|
shell | Directement sur l’hôte, en tant qu’utilisateur du Runner | Projets de confiance nécessitant les outils de l’hôte |
docker | Dans un conteneur vierge issu de l’image de la tâche | Compilations isolées et reproductibles |
kubernetes | Dans un pod de votre cluster | Mise à 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.
Pour commencer
Section intitulée « Pour commencer »- Installez le Runner.
- Enregistrez-le avec un jeton de Runner.
- 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.