使用.NET Core創建Windows服務 - 使用.NET Core工作器方式


原文:Creating Windows Services In .NET Core – Part 3 – The “.NET Core Worker” Way
作者:Dotnet Core Tutorials
譯者:Lamond Lu
譯文:使用.NET Core創建Windows服務 - 使用.NET Core工作器方式

使用.NET Core創建Windows服務


安裝步驟

這里首先你要確保你已經安裝了.NET Core 3.0或以上版本。在我編寫這篇文章的時候, .NET Core 3.1剛剛發布,Visual Studio應該會提示你升級到最新版本。但是如果你想要在.NET Core 2.x項目中使用這個方式,應該是行不通的。

如果你喜歡使用命令行創建項目,你就需要使用工作器(worker)類型創建項目:

dotnet new worker

如果你是一個和我一樣喜歡使用Visual Studio的開發人員,那么你可以在Visual Studio中使用項目模板完成相同的功能。

這樣做將創建出一個包含兩個文件的項目。其中Program.cs文件是應用的啟動“引導程序”。另外一個文件是worker.cs文件,在這個文件中,你可以編寫你的服務邏輯。

這看起來應該是相當的容易,但是為這個程序添加額外的並行后台服務,你還需要添加一個類,並讓它繼承BackgroundService類:

public class MyNewBackgroundWorker : BackgroundService
{    
	protected override Task ExecuteAsync(CancellationToken stoppingToken)    
	{        
		//Do something.     
	}
 }

然后在Program.cs中,我們要做的只是把當前的Worker注冊到服務集合(Service Collection)中即可。

.ConfigureServices((hostContext, services) =>
{
    services.AddHostedService<Worker>();
    services.AddHostedService<MyNewBackgroundWorker>();
});

實際上作為“后台服務”任務的運行程序,AddHostedService方法已經在框架中存在了很長時間了。在之前我們已經完成的一篇關於ASP.NET Core托管服務的文章, 但是在當時場景中,我們托管是是整個應用,而非一個在你應用程序幕后運行的東西。

運行/調試我們的應用

在默認的工作器(worker)模板中,已經包含了一個后台服務,這個服務可以將當前時間輸出到控制台窗口。下面讓我們點擊F5來運行程序,看看我們能得到什么。

info: CoreWorkerService.Worker[0]      
	  Worker running at: 12/07/2019 08:20:30 +13:00
info: Microsoft.Hosting.Lifetime[0]      
	  Application started. Press Ctrl+C to shut down.

在我們啟動程序之后,程序立刻就運行了!我們可以保持控制台的打開狀態來調試應用,或者直接關閉窗口退出。相較於使用"Microsoft"方式來調試一個Windows服務,這簡直就是天堂。

這里我們需要注意的另外一件事情是編寫控制台程序的平台。在最后,我們不僅在控制台窗口輸出了時間,還通過依賴注入創建了一個托管worker. 我們也可以使用依賴注入容器來注入倉儲,配置環境變量,獲取配置等。

但這里我們還沒有做的事情是,將這個應用轉換為Windows服務。。

將我們的應用轉換成Window服務

為了將應用轉換成Windows服務,我們需要使用如下命令引入一個包。

Install-Package Microsoft.Extensions.Hosting.WindowsServices

下一步,我們需要修改Program.cs文件,添加UseWindowsService()方法的調用。

public static IHostBuilder CreateHostBuilder(string[] args) => 
	Host.CreateDefaultBuilder(args)    
		.ConfigureServices((hostContext, services) =>    
		{        
			services.AddHostedService<Worker>();   
         })
         .UseWindowsService();

以上就是所有需要變更的代碼。

運行我們的程序,你會發現和之前的效果完全樣。但是這里最大的區別是,我們可以將當前應用以Windows服務的形式安裝了。

為了實現這一目的,我們需要發布當前項目。在當前項目目錄中,我們可以運行以下命令:

dotnet publish -r win-x64 -c Release

然后我們就可以借助標准的Windows服務安裝器來安裝當前服務了。

sc create TestService BinPath=C:\full\path\to\publish\dir\WindowsServiceExample.exe

當前,你也可以使用Windows服務安裝器的其他命令。

sc start TestService
sc stop TestService
sc delete TestService

最后檢查一下我們的服務面板。

服務已經正常工作了。

在Linux中運行服務

老實說,我沒有太多的Linux經驗,但是終歸是需要了解一下...

在Linux系統中, 如果你希望我們編寫的“Windows”服務在Linux系統中作為服務運行,你需要做以下2步:

  • 使用Microsoft.Extensions.Hosting.Systemd替換之前的Microsoft.Extensions.Hosting.WindowsServices
  • 使用UseSystemd()替換UseWindowsService()

Microsoft vs Topshelf vs .NET Core Workers

到現在為止,我們已經介紹了借助3種不同的方式來創建Windows服務。

你可能會問“好吧,那我到底應該選擇哪一種?”

這里呢,我們可以首先把"Microsoft"這種老派學院式的方式拋棄。以為它的調試實在是太麻煩了,而且沒有什么實際的用處。

然后剩下的就是Topshelf和.NET Core工作器兩種方式了。在我看來,.NET Core工作器,已經很好的融入.NET Core生態系統,如果你正在開發ASP.NET Core應用,那么使用.NET Core工作器就很有意義。最重要的是,當你創建一個后台服務的時候,你可以讓它在一個ASP.NET Core網站中的任意位置運行,這非常的方便。但是缺點是安裝。你必須使用SC命令來安裝服務。這一部分Topshelf可能更勝一籌。

Topshelf總體上將非常的友好,並且具有最好的安裝方式,但是使用額外的庫,也增加了學習的成本。

所以Topshelf和.NET Core工作器,大家可以自行選擇,都是不錯的方案。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM