原文：Creating Windows Services In .NET Core – Part 2 – The “Topshelf” Way

作者：Dotnet Core Tutorials

譯者：Lamond Lu

譯文：使用.NET Core創(chuàng)建Windows服務(wù)（二） - 使用Topshelf方式

使用.NET Core創(chuàng)建Windows服務(wù)

??使用Topshelf方式

---

在前一篇文章中，我給大家介紹了，如何基于微軟推薦方式使用.NET Core創(chuàng)建Windows服務(wù)。我們發(fā)現(xiàn)使用這種方式，我們很容易就可以搭建和運行一個Windows服務(wù)，但是問題是使用這種方式，代碼調(diào)試將非常困難。

那么現(xiàn)在就是Topshelf出場的時候了。Topshelf是一個.NET Standard庫，它消除了在.NET Framework和.NET Core中創(chuàng)建Windows服務(wù)的那些麻煩。

安裝

與微軟推薦方式類似，這里Visual Studio并沒有提供一個基于Topshelf創(chuàng)建Windows服務(wù)的模板，所以我們依然需要通過創(chuàng)建普通控制臺程序的方式，來創(chuàng)建一個Windows服務(wù)。

然后，我們需要通過Package Manager Console, 運行以下命令，安裝Topshelf類庫。

Install-Package Topshelf

代碼

下面我們就來使用Topshelf重構(gòu)之前的服務(wù)代碼。

public class LoggingService : ServiceControl { private const string _logFileLocation = @"C:\temp\servicelog.txt"; private void Log(string logMessage) { Directory.CreateDirectory(Path.GetDirectoryName(_logFileLocation)); File.AppendAllText(_logFileLocation, DateTime.UtcNow.ToString() + " : " + logMessage + Environment.NewLine); } public bool Start(HostControl hostControl) { Log("Starting"); return true; } public bool Stop(HostControl hostControl) { Log("Stopping"); return true; } }

代碼看起來是不是很簡單？

這里我們的服務(wù)類繼承了ServiceControl類（實際上并不需要，但是這可以為我們的工作打下良好的基礎(chǔ)）。我們必須實現(xiàn)服務(wù)開始和服務(wù)結(jié)束兩個方法，并且像以前一樣記錄日志。

在Program.cs文件的Main方法中，我們要寫的代碼也非常的簡單。我們可以直接使用HostFactory.Run方法來啟動服務(wù)。

static void Main(string[] args) { HostFactory.Run(x => x.Service<LoggingService>()); }

這看起來真是太簡單了。但這并不是HostFactory類的唯一功能。這里我們還可以設(shè)置

?服務(wù)的名稱?服務(wù)是否自動啟動?服務(wù)崩潰之后的重啟時間

static void Main(string[] args) { HostFactory.Run(x => { x.Service<LoggingService>(); x.EnableServiceRecovery(r => r.RestartService(TimeSpan.FromSeconds(10))); x.SetServiceName("TestService"); x.StartAutomatically(); } ); }

這里其實能說的東西很多，但是我建議你還是自己去看看Topshelf的文檔，學(xué)習一下其他的配置選項。基本上你能使用Windows命令行完成的所有操作，都可以使用代碼來設(shè)置：https://topshelf.readthedocs.io/en/latest/configuration/config_api.html

部署服務(wù)

和之前一樣，我們需要針對不同的Windows環(huán)境發(fā)布我們的服務(wù)。在Windows命令提示符下，我們可以在項目目錄中執(zhí)行以下命令：

dotnet publish -r win-x64 -c Release

現(xiàn)在我們就可以查看一下bin\Release\netcoreappX.X\win-x64\publish目錄，我們會發(fā)現(xiàn)一個編譯好的exe，下面我們就會使用這個文件來安裝服務(wù)。

在上一篇文章中，我們是使用SC命令來安裝Windows服務(wù)的。使用Topshelf我們就不需要這么做了，Topshelf提供了自己的命令行參數(shù)來安裝服務(wù)。基本上使用代碼能完成的配置，都可以使用命令行來完成。

你可以查看相關(guān)的文檔：

http://docs.topshelf-project.com/en/latest/overview/commandline.html

WindowsServiceExample.exe install

這里WindowsServiceExample.exe是我發(fā)布之后的exe文件。運行以上命令之后，服務(wù)應(yīng)該就正常安裝了！這里有一個小問題，我經(jīng)常發(fā)現(xiàn)，即使配置了服務(wù)自動啟動，但是服務(wù)安裝之后，并不會觸發(fā)啟動操作。所有在服務(wù)安裝之后，我們還需要通過以下命令來啟動服務(wù)。

WindowsServiceExample.exe start

在生產(chǎn)環(huán)境部署的時候，我的經(jīng)驗是在安裝服務(wù)之后，等待10秒鐘，再啟動服務(wù)。

調(diào)試服務(wù)

當我們是使用微軟推薦方式的時候，我們會遇到了調(diào)試困難的問題。大多數(shù)情況下，無論是否在服務(wù)內(nèi)部運行，我們都不得不使用命令行標志、#IF DEBUG指令或者配置值來實現(xiàn)調(diào)試。然后使用Hack的方式在控制臺程序中模擬服務(wù)。

因此，這就是為什么我們要使用Topshelf。

如果我們的服務(wù)代碼已經(jīng)在Visual Studio中打開了，我們就可以直接啟動調(diào)試。Topshelf會模擬在控制臺中啟動服務(wù)。我們應(yīng)該能在控制臺中看到以下的消息。

The TestService service is now running, press Control+C to exit.

這確實符合了我們的需求。它啟動了我們的服務(wù)，并像真正的Windows服務(wù)一樣在后臺運行。我們可以像往常一樣設(shè)置斷點，基本上它遵循的流程和正常安裝的服務(wù)一樣。

我們可以通過ctrl+c, 來關(guān)閉我們的應(yīng)用，但是在運行服務(wù)執(zhí)行Stop方法之前，它是不能被關(guān)閉的，這使我們可以調(diào)試服務(wù)的關(guān)閉流程。與調(diào)試指令和配置標志相比，這要容易的多。

這里需要注意一個問題。如果你收到的以下內(nèi)容的消息：

The TestService service is running and must be stopped before running via the console

這意味著你嘗試調(diào)試的服務(wù)實際上已經(jīng)作為Windows服務(wù)被安裝在系統(tǒng)中了，你需要停止（不需要卸載）這個正在運行的服務(wù)，才可以正常調(diào)試。

后續(xù)

在上一篇中，有讀者指出.NET Core中實際上已經(jīng)提供了一種完全不同的方式運行Windows服務(wù)。它的實質(zhì)是利用了ASP.NET Core中引入的“托管服務(wù)”模型，并允許它們作為Windows服務(wù)來運行，這真的是非常的棒。

References

[1]?使用微軟推薦方式:?https://www.cnblogs.com/lwqlun/p/11621186.html

創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎勵來咯，堅持創(chuàng)作打卡瓜分現(xiàn)金大獎

總結(jié)

以上是生活随笔為你收集整理的使用.NET Core创建Windows服务（二） - 使用Topshelf方式的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。