Skip to main content

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

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

Platform navigation

Note

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

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

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

Note

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

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

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

Note

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

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

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

  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.