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

你可以将自托管运行程序应用程序配置为一项服务，以便在机器启动时自动启动运行程序应用程序。

平台导航

本文内容

注意：你必须先将一个运行程序添加到 GitHub，然后才能将自托管运行程序应用程序配置为一项服务。有关详细信息，请参阅“添加自托管运行程序”。

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

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

注意：将自托管运行程序应用程序配置为 Windows 上的一项服务是应用程序配置流程的一部分。如果你已经配置了自托管运行程序应用程序，但没有选择将其配置为一项服务，你必须从 GitHub 中删除运行程序并重新配置应用程序。重新配置应用程序时，选择将应用程序配置为一项服务的选项。

有关详细信息，请参阅“删除自托管运行程序”和“添加自托管运行程序”。

你可以在 Windows 服务应用程序中管理运行程序服务，也可以使用 PowerShell 运行以下命令。

注意：你必须先将一个运行程序添加到 GitHub，然后才能将自托管运行程序应用程序配置为一项服务。有关详细信息，请参阅“添加自托管运行程序”。

在运行程序机器上，在安装自托管运行程序应用程序的目录中打开一个 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

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 入口点调用自托管运行程序服务。