.NET Core部署Windows服务

创建

首先你要确保你已经安装了.NET Core 3.0或以上版本。

老版本的Windows服务请看这篇文章

使用命令行创建： dotnet new worker

使用Visual Studio创建

中文版：

英文版：

创建的新项目包含两个文件。其中 Program.cs 文件是应用的启动程序。另外一个文件是 Worker.cs 文件，你可以在这个文件编写你的业务代码。

这看起来应该是相当的容易，但是为这个程序添加额外的并行后台服务，你还需要添加一个类，并让它继承 BackgroundService 类：

public class MyNewBackgroundWorker : BackgroundService
{    
    protected override Task ExecuteAsync(CancellationToken stoppingToken)    
    {        
        //Do something.     
    }
 }

然后在 Program.cs 中，我们要做的只是把当前的Worker注册到服务集合(Service Collection)中即可。

.ConfigureServices((hostContext, services) =>
{
    services.AddHostedService<Worker>();
    services.AddHostedService<MyNewBackgroundWorker>();
});

实际上作为“后台服务”任务的运行程序， AddHostedService 方法已经在框架中存在了很长时间了。在之前我们已经完成的一篇关于ASP.NET Core托管服务的文章，但是在当时场景中，我们托管是是整个应用，而非一个在你应用程序幕后运行的东西。

优化系统的 Worker.cs ，代码执行顺序是冲上往下依次执行的（程序开始-停止）

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Threading;
using System.Threading.Tasks;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;

namespace WorkerService
{
    public class Worker : BackgroundService
    {
        private readonly ILogger<Worker> _logger;

        public Worker(ILogger<Worker> logger)
        {
            _logger = logger;
        }

        public override Task StartAsync(CancellationToken cancellationToken)
        {
            _logger.LogInformation($"Worker started at: {DateTime.Now}");
            return base.StartAsync(cancellationToken);
        }

        protected override async Task ExecuteAsync(CancellationToken stoppingToken)
        {
            while (!stoppingToken.IsCancellationRequested)
            {
                _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);
                await Task.Delay(1000, stoppingToken);
            }
        }

        public override Task StopAsync(CancellationToken cancellationToken)
        {
            _logger.LogError($"Worker stopped at: {DateTime.Now}");

            return base.StopAsync(cancellationToken);
        }

        public override void Dispose()
        {
            _logger.LogInformation($"Worker disposed at: {DateTime.Now}");

            base.Dispose();
        }
    }
}

View Code

部署Windows服务

需要引用 Microsoft.Extensions.Hosting.WindowsServices Neget 包

Install-Package Microsoft.Extensions.Hosting.WindowsServices

修改 Program.cs 文件，添加 UseWindowsService() 方法调用

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

这样代码部分就完成了。

然后使用 cmd 命令把我们发布后的程序代码部署成Windows服务，需要使用管理员权限运行CMD

借助 sc.exe 工具。sc.exe是帮助开发部署 WindowsNT 服务的工具，路径： C:\Windows\System32\sc.exe。这个网上教程一大堆，可以自行了解，这里不多介绍。

部署Linux服务

环境：一台全新的Centos 7.7.1908 系统

安装 .net core相关环境

参考：https://docs.microsoft.com/zh-cn/dotnet/core/install/linux-package-manager-centos7

 sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm

安装 .NET Core SDK：

sudo yum install dotnet-sdk-3.0  -y

安装完成之后可以输入 dotnet --version 查看是否可以返回对应版本

修改代码

程序代码需要引用 Microsoft.Extensions.Hosting.Systemd Neget包

Install-Package Microsoft.Extensions.Hosting.Systemd

修改 Program.cs 文件，添加 UseSystemd() 方法调用，可以和 UseWindowsService() 共存

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

然后把发布文件移至linux系统

部署服务

linux的服务是通过systemd守护进程部署的。现在在系统中我们有了一个发布后的应用程序，我们需要为systemd创建配置文件部署服务。步骤如下：

创建一个.service文件（我们要部署服务，因此需要.service文件），填入以下内容。可以在Linux中直接创建或者通过windows创建然后拷贝至linux。

参考链接

[Unit]
Description= my test app

[Service]
Type=notify
ExecStart=/usr/bin/dotnet  /home/demo/WorkerService.dll

[Install]
WantedBy=multi-user.target

Description：描述，看个人需要是否添加。不需要可以去掉。只留下 [Service] 和 [Install]
Type=notify：当前服务启动完毕，会通知Systemd，再继续往下执行
ExecStart：启动当前服务的命令，程序如何启动，第一个路径是固定路径。第二个路径是应用程序的dll路径（可以自定义）
WantedBy：表示该服务所在的 Target服务组， multi-user.target，表示多用户命令行状态。

把 .service文件移动至 /etc/systemd/system/ 固定目录下，假设自定义文件名称为：testapp.service（如果使用其他名称，请更改testapp）

使用systemctl命令重新加载新的配置文件

sudo systemctl daemon-reload

查看相关服务状态

sudo systemctl status testapp

您应该看到类似以下的内容：

这表明您已注册的新服务已禁用，我们可以通过运行以下命令来启动我们的服务：

sudo systemctl start testapp.service

重新运行 sudo systemctl status testapp 查看服务状态显示已激活正在运行中

设置服务开机自启

sudo systemctl enable testapp.service

到此我们的服务已经完整的部署到了linux系统中

现在我们有一个运行了systemd的应用程序，我们可以看看日志记录集成。使用systemd的好处之一是可以使用journalctl访问的集中式日志记录系统。

首先，我们可以使用journalctl（访问日志的命令）查看服务日志：

sudo journalctl -u testapp

可以看到我们的程序正在运行，可以使用 ↑↓ ← →查看日志内容。或者使用grep搜索。q 键退出

卸载自定义服务

servicename=testapp.service

systemctl stop $servicename
systemctl disable $servicename
rm -rf /etc/systemd/system/$servicename
rm -rf /etc/systemd/system/$servicename symlinks that might be related
systemctl daemon-reload
systemctl reset-failed

雨水的命运

雨水生于天，死于地。这中间的过程就是人生！

.NET Core部署Windows服务

创建

部署Windows服务

部署Linux服务

相关链接

公告