歡迎光臨
每天分享高質量文章

[翻譯] 使用 .NET Core 3.0 創建一個 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();
            });
}

這個方法做了兩件事。首先,它檢查應用程式是否真正的作為 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 的體驗:

  • 將 UseWindowsServiceBaseLifetime 重命名為 UseWindowsService
  • 作為 Windows 服務運行時,自動的集成 Event Log 日誌。

結論

我們希望您試用這個新模板,並希望您告訴我們它有什麼問題,您可以在此處提出任何錯誤或建議:
https://github.com/aspnet/AspNetCore/issues/new/choose

譯者註

原文作者在評論中提到,下一篇文章將講解如何在 Linux/Unix 中創建服務

赞(0)

分享創造快樂