注意:GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。
注意:将自托管运行器应用程序配置为服务之前,必须将运行器添加到 GitHub Enterprise Server。 有关详细信息,请参阅“添加自托管的运行器”。
对于使用 systemd
的 Linux 系统,你可使用在成功添加运行器之后创建的 svc.sh
脚本,将应用程序作为服务进行安装和管理。
在运行器计算机上,在安装了自托管运行器应用程序的目录中打开 shell。 使用以下命令安装和管理自托管运行器服务。
注意:在 Windows 上将自托管运行器应用程序配置为服务是应用程序配置过程的一部分。 如果已配置自托管运行器应用程序,但没有选择将其配置为服务,则必须从 GitHub 中删除运行器并重新配置应用程序。 当您重新配置应用程序时,选择将应用程序配置为服务的选项。
可以在 Windows Services 应用程序中管理运行器服务,也可以使用 PowerShell 来运行下面的命令。
注意:将自托管运行器应用程序配置为服务之前,必须将运行器添加到 GitHub Enterprise Server。 有关详细信息,请参阅“添加自托管的运行器”。
在运行器计算机上,在安装了自托管运行器应用程序的目录中打开 shell。 使用以下命令安装和管理自托管运行器服务。
安装服务
-
如果自托管运行器应用程序当前正在运行,请停止该应用程序。
-
使用以下命令安装服务:
sudo ./svc.sh install
-
或者,该命令采用可选的
user
参数,以其他用户的身份安装服务。./svc.sh install USERNAME
安装服务
-
如果自托管运行器应用程序当前正在运行,请停止该应用程序。
-
使用以下命令安装服务:
./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
卸载服务
-
停止正在运行的服务。
-
使用以下命令卸载服务:
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
入口点来调用自托管运行器服务。