.NET 實現(xiàn)啟動時重定向程序運行路徑及 Windows 服務(wù)運行模式部署的方法
日常工作中有時候會遇到需要將程序直接在服務(wù)器上運行,而不依賴于 IIS 托管的情況,直接運行有兩種方式,一種是部署為 服務(wù)模式,另一種則是 直接啟動 .NET 發(fā)布之后的 exe 文件以 控制臺模式運行,控制臺模式運行主要問題是服務(wù)器在重新啟動之后不會自動啟動,當(dāng)然也可以選擇配置 Windows 計劃任務(wù)的形式讓 控制臺在服務(wù)器開機時自動啟動, 今天給大家分享 .NET 控制臺程序和 .NET 開發(fā)的 WebAPI 及 Web 項目在以 Windows 服務(wù)模式部署時的一些注意事項。
.NET 項目想要部署為 Windows 服務(wù),首先需要通過 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) =>{ ///各種服務(wù)注入}).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(); //各種服務(wù)注入 var app = builder.Build(); app.Run();} }}
以上是兩種常見程序的啟動 Main 函數(shù)的配置 Windows 托管模式的演示,其中一個關(guān)鍵點在于EnvironmentHelper.ChangeDirectory(args);
該方法用于在服務(wù)啟動時將運行路徑重新指向為程序所在目錄,默認情況下 .NET 程序在命令啟動時,運行路徑為執(zhí)行命令的路徑比如在 cmd 中執(zhí)行如下命令:
雖然程序是放在 d:\Publish\ 文件夾中,但是因為我們執(zhí)行啟動程序命令時的路徑是在 c:\User\ZhangXiaoDong 所以程序啟動之后的運行環(huán)境路徑就是 命令執(zhí)行當(dāng)前目錄,c:\User\ZhangXiaoDong 這時候如果我們的代碼中有包含一些涉及到操作 程序所在目錄的 IO 操作時就會產(chǎn)生異常,比如 加載 web 項目下的 wwwroot 文件夾中的靜態(tài)資源,這些都會異常,所以我們需要在程序啟動時將 運行目錄重定向到 我們的程序所在目錄,就用到了EnvironmentHelper.ChangeDirectory(args); 這個方法。
EnvironmentHelper.ChangeDirectory(args); 實現(xiàn)如下:
using Microsoft.Extensions.Configuration.CommandLine;namespace Common{ /// <summary> /// 環(huán)境操作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 參數(shù)的值是否為 true ,如果 cd=true 則重新配置程序的CurrentDirectory 為程序文件所在目錄。
調(diào)整之后我們在啟動程序時只要多添加一個參數(shù)即可,如下:
只要在原本的啟動命令dotnet d:\Publish\WebAPI.dll 優(yōu)化為dotnet d:\Publish\WebAPI.dll --cd='true' 即可,從上圖可以看出雖然我們的啟動命令還是在c:\User\ZhangXiaoDong 目錄執(zhí)行的,但是程序的運行目錄已經(jīng)被重定向到了dotnet d:\Publish\ 這個路徑也正是我們的程序所在路徑。
有了上面的基礎(chǔ),我們就可以利用 Windows服務(wù)器的 SC 指令來配置服務(wù)部署了,具體命令如下:
安裝
sc.exe create MyAPI binpath= 'd:\Publish\WebAPI.exe --cd="true"' start= auto
安裝成功之后控制臺會輸出[SC] CreateService 成功 ,其中MyAPI 時我們創(chuàng)建服務(wù)時指定的服務(wù)名稱,binpath 即是我們的程序路徑,注意 true 是 用英文狀態(tài)的雙引號包裹,然后整個 binpath 采用因為狀態(tài)的 單引號包裹,start= auto 則表示將我們的 MyAPI 服務(wù)設(shè)置為自動啟動。
在 Windows 服務(wù)管理中也可以看到我們的服務(wù)
啟動命令和停止命令,和我們?nèi)粘2僮髌胀ǚ?wù)的命令一樣都是 net start 服務(wù)名 和 net stop 服務(wù)名,如下:
啟動:
net start MyAPI
停止
net stop MyAPI
卸載命令:
sc.exe delete 服務(wù)名稱
如:sc.exe delete MyAPI
至此 .NET 實現(xiàn)啟動時重定向程序運行路徑及 Windows 服務(wù)運行模式部署 就講解完了,有任何不明白的,可以在文章下面評論或者私信我,歡迎大家積極的討論交流,有興趣的朋友可以關(guān)注我目前在維護的一個 .NET 基礎(chǔ)框架項目,項目地址如下
到此這篇關(guān)于.NET 實現(xiàn)啟動時重定向程序運行路徑及 Windows 服務(wù)運行模式部署的文章就介紹到這了,更多相關(guān).NET Windows 服務(wù)運行模式部署內(nèi)容請搜索以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持!
