Dotnet创建Linux下的Service应用
創建Service應用,是一個服務端開發的必會技能。
?
前言
說到服務端應用,最常見的就是API服務。
除此之外,還有一類應用,比方一個Socket的服務器。這類型的應用,本身沒有Web層,當然也不屬于API服務。
通常大家會怎么做?
不講究的做法,就是做一個Console應用,加載到后臺一直跑著。
其實,還有另外一種做法,就是把應用加載到Services里,使應用以一個Service來做響應。這樣可以依托操作系統的Services管理器來進行統一管理,自動運行和故障處理。
?
Dotnet做Window Service的內容,網上有很多。我今天寫一個在Linux下做Service的方法。
創建Linux下的Service應用
創建一個LInux下的Service應用其實很簡單,就分這么幾步:
1. 用 Worker 模板創建工程
如果習慣用VS上創建,就找一下Worker Service模板。
我是習慣從命令行創建,就一條命令:
%?dotnet?new?worker?-o?projectnameDotnet會自動造成工程,并自動引用Microsoft.Extensions.Hosting包,因為這本身是一個Self-Hosting應用。
2. 加入Linux Service擴展包
其實這就是一個包:Microsoft.Extensions.Hosting.Systemd。這個包為應用提供了在Linux下使用Systemd守護進程的基礎配置。
還是命令行:
%?dotnet?add?package?Microsoft.Extensions.Hosting.Systemd3. 修改Program.cs
其實就是一行代碼,把第二步引入的包加入應用。修改Program.cs
public?static?IHostBuilder?CreateHostBuilder(string[]?args)?=>Host.CreateDefaultBuilder(args).UseSystemd()??//?加入的就是這一行。.ConfigureServices((hostContext,?services)?=>{services.AddHostedService<Worker>();});?
到這兒,套路性的工作已經完成。簡單吧?
?
我們來看一下現在的工程:
├──?Program.cs ├──?Properties │???└──?launchSettings.json ├──?Worker.cs ├──?appsettings.Development.json ├──?appsettings.json └──?workerdemo.csproj大家會注意到,里面多了一個Worker.cs的類文件。
看一下這個文件:
public?class?Worker?:?BackgroundService {private?readonly?ILogger<Worker>?_logger;public?Worker(ILogger<Worker>?logger){_logger?=?logger;}protected?override?async?Task?ExecuteAsync(CancellationToken?stoppingToken){while?(!stoppingToken.IsCancellationRequested){_logger.LogInformation("Worker?running?at:?{time}",?DateTimeOffset.Now);await?Task.Delay(1000,?stoppingToken);}} }這其實就是加載到Systemd里的服務的模板。我們需要的服務代碼,需要加到ExecuteAsync(CancellationToken stoppingToken)方法中。
?
我簡單做個例子,在里面加入UDP服務,看代碼:
public?class?Worker?:?BackgroundService {private?readonly?ILogger<Worker>?_logger;private?readonly?IConfiguration?_configuration;public?Worker(ILogger<Worker>?logger,?IConfiguration?configuration){_logger?=?logger;_configuration?=?configuration;}protected?override?async?Task?ExecuteAsync(CancellationToken?stoppingToken){_logger.LogInformation("Worker?running?at:?{time}",?DateTimeOffset.Now);UdpClient?udpClient?=?new?UdpClient(new?IPEndPoint(IPAddress.Parse("127.0.0.1"),?8000));while?(!stoppingToken.IsCancellationRequested){UdpReceiveResult?udpReceiveResult?=?await?udpClient.ReceiveAsync();string?message?=?Encoding.UTF8.GetString(udpReceiveResult.Buffer);Console.WriteLine($"{udpReceiveResult.RemoteEndPoint.ToString()}?-?{message}");await?udpClient.SendAsync(Encoding.Default.GetBytes("Got"),?3,?udpReceiveResult.RemoteEndPoint);}} }這個代碼中,有兩件事需要注意:
在前邊Program.cs中加入UseSystemd()時,已經注入了IConfiguration。因此,可以在這個方法中直接引入并使用。換句話說,就是可以直接讀取例如appsetting.json的內容;
是上邊提到的,真正的服務響應在ExecuteAsync(CancellationToken stoppingToken)中。這兒沒什么特別的,就是正常的寫法。
?
上面這個,是服務端的程序,是響應。
下面我簡單做個客戶端的請求,供測試用。就不解釋了,只列出步驟:
創建一個工程
修改Program.cs
運行一下,看看效果。
?
到這里,Service應用開發的工作已經完成。
下面是部署。
部署Service應用
Linux下面部署一個Service應用,只有兩個步驟:
1. 創建Service定義
Linux下的每個Service,都會有個定義文件。這個文件存在于/etc/systemd/system目錄下。
下面我給出一個簡單的Service模板:
[Unit] Description=DemoProject[Service] Type=notify ExecStart=dotnet?/yourfolder/yourproject.dll[Install] WantedBy=multi-user.target把這個內容保存為一個文件,例如叫demo.service。然后把這個文件復制到/etc/systemd/system下,并改為可執行。
簡單說一下這個文件的一些項:
Description,是服務的名字。不重要,啟動時,你用到的是文件名demo.service;
Type,服務類型,使用Dotnet加載時,只能是這種類型。如果把程序編譯為自包含程序,這個類型可以是simple;
ExecStart,啟動程序的命令,是全路徑的,要確保能找得到這個程序。上面例子中,dotnet /yourfolder/yourproject.dll,是因為dotnet命令是有PATH變量支持的。
這個文件的配置項有很多,包括定義是否需要自動重啟、重啟間隔等。如果需要,可以去這里查詢。
2. 啟動Service
有兩種方法。
第一種是刷新Service守護
%?systemctl?daemon-reload刷新守護時,守護進程會去/etc/systemd/system目錄下,尋找新加入的Service文件,并啟動。
第二種是單獨啟動,有一系列命令:
啟動
停止
重啟
查詢狀態
嗯。這就是服務加載和停止了。
?
注意,這種方式加載的Service,是完全系統的服務,會沒有任何輸出。
如果需要調試,一種方式是加文件日志,另一種方式是用另一個命令啟動:
%?journalctl?-u?dnsserver.service當然,這種方式只用于調試。正式運行時,還應該是上面的方式。
?
這就是今天的內容,希望能幫到大家。感覺有用的話,給個三連唄~
喜歡就來個三連,讓更多人因你而受益
總結
以上是生活随笔為你收集整理的Dotnet创建Linux下的Service应用的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: Nginx实战部署常用功能演示(超详细版
- 下一篇: 入门K8s:一键脚本搭建Linux服务器