Skip to main content

将自托管的运行应用程序配置为服务

您可以将自托管的运行器应用程序配置为服务,以在机器启动时自动启动运行器应用程序。

Platform navigation

Note

GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

Note

将自托管运行程序应用程序配置为服务之前,必须将运行程序添加到 GitHub Enterprise Server。 有关详细信息,请参阅“添加自托管的运行器”。

对于使用 systemd 的 Linux 系统,你可使用在成功添加运行器之后创建的 svc.sh 脚本,将应用程序作为服务进行安装和管理。

在运行器计算机上,在安装了自托管运行器应用程序的目录中打开 shell。 使用以下命令安装和管理自托管运行器服务。

Note

在 Windows 上将自托管运行程序应用程序配置为服务是应用程序配置过程的一部分。 如果已配置自托管运行器应用程序,但没有选择将其配置为服务,则必须从 GitHub 中删除运行器并重新配置应用程序。 当您重新配置应用程序时,选择将应用程序配置为服务的选项。

有关详细信息,请参阅 删除自托管的运行器添加自托管的运行器

可以在 Windows Services 应用程序中管理运行器服务,也可以使用 PowerShell 来运行下面的命令。

Note

将自托管运行程序应用程序配置为服务之前,必须将运行程序添加到 GitHub Enterprise Server。 有关详细信息,请参阅“添加自托管的运行器”。

在运行器计算机上,在安装了自托管运行器应用程序的目录中打开 shell。 使用以下命令安装和管理自托管运行器服务。

安装服务

  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

有关查看自托管运行器状态的详细信息,请参阅“对自托管运行程序进行监视和故障排除”。

停止服务

使用以下命令停止服务:

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 服务配置,可创建自定义服务或使用喜欢的服务机制。 请考虑使用 actions-runner/bin/actions.runner.service.template 中的 serviced 模板作为参考。 如果使用自定义服务,必须始终使用 runsvc.sh 入口点来调用自托管运行器服务。

自定义自托管运行器服务

如果您不想使用上述默认 launchd 服务配置,您可以创建自定义服务或使用您喜欢的服务机制。 请考虑使用 actions-runner/bin/actions.runner.plist.template 中的 plist 模板作为参考。 如果使用自定义服务,必须始终使用 runsvc.sh 入口点来调用自托管运行器服务。