Настройка приложения локального средства выполнения как службы

Вы можете настроить локальное средство выполнения в качестве службы, чтобы автоматически запускать его при запуске компьютера.

Platform navigation

В этой статье

Примечание. Добавьте средство выполнения в GitHub Enterprise Cloud, прежде чем настроить приложение локального средства выполнения в качестве службы. Дополнительные сведения см. в разделе Добавление локальных средств выполнения.

Для систем Linux, использующих systemd, можно воспользоваться скриптом svc.sh, который создан после успешного добавления средства выполнения, для установки приложения в качестве службы и управления им.

На компьютере средства выполнения откройте оболочку в каталоге, где установлено приложение локального средства выполнения. Используйте приведенные ниже команды, чтобы установить службу локального средства выполнения и управлять ею.

Примечание. Настройка приложения локального средства выполнения в качестве службы в Windows является частью процесса настройки приложения. Если вы уже настроили приложение локального средства выполнения, но не в качестве службы, необходимо удалить средство выполнения из GitHub и повторно настроить приложение. При повторной настройке приложения выберите параметр настройки приложения как службы.

Дополнительные сведения см. в разделе "[AUTOTITLE" и "Удаление локальных средств выполнения](/actions/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners)".

Вы можете управлять службой средства выполнения в приложении Службы Windows или использовать PowerShell для выполнения приведенных ниже команд.

Примечание. Добавьте средство выполнения в GitHub Enterprise Cloud, прежде чем настроить приложение локального средства выполнения в качестве службы. Дополнительные сведения см. в разделе Добавление локальных средств выполнения.

На компьютере средства выполнения откройте оболочку в каталоге, где установлено приложение локального средства выполнения. Используйте приведенные ниже команды, чтобы установить службу локального средства выполнения и управлять ею.

Установка службы

  1. Остановите приложение локального средства выполнения, если в данный момент оно запущено.

  2. Установите службу с помощью следующей команды:

    sudo ./svc.sh install

  3. Эта команда принимает необязательный аргумент user для установки службы в качестве другого пользователя.

    ./svc.sh install USERNAME

Установка службы

  1. Остановите приложение локального средства выполнения, если в данный момент оно запущено.

  2. Установите службу с помощью следующей команды:

    ./svc.sh install

Запуск службы

Запустите службу с помощью следующей команды:

sudo ./svc.sh start

Start-Service "actions.runner.*"

./svc.sh start

Проверка состояния службы

Проверьте состояние службы с помощью следующей команды:

sudo ./svc.sh status

Get-Service "actions.runner.*"

./svc.sh status

Дополнительные сведения о просмотре состояния локального runner см. в разделе "Мониторинг и устранение неполадок в самостоятельно размещенных средствах выполнения".

Остановка службы

Остановите службу с помощью следующей команды:

sudo ./svc.sh stop

Stop-Service "actions.runner.*"

./svc.sh stop

Удаление службы

  1. Остановите службу, если она работает в данный момент.

  2. Удалите службу с помощью следующей команды:

    sudo ./svc.sh uninstall

```shell
Remove-Service "actions.runner.*"
```

</div>

```shell
./svc.sh uninstall
```

</div>

Настройка службы локального средства выполнения

Если вы не хотите использовать указанную выше конфигурацию службы systemd по умолчанию, можно создать настраиваемую службу или использовать любой предпочитаемый механизм службы. Рассмотрите возможность использования шаблона serviced в actions-runner/bin/actions.runner.service.template качестве справки. Если вы используете настроенную службу, служба локального средства выполнения всегда должна вызываться с помощью точки входа runsvc.sh.

Настройка службы локального средства выполнения

Если вы не хотите использовать указанную выше конфигурацию службы launchd по умолчанию, можно создать настраиваемую службу или использовать любой предпочитаемый механизм службы. Рассмотрите возможность использования шаблона plist в actions-runner/bin/actions.runner.plist.template качестве справки. Если вы используете настроенную службу, служба локального средства выполнения всегда должна вызываться с помощью точки входа runsvc.sh.