Comandos de Runner
Cada comando es champrep-code-runner <command>. Añada -h a cualquier comando para ver sus opciones; por ejemplo: champrep-code-runner service -h.
Comandos cotidianos
Sección titulada «Comandos cotidianos»| Tarea | Comando |
|---|---|
| Conecte este equipo a un ejecutor | champrep-code-runner register --url https://code.champrep.com |
| Ejecute en esta terminal | champrep-code-runner run |
| Instálelo como servicio e inícielo | champrep-code-runner service install |
| ¿Se está ejecutando? | champrep-code-runner service status |
| Deténgalo (las tareas en ejecución finalizarán primero) | champrep-code-runner service stop |
| Inícielo de nuevo | champrep-code-runner service start |
| Compruebe el token del ejecutor | champrep-code-runner verify |
| Mostrar la versión instalada | champrep-code-runner version |
| Compruebe el archivo de configuración | champrep-code-runner check-config |
Ejecutar en una terminal
Sección titulada «Ejecutar en una terminal»champrep-code-runner runEl ejecutor sigue funcionando y recoge trabajos hasta que usted lo detenga. Pulse Ctrl+C Pulse una vez para detenerlo una vez finalizadas las tareas en ejecución; púlselo de nuevo para interrumpirlas.
Ejecutar como servicio
Sección titulada «Ejecutar como servicio»Un servicio inicia el ejecutor al arrancar el sistema y lo reinicia tras un fallo. Registre primero el equipo: service install Rechaza una configuración que no incluya ejecutores.
sudo champrep-code-runner service install # install, enable at boot and startchamprep-code-runner service status # running, stopped or not installedsudo champrep-code-runner service stop # running jobs finish firstsudo champrep-code-runner service startsudo champrep-code-runner service uninstall # stop and remove the serviceservice status imprime running, stopped o not installed. Se cierra con el código 3 cuando el servicio no está en ejecución, por lo que los scripts pueden comprobarlo.
| Opción | Significado |
|---|---|
--config PATH | La configuración que utiliza el servicio. |
--name NAME | El nombre del servicio. Utilice nombres diferentes para ejecutar varios «runners» con configuraciones distintas en una misma máquina. |
--user USER | Ejecute el servicio como este usuario en lugar de como root o LocalSystem. |
Como usuario root, el ejecutor instala un servicio de systemd denominado champrep-code-runner. Como otro usuario, instala un servicio de usuario, que se ejecuta mientras esté conectado (utilice loginctl enable-linger para mantenerlo en ejecución). También puede utilizar systemd directamente:
systemctl status champrep-code-runnerjournalctl -u champrep-code-runner -f # follow the logsEn el caso del ejecutor de Docker, el usuario del servicio necesita acceso al socket de Docker, lo que equivale a tener privilegios de root en esa máquina. Utilice una máquina dedicada a la compilación.
Como usuario root, el ejecutor instala un LaunchDaemon (com.champrep.code-runner) que se inicia al arrancar el sistema. Como otro usuario, instala un LaunchAgent que se ejecuta mientras está conectado, lo que resulta adecuado para tareas que requieren el llavero, el simulador o la firma de código. Registros:
tail -f /Library/Logs/champrep-code-runner.log # LaunchDaemontail -f ~/Library/Logs/champrep-code-runner.log # LaunchAgentWindows
Sección titulada «Windows»Desde una línea de comandos de PowerShell con privilegios elevados:
champrep-code-runner.exe service installGet-Service champrep-code-runnerEl servicio ejecuta el binario desde su ubicación actual, por lo que debe copiarlo primero en una ubicación estable . Los registros se guardan en champrep-code-runner.log junto a la configuración (%ProgramData%\champrep-runner\).
Todos los comandos
Sección titulada «Todos los comandos»| Comando | Qué hace |
|---|---|
register | Compruebe un token de «runner» y añada el «runner» a la configuración. |
verify [--name N] | Comprueba los tokens de los ejecutores configurados; sale con el código de salida 1 si alguno no es válido. |
run | Ejecútelo hasta que se detenga. --log-file PATH escribe los registros en un archivo. |
run-single [--name N] [--max-jobs 1] | Ejecute los trabajos de un «runner» y, a continuación, salga. Resulta útil para máquinas de corta duración. |
service install|start|stop|status|uninstall | Gestione el «runner» como un servicio. |
reset-token [--name N] | Obtenga un nuevo token y guárdelo. El token antiguo seguirá funcionando durante un breve periodo de gracia. |
unregister --name N o --all | Elimine el «runner» de esta máquina de la configuración y de CodeCHAMPREP. |
check-config | Valida el archivo de configuración y muestra advertencias. |
version | Muestre la versión, la revisión y la plataforma. |
Cada comando admite --config PATH para utilizar otro archivo de configuración.
Comprobaciones de estado y métricas
Sección titulada «Comprobaciones de estado y métricas»Inicie el «runner» con una dirección de escucha para exponer los puntos finales de estado y métricas:
champrep-code-runner run --listen-address 127.0.0.1:9252| Ruta | Significado |
|---|---|
/healthz | 200 mientras se ejecuta el proceso. |
/readyz | 200 cuando todos los ejecutores están verificados y solicitan trabajos. |
/metrics | Métricas de Prometheus: trabajos en ejecución, finalizados y fallidos, entre otros. |
Los registros están estructurados en JSON y nunca contienen tokens, variables ni resultados de los trabajos.