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. Cree el ejecutor en CodeCHAMPREP
Sección titulada «1. Cree el ejecutor en CodeCHAMPREP»- Abra su proyecto (o grupo) y vaya a Configuración > CI/CD > Ejecutores.
- Seleccionar Nuevo ejecutor.
- 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.
- Etiquetas: trabajos con
- 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.
2. Registrar la máquina
Sección titulada «2. Registrar la máquina»La forma más sencilla, en un terminal de la máquina:
champrep-code-runner register --url https://code.champrep.comEl 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:
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \ --url https://code.champrep.com --token-stdin \ --name build-01 --executor shellchamprep-code-runner register --url https://code.champrep.com \ --token-file /root/runner-token --executor docker --docker-image alpine:3.24En Windows, desde una línea de comandos de PowerShell con privilegios elevados:
$env:RUNNER_TOKEN | champrep-code-runner.exe register ` --url https://code.champrep.com --token-stdin --name win-build-01 ` --executor shell --shell pwsh
Opciones comunes
Sección titulada «Opciones comunes»| Opción | Significado |
|---|---|
--url | Su dirección de CodeCHAMPREP, por ejemplo https://code.champrep.com. |
--token-stdin / --token-file PATH | Leer el token desde la entrada estándar o desde un archivo. |
--name NAME | El nombre del ejecutor en esta máquina (por defecto: el nombre del host). |
--executor | shell, docker o kubernetes. |
--shell | Para el ejecutor de shell: bash, sh, pwsh o powershell. |
--docker-image IMAGE | Imagen de trabajo predeterminada para los ejecutores de Docker y Kubernetes. |
--kubernetes-namespace NS | Ejecutar trabajos de Kubernetes en este espacio de nombres. |
--limit N | Un máximo de N trabajos a la vez para este ejecutor. |
--non-interactive | No solicitar nunca confirmación; dar error si falta un valor. |
--config PATH | Utilice 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.
Dónde se guarda la configuración
Sección titulada «Dónde se guarda la configuración»| Cuando lo ejecuta como | Archivo |
|---|---|
| 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.
3. Póngalo en marcha
Sección titulada «3. Póngalo en marcha»champrep-code-runner run # in this terminalchamprep-code-runner service install # or as a service that starts at bootVéase Comandos del «runner» para comprobar su estado, detenerlo y otras acciones.