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

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

Platform navigation

В этой статье

Примечание.

GitHub Enterprise Serverразмещенные в данный момент средства выполнения не поддерживаются в GitHub.

Примечание.

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

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

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

Примечание.

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

Дополнительные сведения см. в разделе [AUTOTITLE и Удаление локальных средств выполнения](/actions/how-tos/manage-runners/self-hosted-runners/add-runners).

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

Примечание.

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

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

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

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

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

    sudo ./svc.sh install

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

    ./svc.sh install USERNAME

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

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

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

    ./svc.sh install

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

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

sudo ./svc.sh start

Примечание.

В системах Linux на основе Debian (например, Debian или Ubuntu) с needrestart поддержкой можно запретить needrestart перезапуск службы runner во время задания рабочего процесса, настроив ее, чтобы игнорировать службу runner. Выполните следующую команду:

echo '$nrconf{override_rc}{qr(^actions\.runner\..+\.service$)} = 0;' | sudo tee /etc/needrestart/conf.d/actions_runner_services.conf

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

    Remove-Service "actions.runner.*"

    ./svc.sh uninstall

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

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

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

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