日常作業中有時候會遇到需要將程式直接在服務器上運行，而不依賴于 IIS 托管的情況，直接運行有兩種方式，一種是部署為 服務模式，另一種則是 直接啟動 .NET 發布之后的 exe 檔案以 控制臺模式運行，控制臺模式運行主要問題是服務器在重新啟動之后不會自動啟動，當然也可以選擇配置 Windows 計劃任務的形式讓 控制臺在服務器開機時自動啟動， 今天給大家分享 .NET 控制臺程式和 .NET 開發的 WebAPI 及 Web 專案在以 Windows 服務模式部署時的一些注意事項，
.NET 專案想要部署為 Windows 服務，首先需要通過 NuGet 安裝 Microsoft.Extensions.Hosting.WindowsServices ，然后在程式啟動時做如下配置：
控制臺程式：
using Common; namespace TaskService { class Program { static void Main(string[] args) { EnvironmentHelper.ChangeDirectory(args); IHost host = Host.CreateDefaultBuilder(args).UseWindowsService() .ConfigureServices((hostContext, services) => { ///各種服務注入 }) .Build(); host.Run(); } } }
Web 及 WebAPI 程式：
using Common; namespace WebAPI { public class Program { public static void Main(string[] args) { EnvironmentHelper.ChangeDirectory(args); var builder = WebApplication.CreateBuilder(args); builder.Host.UseWindowsService(); //各種服務注入 var app = builder.Build(); app.Run(); } } }
以上是兩種常見程式的啟動 Main 函式的配置 Windows 托管模式的演示，其中一個關鍵點在于 EnvironmentHelper.ChangeDirectory(args);
該方法用于在服務啟動時將運行路徑重新指向為程式所在目錄，默認情況下 .NET 程式在命令啟動時，運行路徑為執行命令的路徑比如在 cmd 中執行如下命令：
雖然程式是放在 d:\Publish\ 檔案夾中，但是因為我們執行啟動程式命令時的路徑是在 c:\User\ZhangXiaoDong 所以程式啟動之后的運行環境路徑就是 命令執行當前目錄，c:\User\ZhangXiaoDong 這時候如果我們的代碼中有包含一些涉及到操作 程式所在目錄的 IO 操作時就會產生例外，比如 加載 web 專案下的 wwwroot 檔案夾中的靜態資源，這些都會例外，所以我們需要在程式啟動時將 運行目錄重定向到 我們的程式所在目錄，就用到了 EnvironmentHelper.ChangeDirectory(args); 這個方法，
EnvironmentHelper.ChangeDirectory(args); 實作如下：
using Microsoft.Extensions.Configuration.CommandLine; namespace Common { /// <summary> /// 環境操作Helper方法 /// </summary> public class EnvironmentHelper { /// <summary> /// 改變作業目錄 /// </summary> /// <param name="args"></param> public static void ChangeDirectory(string[] args) { var cmdConf = new CommandLineConfigurationProvider(args); cmdConf.Load(); if (cmdConf.TryGet("cd", out string cdStr) && bool.TryParse(cdStr, out bool cd) && cd) { Directory.SetCurrentDirectory(AppContext.BaseDirectory); } } } }
主要邏輯是判斷啟動命令中 cd 引數的值是否為 true ，如果 cd=true 則重新配置程式的 CurrentDirectory 為程式檔案所在目錄，
調整之后我們在啟動程式時只要多添加一個引數即可，如下：
只要在原本的啟動命令 dotnet d:\Publish\WebAPI.dll 優化為 dotnet d:\Publish\WebAPI.dll --cd='true' 即可，從上圖可以看出雖然我們的啟動命令還是在 c:\User\ZhangXiaoDong 目錄執行的，但是程式的運行目錄已經被重定向到了 dotnet d:\Publish\ 這個路徑也正是我們的程式所在路徑，
有了上面的基礎，我們就可以利用 Windows服務器的 SC 指令來配置服務部署了，具體命令如下：
安裝sc.exe create MyAPI binpath= 'd:\Publish\WebAPI.exe --cd="true"' start= auto
安裝成功之后控制臺會輸出 [SC] CreateService 成功 ，其中 MyAPI 時我們創建服務時指定的服務名稱，binpath 即是我們的程式路徑，注意 true 是 用英文狀態的雙引號包裹，然后整個 binpath 采用因為狀態的 單引號包裹，start= auto 則表示將我們的 MyAPI 服務設定為自動啟動，
在 Windows 服務管理中也可以看到我們的服務
啟動：
net start MyAPI
net stop MyAPI
卸載命令：
sc.exe delete 服務名稱
如：sc.exe delete MyAPI
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/508721.html
標籤：.NET技术