Ir al contenido
Documentation

Registrar un «Runner»

El registro conecta una máquina a un ejecutor que haya creado en CodeCHAMPREP. Necesita el token de autenticación, que comienza por ccrt_.

  1. Abra su proyecto (o grupo) y vaya a Configuración > CI/CD > Ejecutores.
  2. Seleccionar Nuevo ejecutor.
  3. Seleccione qué trabajos acepta:
    • Etiquetas: trabajos con tags: Ejecutar únicamente en ejecutores que cumplan todos estos requisitos.
    • Ejecutar trabajos sin etiqueta: si también acepta trabajos sin etiquetas.
    • Protegido: ejecutar únicamente trabajos de ramas y etiquetas protegidas.
  4. Seleccionar Crear ejecutor y copie el token. Solo se muestra una vez.

Trate el token como si fuera una contraseña. Cualquier persona que lo tenga podrá hacerse cargo de sus trabajos.

La forma más sencilla, en un terminal de la máquina:

Ventana de terminal
champrep-code-runner register --url https://code.champrep.com

El ejecutor solicita el token (sin mostrarlo) y el ejecutor. Comprueba el token y, a continuación, guarda el ejecutor en su archivo de configuración.

Para automatizarlo mediante un script, pase el token a través de la entrada estándar o desde un archivo, de modo que nunca aparezca en el historial de su shell ni en la lista de procesos:

Ventana de terminal
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \
--url https://code.champrep.com --token-stdin \
--name build-01 --executor shell
Ventana de terminal
champrep-code-runner register --url https://code.champrep.com \
--token-file /root/runner-token --executor docker --docker-image alpine:3.24

En Windows, desde una línea de comandos de PowerShell con privilegios elevados:

Ventana de terminal
$env:RUNNER_TOKEN | champrep-code-runner.exe register `
--url https://code.champrep.com --token-stdin --name win-build-01 `
--executor shell --shell pwsh

OpciónSignificado
--urlSu dirección de CodeCHAMPREP, por ejemplo https://code.champrep.com.
--token-stdin / --token-file PATHLeer el token desde la entrada estándar o desde un archivo.
--name NAMEEl nombre del ejecutor en esta máquina (por defecto: el nombre del host).
--executorshell, docker o kubernetes.
--shellPara el ejecutor de shell: bash, sh, pwsh o powershell.
--docker-image IMAGEImagen de trabajo predeterminada para los ejecutores de Docker y Kubernetes.
--kubernetes-namespace NSEjecutar trabajos de Kubernetes en este espacio de nombres.
--limit NUn máximo de N trabajos a la vez para este ejecutor.
--non-interactiveNo solicitar nunca confirmación; dar error si falta un valor.
--config PATHUtilice este archivo de configuración (véase más abajo).

CHPCODE_RUNNER_URL y CHPCODE_RUNNER_TOKEN puede sustituir --url y las opciones de token.

Cuando lo ejecuta comoArchivo
root (Linux, macOS)/etc/champrep-runner/config.toml
Un símbolo del sistema con privilegios elevados o el servicio (Windows)%ProgramData%\champrep-runner\config.toml
Cualquier otro usuario~/.champrep-runner/config.toml

CHPCODE_RUNNER_CONFIG o --config Elija otro archivo. El archivo se ha creado con acceso de solo lectura para su propietario. Una máquina puede albergar varios ejecutores: regístrese de nuevo con un --name.

Ventana de terminal
champrep-code-runner run # in this terminal
champrep-code-runner service install # or as a service that starts at boot

Véase Comandos del «runner» para comprobar su estado, detenerlo y otras acciones.