Aller au contenu
Documentation

Installez le Runner

Le Runner est un binaire unique pour macOS, Linux et Windows sur les architectures amd64 et arm64. Les versions sont publiées sur code-downloads.champrep.com.

  • macOS 12 ou version ultérieure, Linux, ou Windows 10, 11 ou Server 2019 ou version ultérieure.
  • Git 2.24 ou version ultérieure sur PATH. Sous Windows, Git pour Windows.
  • Connexion HTTPS sortante vers code.champrep.com.
  • Pour l’exécuteur Docker : Docker Engine 25 ou version ultérieure exécutant des conteneurs Linux.
  • Pour l’exécuteur Kubernetes : accédez au cluster dans lequel les tâches s’exécutent.

Fenêtre de terminal
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | sh

Le programme d’installation détecte votre système d’exploitation et votre architecture, télécharge la dernière version, la vérifie par rapport à la version SHA256SUMS, puis installe le logiciel dans /usr/local/bin (le programme vous demandera sudo si nécessaire). Sans droit d’écriture et sans sudo, il s’installe dans ~/.local/bin.

Vérifiez l’installation :

Fenêtre de terminal
champrep-code-runner version

Dans PowerShell :

Fenêtre de terminal
irm https://code-downloads.champrep.com/install/runner.ps1 | iex

Le programme d’installation vérifie la somme de contrôle et procède à l’installation dans %LOCALAPPDATA%\CHAMPREP\bin. Pour exécuter le runner en tant que service Windows, copiez d’abord le fichier binaire vers un emplacement stable, par exemple C:\Program Files\CHAMPREP\champrep-code-runner.exe.

Les nouvelles installations utilisent la dernière version disponible. Pour installer une version précise, configurez CHPCODE_RUNNER_VERSION pour le programme d’installation :

Fenêtre de terminal
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | CHPCODE_RUNNER_VERSION=0.1.1 sh
Fenêtre de terminal
$env:CHPCODE_RUNNER_VERSION = '0.1.1'; irm https://code-downloads.champrep.com/install/runner.ps1 | iex

Définissez la variable sur sh, après la barre verticale, et non sur curl. Chaque version reste disponible : releases.json les répertorie toutes, en commençant par les plus récentes.

Pour installer le logiciel à un autre emplacement, configurez CHPCODE_INSTALL_DIR de la même manière.

Chaque version comporte un dossier contenant un exécutable par plateforme et un SHA256SUMS fichier :

https://code-downloads.champrep.com/releases/<version>/runner/champrep-code-runner-<os>-<arch>
https://code-downloads.champrep.com/releases/<version>/runner/SHA256SUMS

<os> est darwin, linux ou windows (les fichiers Windows se terminent par .exe), et <arch> est amd64 ou arm64. Vérifiez le fichier téléchargé avant de l’exécuter :

Fenêtre de terminal
shasum -a 256 -c SHA256SUMS --ignore-missing

Les « runners » que vous avez déjà lancés continuent de fonctionner lorsqu’une nouvelle version est disponible ; vous pouvez donc effectuer la mise à niveau au moment qui vous convient :

  1. Arrêtez le programme d’exécution. Attendez que les tâches en cours s’achèvent : champrep-code-runner service stop (ou Ctrl+C dans un terminal).
  2. Relancez le programme d’installation, éventuellement avec CHPCODE_RUNNER_VERSION.
  3. Lancez-le : champrep-code-runner service start (ou champrep-code-runner run).

Votre inscription et votre configuration sont conservées. Pour revenir à une version antérieure, installez-la de la même manière.

Fenêtre de terminal
champrep-code-runner service uninstall # if you installed the service
champrep-code-runner unregister --all # remove this machine's runners
sudo rm /usr/local/bin/champrep-code-runner

Supprimez ensuite le runner dans CodeCHAMPREP (Paramètres > CI/CD > Exécuteurs) pour révoquer son jeton.