.NET Core3.0創建Worker Services

2019 年 10 月 24 日
筆記

.NET CORE 3.0新增了Worker Services的新項目模板，可以編寫長時間運行的後台服務，並且能輕鬆的部署成windows服務或linux守護程序。如果安裝的vs2019是中文版本，Worker Services變成了輔助角色服務。Worker Services 咱也不知道怎麼翻譯成了這個名稱，咱也不敢亂翻譯，下文就保持原名稱。。。，本文將會演示如何創建一個Worker Services項目，並且部署為windows服務或linux守護程序運行；

開始創建worker service 項目

創建新項目——》選擇輔助角色服務

項目創建成功之後，您會看到創建了兩個類：Program和Worker。

Program.cs

 public static void Main(string[] args)          {              CreateHostBuilder(args).Build().Run();          }            public static IHostBuilder CreateHostBuilder(string[] args) =>              Host.CreateDefaultBuilder(args)                      .ConfigureServices((hostContext, services) =>                  {                      services.AddHostedService<Worker>();                  });

Program類跟ASP.NET Core Web應用程序非常類似，不同之處沒有了startup類，並且把worker服務添加到DI container中。

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);              }          }      }

worker只是一個簡單的類，它繼承自BackgroundService ，而後者又實現IHostedService接口。

默認的worker演示，沒隔1秒，循環打印運行的時間。

部署為Windows服務運行

1.在項目中添加nuget包：Microsoft.Extensions.Hosting.WindowsServices

2.然後在program.cs內部，將UseWindowsService()添加到CreateHostBuilder

        public static IHostBuilder CreateHostBuilder(string[] args) =>              Host.CreateDefaultBuilder(args)                .UseWindowsService()                  .ConfigureServices((hostContext, services) =>                  {                      services.AddHostedService<Worker>();                  });

3.執行一下命令發佈項目

dotnet publish  -c Release -o C:WorkerPub

4.然後使用sc.exe工具來管理服務，輸入一下命令創建為windows服務

sc.exe create DemoWorkService binPath=C:WorkerPubWorkerService1.exe

查看服務狀態使用一下命令

sc.exe query DemoWorkService

啟動命令

sc.exe start DemoWorkService

在服務列表查看，DemoWorkService已安裝成功

停用、刪除命令

sc.exe stop DemoWorkService  sc.exe delete DemoWorkService

部署作為Linux守護程序運行

部署linux守護程序也是很方便的執行一下兩個步驟即可：

添加Microsoft.Extensions.Hosting.Systemd NuGet包到項目中，並告訴你的新Worker，其生命周期由systemd管理！

將UseSystemd()添加到主機構建器中。

public static IHostBuilder CreateHostBuilder(string[] args) =>      Host.CreateDefaultBuilder(args)          .UseSystemd()          .ConfigureServices((hostContext, services) =>          {              services.AddHostedService<Worker>();          });