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

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

Warning: Self-hosted runners are currently disabled for GitHub AE. 这是因为 GitHub AE 为安全边界提供了不符合自托管运行器工作方式的保证。 但是,如果您确实需要使用具有 GitHub AE 的自托管运行器并了解安全的意义,可以联系 GitHub 支持以了解将会启用自托管运行器的安全异常。

如果您不需要自托管的运行器,则可使用 AE 托管的运行器 来运行您的工作流程。 更多信息请参阅“关于 AE 托管的运行器”。

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

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

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

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

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

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

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

在运行器机器上,在安装了自托管运行器应用程序的目录中打开 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 入口来调用自托管的运行器服务。

此文档对您有帮助吗?

隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。