Nota: Debes agregar un ejecutor a GitHub antes de que puedas configurar la aplicación del ejecutor auto-hospedado como servicio. Para obtener más información, vea «Agrega ejecutores auto-hospedados».
En los sistemas Linux que usan systemd
, puedes usar el script svc.sh
que se crea después de agregar el ejecutor para realizar la instalación y la administración mediante la aplicación como servicio.
En la máquina del ejecutor, abra un shell en el directorio donde ha instalado la aplicación de ejecutor autohospedado. Usa los comandos que se indican a continuación para instalar y administrar el servicio de ejecutor autoalojado.
Nota: La configuración de la aplicación de ejecutor autohospedado como un servicio en Windows forma parte del proceso de configuración de la aplicación. Si ya configuraste la aplicación del ejecutor auto-hospedado pero no elegiste configurarla como servicio, debes eliminar el ejecutor de GitHub y volver a configurar la aplicación. Cuando vuelvas a configurar la aplicación, elige la opción para configurar la aplicación como un servicio.
Para obtener más información, vea «Eliminar ejecutores autoalojados» y «Agrega ejecutores auto-hospedados».
Puede administrar el servicio de ejecutor en la aplicación Windows Services, o bien puede usar PowerShell para ejecutar los comandos siguientes.
Nota: Debes agregar un ejecutor a GitHub antes de que puedas configurar la aplicación del ejecutor auto-hospedado como servicio. Para obtener más información, vea «Agrega ejecutores auto-hospedados».
En la máquina del ejecutor, abra un shell en el directorio donde ha instalado la aplicación de ejecutor autohospedado. Usa los comandos que se indican a continuación para instalar y administrar el servicio de ejecutor autoalojado.
Instalar el servicio
-
Detenga la aplicación del ejecutor autohospedado si está actualmente en ejecución.
-
Instalar el servicio con el siguiente comando:
sudo ./svc.sh install
-
De forma alternativa, el comando toma un argumento opcional
user
para instalar el servicio como un usuario diferente../svc.sh install USERNAME
Instalar el servicio
-
Detenga la aplicación del ejecutor autohospedado si está actualmente en ejecución.
-
Instalar el servicio con el siguiente comando:
./svc.sh install
Iniciar el servicio
Inicia el servicio con el siguiente comando:
sudo ./svc.sh start
Start-Service "actions.runner.*"
./svc.sh start
Comprobar el estado del servicio
Verifica el estado del servicio con el siguiente comando:
sudo ./svc.sh status
Get-Service "actions.runner.*"
./svc.sh status
Para obtener más información sobre cómo ver el estado del ejecutor autohospedado, consulta "Supervisión y solución de problemas de ejecutores autohospedados".
Detener el servicio
Detiene el servicio con el siguiente comando:
sudo ./svc.sh stop
Stop-Service "actions.runner.*"
./svc.sh stop
Desinstalar el servicio
-
Detiene el servicio si se está ejecutando actualmente.
-
Desinstala el servicio con el siguiente comando:
sudo ./svc.sh uninstall
```shell
Remove-Service "actions.runner.*"
```
</div>
```shell
./svc.sh uninstall
```
</div>
Personalizar el servicio del ejecutor auto-hospedado
Si no quiere usar la configuración predeterminada del servicio systemd
anterior, puede crear un servicio personalizado o utilizar el mecanismo de servicio que prefiera. Considere la posibilidad de usar la plantilla serviced
en actions-runner/bin/actions.runner.service.template
como referencia. Si usa un servicio personalizado, el servicio del ejecutor autohospedado siempre se debe invocar mediante el punto de entrada runsvc.sh
.
Personalizar el servicio del ejecutor auto-hospedado
Si no quieres utilizar la configuración predeterminada del servicio launchd antes mencionada, puedes crear un servicio personalizado o cualquier mecanismo de servicio que prefieras. Considere la posibilidad de usar la plantilla plist
en actions-runner/bin/actions.runner.plist.template
como referencia. Si usa un servicio personalizado, el servicio del ejecutor autohospedado siempre se debe invocar mediante el punto de entrada runsvc.sh
.