打造跨平臺.NET Core后臺服務
續(xù)之前講的在TopShelf上部署ASP.NET Core程序,作為后臺服務運行,自從.NET Core 3.0出現(xiàn)以后,出現(xiàn)了自帶的Generic Host,使得自托管服務變?yōu)榭赡堋?/span>
這種方式和TopShelf方式一樣,可以直接F5進行服務的調試,也為跨平臺后臺服務編寫提供了一種新的方案。
創(chuàng)建服務
以VS2019為例,確保安裝了.NET CORE 3.0以上的SDK,新建項目,在項目模板里面可以找到Worker Service模板,創(chuàng)建后,vs已經幫我們創(chuàng)建了Program.cs和Worker.cs兩個文件。
在Program.cs中
using System;using System.Collections.Generic;using System.Linq;using System.Runtime.InteropServices;using System.Threading.Tasks;using Microsoft.Extensions.DependencyInjection;using Microsoft.Extensions.Hosting;namespace WorkerServiceTest{public class Program{public static void Main(string[] args){CreateHostBuilder(args).Build().Run();}public static IHostBuilder CreateHostBuilder(string[] args) =>Host.CreateDefaultBuilder(args).ConfigureServices((hostContext, services) =>{services.AddHostedService(); });}}}
可以發(fā)現(xiàn),配置的方式和ASP.NET CORE的方式基本一樣一樣的,使用了內置的DI容器。那我們同樣可以使用AddSingleton等方法進行其他邏輯的注入,也可以添加多個服務任務。
而Worker類已經寫了好一個范例,其中有一個ExecuteAsync方法,可以直接執(zhí)行后臺任務。這個時候,直接F5就可以正常運行了,自帶了一個顯示當前時間的小程序。
跨平臺支持
雖然程序可以正常執(zhí)行,但是還不能正常部署為服務,需要依據平臺添加對應的nuget包:
windows服務,需要添加:
Install-Package Microsoft.Extensions.Hosting.WindowsServicesLinux服務,需要添加:
Install-Package Microsoft.Extensions.Hosting.Systemd如果想實現(xiàn)一套程序多處運行,那么直接同時安裝兩個package就可以了。接下來在CreateHostBuilder中,添加UseWindowsService()和UseSystemd()。
public static IHostBuilder CreateHostBuilder(string[] args){if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows)){return Host.CreateDefaultBuilder(args).ConfigureServices((hostContext, services) =>{services.AddHostedService(); }).UseWindowsService();}else{return Host.CreateDefaultBuilder(args).ConfigureServices((hostContext, services) =>{services.AddHostedService(); }).UseSystemd();}}
這里使用到了.NET Core判斷平臺的一個函數:IsOSPlatform,可以判斷是否在Windows平臺運行,并進行分別調用。
部署
編譯完成之后,找到生成的exe文件路徑。
Windows下部署
管理員下運行cmd/powershell,執(zhí)行
sc.exe create WorkerServiceTest binPath=C:\Users\source\repos\WorkerServiceTest\WorkerServiceTest\bin\Debug\netcoreapp3.1\WorkerServiceTest.exe提示CreateService 成功即安裝成功了,可以輸入下面的命令運行服務。
sc.exe start WorkerServiceTestsc.exe負責管理服務,具體配置啟動方式和刪除,可以查看命令的幫助。另外,友情提醒,如果是在powershell中,不要省略這個.exe,sc有別的用處...
Linux下部署
將整個程序文件夾傳輸到Linux文件夾下,我這邊使用的是CentOS 8。新建一個運行服務的用戶:
useradd -m dotnetuser -p dotnetpass轉到/etc/systemd/system文件夾,建立一個WorkerServiceTest.service的文件,這個WorkerServiceTest是你的服務名稱。
輸入以下內容并保存(systemd配置文件):
[Unit]Description=WorkerServiceTest[Service]ExecStart=dotnet /bin/dotnet/WorkerServiceTest.dllWorkingDirectory=/bin/dotnet/User=dotnetuserGroup=dotnetuserRestart=on-failureSyslogIdentifier=WorkerServiceTestPrivateTmp=true[Install]WantedBy=multi-user.target
注意,你需要已經安裝有dotnet runtime 3.0以上版本才可以。
可以使用以下命令進行安
yum install dotnet-runtime-3.1接下來是配置服務和啟動服務
#重載配置systemctl daemon-reload#設置服務自動啟動systemctl enable WorkerServiceTest.service#運行服務systemctl start WorkerServiceTest.service#查詢服務狀態(tài)systemctl status WorkerServiceTest.service
然后可以發(fā)現(xiàn),程序可以正常運行。

補充
作為服務,應該要提供一些狀態(tài)用于外部監(jiān)測,在Worker.cs中,Worker類可以重寫StartAsync和StopAsync方法,提供服務啟動和停止的信息,但是windows提供的服務失敗后動作等功能都找不到配置的地方,可能這就是局限吧。
總結
一次編寫,處處運行,對于后臺服務也是如此,很簡潔。但是暫時手上沒有mac電腦,也不知道m(xù)ac上面有沒有對應的解決方案。可能TopShelf的mono模式可以支持吧。
比較TopShelf模式
總體講,相較于TopShelf的方式,Service Worker方式有利有弊。
優(yōu)點:
在相同的框架(.NET CORE 3.0+)下支持跨平臺,支持linux服務的systemctl管理,topshelf在linux下需要mono。
配置方式和ASP.NET CORE相似度極高,基本上可以無縫切換。
缺點:
不支持TopSelf的自帶命令install/start/uninstall等命令,依然需要sc進行部署,比較麻煩。
不支持windows的很多服務管理特性(比如Pause,依賴管理)。
只支持.NET CORE 3.0以后的框架,不支持.NET FRAMEWORK和早期版本的.NET CORE。
參考資料
https://devblogs.microsoft.com/aspnet/net-core-workers-as-windows-services/https://devblogs.microsoft.com/dotnet/net-core-and-systemd/https://docs.microsoft.com/en-us/dotnet/core/extensions/generic-hosthttps://dejanstojanovic.net/aspnet/2018/june/setting-up-net-core-servicedaemon-on-linux-os/https://dotnetcoretutorials.com/2019/12/07/creating-windows-services-in-net-core-part-3-the-net-core-worker-way/
