此版本的 GitHub Enterprise 已停止服务 2021-09-23. 即使针对重大安全问题,也不会发布补丁。 要获得更好的性能、改进的安全性和新功能,请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助,请联系 GitHub Enterprise 支持

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

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

注:GitHub Enterprise Server 2.22 上的 GitHub Actions 支持是有限的公测版。 测试已结束。 GitHub Actions 现在一般可用于 GitHub Enterprise Server 3.0 或更新版本。 更多信息请参阅 GitHub Enterprise Server 3.0 发行说明


注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

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

对于使用 systemd 的 Linux 系统,您可以使用随自托管运行器应用程序分发的 svc.h 脚本来安装和管理应用程序即服务。

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

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

更多信息请参阅“删除自托管的运行器”和“添加自托管的运行器”。

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

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

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

安装服务

  1. 如果自托管的运行器应用程序正在运行,请停止它。

  2. 使用以下命令安装服务:

    sudo ./svc.sh install

安装服务

  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
    Remove-Service "actions.runner.*"
    ./svc.sh uninstall

自定义自托管运行器服务

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

自定义自托管运行器服务

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