Skip to main content

Configurar la aplicación del ejecutor autoalojado como un servicio

Puedes configurar la aplicación del ejecutor autoalojado como un servicio para iniciar automáticamente la aplicación del ejecutor cuando se inicia la máquina.

Platform navigation

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

  1. Detenga la aplicación del ejecutor autohospedado si está actualmente en ejecución.

  2. Instalar el servicio con el siguiente comando:

    sudo ./svc.sh install
    
  3. 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

  1. Detenga la aplicación del ejecutor autohospedado si está actualmente en ejecución.

  2. 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

  1. Detiene el servicio si se está ejecutando actualmente.

  2. 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.