Ir al contenido
Documentation

Instale el «runner»

El «runner» es un único binario para macOS, Linux y Windows en arquitecturas amd64 y arm64. Las versiones se publican en code-downloads.champrep.com.

  • macOS 12 o posterior, Linux, o Windows 10, 11 o Server 2019 o posterior.
  • Git 2.24 o posterior en PATH. En Windows, Git para Windows.
  • Conexión HTTPS saliente a code.champrep.com.
  • Para el ejecutor de Docker: Docker Engine 25 o posterior que ejecute contenedores Linux.
  • Para el ejecutor de Kubernetes: acceda al clúster en el que se ejecutan los trabajos.

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

El instalador detecta su sistema operativo y su arquitectura, descarga la última versión y la compara con el archivo de la versión SHA256SUMS, e instálelo en /usr/local/bin (le pedirá sudo cuando sea necesario). Sin acceso de escritura y sin sudo, se instala en ~/.local/bin.

Compruebe la instalación:

Ventana de terminal
champrep-code-runner version

En PowerShell:

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

El instalador comprueba la suma de comprobación e instala en %LOCALAPPDATA%\CHAMPREP\bin. Para ejecutar el «runner» como servicio de Windows, copie primero el archivo binario en una ubicación estable, por ejemplo C:\Program Files\CHAMPREP\champrep-code-runner.exe.

Las nuevas instalaciones obtienen la última versión. Para instalar una versión concreta, configure CHPCODE_RUNNER_VERSION para el instalador:

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

Configure la variable en sh, después de la barra vertical, no en curl. Cada versión permanece disponible: releases.json muestra una lista de todas ellas, ordenadas de más reciente a más antigua.

Para instalar en otra ubicación, configure CHPCODE_INSTALL_DIR de la misma manera.

Cada versión cuenta con una carpeta que contiene un archivo binario por plataforma y un SHA256SUMS archivo:

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

<os> es darwin, linux o windows (los archivos de Windows terminan en .exe), y <arch> es amd64 o arm64. Compruebe la descarga antes de ejecutarla:

Ventana de terminal
shasum -a 256 -c SHA256SUMS --ignore-missing

Los ejecutores que ya tenga en marcha seguirán funcionando cuando se publique una nueva versión, por lo que puede actualizar cuando le resulte más conveniente:

  1. Detenga el ejecutor. Deje que los trabajos en curso finalicen primero: champrep-code-runner service stop (o Ctrl+C en una terminal).
  2. Ejecute de nuevo el instalador, opcionalmente con CHPCODE_RUNNER_VERSION.
  3. Inícielo: champrep-code-runner service start (o champrep-code-runner run).

Se conservarán su registro y su configuración. Para volver a una versión anterior, instálela de la misma manera.

Ventana 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

A continuación, elimine el ejecutor en CodeCHAMPREP (Configuración > CI/CD > Ejecutores) para revocar su token.