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