在 .NET Core 3.0 中,我們引入了一種名為 Worker Service 的新型應用程式模板。此模板旨在為您在 .NET Core 中編寫長時間運行的服務的提供一個起點。在本演練中,我們將創建一個 worker 並將其作為 Windows 服務運行。 ...
原文: .NET Core Workers as Windows Services
在 .NET Core 3.0 中,我們引入了一種名為 Worker Service 的新型應用程式模板。此模板旨在為您在 .NET Core 中編寫長時間運行的服務的提供一個起點。在本演練中,我們將創建一個 worker 並將其作為 Windows 服務運行。
創建一個 Worker
註意:在我們的預覽版中,worker 模板與 Web 模板位於同一級菜單中。這將在未來的版本中發生變化。我們打算將 Worker Service 模板直接放在“創建新項目”菜單中。
在 Visual Studio 中創建 Worker
在命令行中創建 Worker
運行 dotnet new worker
作為 Windows 服務運行
為了作為 Windows 服務運行,我們需要我們的 worker 監聽來自 ServiceBase 的啟動停止信號,該類型將 Windows 服務系統暴露給 .NET 應用程式。要做到這一點,我們希望:
添加 Microsoft.Extensions.Hosting.WindowsServices
NuGet 包
在 Program.cs 的 HostBuilder 中添加對 UseServiceBaseLifetime 的調用
public class Program
{
public static void Main(string[] args)
{
CreateHostBuilder(args).Build().Run();
}
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.UseServiceBaseLifetime()
.ConfigureServices(services =>
{
services.AddHostedService<Worker>();
});
}
這個方法做了兩件事。首先,它檢查應用程式是否真正的作為 Windows 服務運行,如果不是,那麼它什麼都不做,這使得這個方法很安全,當本地運行或作為 Windows 服務運行時。您不需要向其添加保護語句,只需在未作為 Windows 服務安裝時正常運行應用程式即可。
其次,它將配置 host 使用 ServiceBaseLifetime。 ServiceBaseLifetime 與 ServiceBase 一起使用,以幫助控製作為 Windows 服務運行時應用程式的生命周期。這會覆蓋處理 CTRL + C 等信號的預設的 ConsoleLifetime 。
安裝 Worker
一旦我們的 worker 使用 ServiceBaseLifetime,我們就需要安裝它:
首先,讓我們發佈應用程式。如果我們立刻安裝了 Windows 服務,這意味著只要服務運行,exe 就會被鎖定。發佈這一步是個很好的方法, 以確保我需要運行服務的所有文件都在一個位置, 並準備好安裝。
dotnet publish -o c:\code\workerpub
然後我們就可以在命令行中使用 sc 命令來安裝
sc create workertest binPath=c:\code\workerpub\WorkerTest.exe
例如:
安全說明:此命令將服務使用 local system 運行,這通常不是您想要做的事情。相反,您應該創建一個服務帳戶並以該帳戶運行 Windows 服務。我們不會在這裡討論這個問題,但是有一些文檔在這裡討論它: https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/windows-service?view=aspnetcore-2.2
日誌
日誌記錄系統有 Event Log 的提供程式,可以將日誌消息直接發送到 Windows 事件日誌。安裝 Microsoft.Extensions.Logging.EventLog
並修改 Program.cs :
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
.ConfigureLogging(loggerFactory => loggerFactory.AddEventLog())
.ConfigureServices(services =>
{
services.AddHostedService<Worker>();
});
未來工作
在即將到來的預覽版中,我們計劃通過以下方式改善使用 Worker 的體驗:
- 將 UseWindowsServiceBaseLifetime 重命名為 UseWindowsService
- 作為 Windows 服務運行時,自動的集成 Event Log 日誌。
結論
我們希望您試用這個新模板,並希望您告訴我們它有什麼問題,您可以在此處提出任何錯誤或建議:
https://github.com/aspnet/AspNetCore/issues/new/choose
譯者註
原文作者在評論中提到,下一篇文章將講解如何在 Linux/Unix 中創建服務