ASP.NET Core在CentOS上的最小化部署实践

分类：asp.Net作者：博客猿马甲哥

引言

       本文从Linux小白的视角， 在CentOS 7.x服务器上搭建一个Nginx-Powered AspNet Core Web准生产应用。
在开始之前，我们还是重温一下部署原理，正如你所常见的.Net Core 部署图：

在Linux上部署.Net Core App最好的方式是在Linux机器上使用Kestrel 服务在端口5000上支撑web应用； 然后设置Nginx作为反向代理服务器，将输入请求转发给Kestrel服务器， 这个模式称为 边缘代理服务器（edge-origin proxy）。

使用这种部署模型有如下优势：

  • 可扩展性： 反向代理服务器和Web服务器可以设置在一台或者不同的机器上，为伸缩部署提供可能， 可按需部署多个Web服务器，Nginx反向代理服务器本身可充当优秀的负载均衡器。

  • 数据安全性：edge-origin 模式隐藏了 Web服务器进程的细节，对外只暴露80端口，对外暴露的只有Nginx 反向代理服务器，减少了网络攻击的可能性。

  • 高性能：反向代理服务器可以为后端服务器配置 内容缓存，减少对后端服务器的请求，这是个很重要的性能提升，避免DDOS攻击和暴力恶意攻击。

  • 多功能性：本文虽然是在讲述Linux-only 部署， 这种模式允许你高效、透明地混合使用Linux和Windows服务器，以上Web服务器也可以是 IIS-Powered的Web服务器。

　

 准备部署

　    首先明确dotnet程序是一个独立进程， 原本可不依赖反向代理服务器运行；  必备知识点

　　第二明确Nginx反向代理服务器的作用,  这里我们需要为.NetCore 程序添加必要的中间件

// Invoke the UseForwardedHeaders middleware and configure it to forward the X-Forwarded-For and X-Forwarded-Proto headers.
// NOTE: This must be put BEFORE calling UseAuthentication or similar authentication scheme middlewares.
// ref.: https://www.ryadel.com/en/asp-net-core-2-publish-deploy-web-application-linux-centos-tutorial-guide-nginx
app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
});

       第三明确dotnet程序需要在Linux系统中以守护进程的方式运行，可使用 supervisor、systemd等方式。

 

1. 安装环境

sudo rpm -Uvh https://packages.microsoft.com/config/rhel/7/packages-microsoft-prod.rpm       
-- rpm是一种软件包管理方式，这里的微软软件包仓库以rpm包的形式提供，包含仓库配置和供发行版认证软件包的公钥，你可以理解为添加了一个nuget包仓库

sudo yum update
sudo yum install aspnetcore-runtime-2.2    　　　　　　　　　　　　　　　　　　　　　　　　　　　　
-- yum基于rpm包管理，能够从指定服务器自动下载rpm包并且安装，可自动处理依赖关系，并一次安装所有依赖软件包。

 

2. dotnet程序发布、测试

　　- 使用VS项目右键发布到指定目录

       - 使用zip方式打包

       - 使用scp、SFTP工具上传到Linux服务器， 一般情况下拷贝到var目录

scp D:\production\eqidproxyServer.zip root@10.201.80.126:/var/www   --以下命令将zip包拷贝到 /var/www目录下

        - 在CentOS服务器上解压

unzip -d eqidproxyServer eqidproxyServer.zip

       -  执行dotnet EqidProxyServer.dll

 

3. 使用systemd将dotnet进程设置成Linux守护进程

　　 完成以上步骤，dotnet程序并不能在后台作为服务运行，Nginx虽然能作为反向代理服务器转发请求到dotnet进程， 但是并不具备管理dotnet进程的能力。

 下面使用 systemd来将dotnet进程设定为系统服务。

systemd是一个Linux的系统服务管理器，其作用是提供系统服务依赖管理 、实现系统初始化时服务的并行启动。

① 创建服务文件：vim /etc/systemd/system/kestrel-eqidproxyserver.service
[Unit]
Description=EqidProxyServer deploy on centos

[Service]
WorkingDirectory=/var/www/eqidproxyserver/eqidproxyServer
ExecStart=/usr/bin/dotnet /var/www/eqidproxyserver/eqidproxyServer/EqidProxyServer.dll
Restart=always
# Restart service after 10 seconds if the dotnet service crashes:
RestartSec=10
TimeoutStopSec=90
KillSignal=SIGINT
SyslogIdentifier=dotnet-example
User=root
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

黄色背景行是需要你注意配置的，这里我们使用root来执行dll， 一般情况下需要创建一个web账户，并给予项目文件夹owner权限。

 下面在root用户组下创建www-data用户，并给予owner权限。
 sudo useradd -m -g root www-data
 sudo chown www-data var/www/eqidproxyserver

 

注意：Linux 是大小写敏感的文件系统，设定ASPNETCORE_ENVIRONMENT=Production 会在配置文件中搜索如下配置文件： appsettings.Production.json， 故配置和文件名需要留意匹配。

 

② 启用、启动服务
sudo systemctl enable kestrel-eqidproxyserver.service 　　　　　　// 启用服务
sudo systemctl start kestrel-eqidproxyserver.service 　　　　　　 // 指定服务名启动
sudo systemctl status kestrel-eqidproxyserver.service 　　　　　　// 验证服务状态
　以下是验证服务状态的输出：
● kestrel-eqidproxyserver.service - EqidProxyServer deploy on centos
   Loaded: loaded (/etc/systemd/system/kestrel-eqidproxyserver.service; enabled; vendor preset: disabled)
   Active: active (running) since Thu 2019-02-28 18:04:20 CST; 3min 2s ago
 Main PID: 52859 (dotnet)
   Memory: 46.3M
   CGroup: /system.slice/kestrel-eqidproxyserver.service
           └─52859 /usr/bin/dotnet /var/www/eqidproxyserver/eqidproxyServer/EqidProxyServer.dll

Feb 28 18:06:18 gs-server-5809 dotnet-eqidproxyserver[52859]: info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2]
Feb 28 18:06:18 gs-server-5809 dotnet-eqidproxyserver[52859]: Request finished in 136.6715ms 200
Feb 28 18:06:23 gs-server-5809 dotnet-eqidproxyserver[52859]: info: Microsoft.AspNetCore.Hosting.Internal.WebHost[1]
Feb 28 18:06:23 gs-server-5809 dotnet-eqidproxyserver[52859]: Request starting HTTP/1.1 GET http://127.0.0.1/
Feb 28 18:06:23 gs-server-5809 dotnet-eqidproxyserver[52859]: info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2]
Feb 28 18:06:23 gs-server-5809 dotnet-eqidproxyserver[52859]: Request finished in 3.5599ms 200
Feb 28 18:06:32 gs-server-5809 dotnet-eqidproxyserver[52859]: info: Microsoft.AspNetCore.Hosting.Internal.WebHost[1]
Feb 28 18:06:32 gs-server-5809 dotnet-eqidproxyserver[52859]: Request starting HTTP/1.1 GET http://10.201.80.126/
Feb 28 18:06:32 gs-server-5809 dotnet-eqidproxyserver[52859]: info: Microsoft.AspNetCore.Hosting.Internal.WebHost[2]
Feb 28 18:06:32 gs-server-5809 dotnet-eqidproxyserver[52859]: Request finished in 1.3498ms 200

 

4. 搭配Nginx部署web程序

 
① 安装Nginx

　　  -  sudo yum install nginx　　　　　　【首次安装需要显式启动： sudo service nginx start】

 CentOS安装的nginx并没有作为守护进程运行，执行sudo systemctl enable nginx 启用nginx守护进程： https://www.digitalocean.com/community/tutorials/how-to-install-nginx-on-centos-7
 Ubuntu 中使用 apt-get 安装的nginx， 安装器会创建systemd init script，也就是说nginx会随着系统启动作为守护程序运行。

　　-    在终端使用curl localhost 测试nginx

 
② 配置Nginx作为反向代理服务器

　　　- 修改/etc/nginx/nginx.conf 文件： sudo vi /etc/nginx/nginx.conf

　　　- 配置nginx在80端口将请求转发到Kestrel服务器（localhost:5000）

server {
        listen       80;
        server_name  default_website;
        root         /usr/share/nginx/html;

        # Load configuration files for the default server block.
        include /etc/nginx/default.d/*.conf;

        location / {
        proxy_pass         http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
        }

        error_page 404 /404.html;
            location = /40x.html {
        }

        error_page 500 502 503 504 /50x.html;
            location = /50x.html {
        }
    }

　　一旦nginx配置完成，可以使用sudo nginx -t 测试配置文件的语法；

　　如果配置文件合法，就可以重启nginx： sudo nginx -s reload

 

　　完成以上步骤之后，现在已经可以从127.0.0.1、127.0.0.1:5000、 服务器IP访问web程序。

 

5.查看进程日志

　　   使用systemd方式管理进程，所有事件和进程都会记录到某个集中日志，该集中日志包含所有被systend管理的服务和进程的日志。

这个日志功能相当于windows服务器中的事件查看器。

 

查看刚才建立的服务日志， 可使用下面的命令：

sudo journalctl -fu kestrel-eqidproxysever.service

 时间过滤：

sudo journalctl -fu kestrel-eqidproxysever.service --since "2018-11-18" --until "2019-03-28 04:00"

　　

　　

  部分内容参考： https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/linux-nginx?viw=aspnetcore-2.2

　　rpm包源： https://docs.microsoft.com/en-us/windows-server/administration/linux-package-repository-for-microsoft-software

　　rpm/yum区别： https://zhuanlan.zhihu.com/p/27724520

　　Linux进程管理：https://linux.cn/article-3801-1.html

 

作者：JulianHuang

感谢您的认真阅读，如有问题请大胆斧正；觉得有用，请下方

或加关注。

本文欢迎转载，但请保留此段声明，且在文章页面明显位置注明本文的作者及原文链接。

 

原文地址：https://www.cnblogs.com/JulianHuang/p/10455644.html

版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 dio@foxmail.com 举报，一经查实，本站将立刻删除。

相关推荐

ASP.NET Core在CentOS上的最小化部署实践
引言 本文从Linux小白的视角， 在CentOS 7.x服务器上搭建一个Nginx-Powered AspNet Core Web准生产应用。 在开始之前，我们还是重温一下部署原理，正如你所常见的.Net Core 部署图： 在Linux上部署.Net Core App最好的方式是在Linux机器
【异步编程】Part2：掌控SynchronizationContext避免deadlock
引言： 多线程编程/异步编程非常复杂，有很多概念和工具需要去学习，贴心的.NET提供Task线程包装类和await/async异步编程语法糖简化了异步编程方式。 相信很多开发者都看到如下异步编程实践原则： 遵守以上冷冰冰的②③条的原则，可保证异步程序按照预期状态正常运作；我们在各大编程论坛常看到违背
ASP.NET Core Middleware 抽丝剥茧
一. 宏观概念 ASP.NET Core Middleware是在应用程序处理管道pipeline中用于处理请求和操作响应的组件。 每个组件是pipeline 中的一环。 自行决定是否将请求传递给下一个组件 在处理管道的下个组件执行之前和之后执行业务逻辑 二. 特性和行为 ASP.NET Core处
【异步编程】Part3:取消异步操作
背景 在.Net和C#中运行异步代码相当简单，因为我们有时候需要取消正在进行的异步操作，通过本文，可以掌握 通过CancellationToken取消任务（包括non-cancellable任务）。 Task 表示无返回值的异步操作， 泛型版本Task<TResult>表示有返
ASP.NET Core 实现基本认证
HTTP基本认证 在HTTP中，HTTP基本认证（Basic Authentication）是一种允许网页浏览器或其他客户端程序以(用户名：口令) 请求资源的身份验证方式，不要求cookie,session identifier、login page等标记或载体。 - 所有浏览器据支持HTTP基本认
LINQ 常规实践总结
1.Linq 执行多列排序 OrderBy的意义是按照指定顺序排序，连续两次OrderBy，后面一个有可能会打乱前面一个的排序顺序，可能与预期不符。 要实现sql中的order by word,name类似效果; LINQ 有ThenBy可以紧接使用， ThenBy记住原本排序的值，然后再排其他值，
ASP.NET Core跨平台 技术内幕
ASP.NET Core 核心特性：开源、跨平台、高性能是其决战JAVA的必胜法宝，最引人关注的跨平台特性 到底是怎么实现？ 
 本文分Unix、Windows剖析跨平台内幕，读完让你大呼过瘾。
【异步编程】Part1：await&async语法糖让异步编程如鱼得水
前导 Asynchronous programming Model（APM）异步编程模型以BeginMethod(...) 和 EndMethod(...)结对出现。 IAsyncResult BeginGetResponse(AsyncCallback callback, object state
ASP.NET Core 实现带认证功能的Web代理服务器
引言 最近在公司开发了一个项目，项目部署架构图如下： 思路 如图中文本所述，公司大数据集群不允许直接访问外网，需要一个网关服务器代理请求，本处服务器A就是边缘代理服务器的作用。 通常技术人员最快捷的思路是在服务器A上部署IISʺpplication Request Routing Module组件
ASP.NET Core+Quartz.Net 实现web定时任务
作为一枚后端程序狗，项目实践常遇到定时任务的工作，最容易想到的的思路就是利用Windows计划任务/wndows service程序/Crontab程序等主机方法在主机上部署定时任务程序/脚本。 但是很多时候，若使用的是共享主机或者受控主机，这些主机不允许你私自安装exe程序、Windows服务程序
ASPNET.Core结合Redis实践消息队列，从此放心安全迭代
引言 熟悉TPL Dataflow博文的朋友可能记得这是个单体程序，使用TPL Dataflow 处理工作流任务， 在使用Docker部署的过程中， 有一个问题一直无法回避： 在单体程序部署的瞬间（服务不可用）会有少量流量无法处理；更糟糕的情况下，迭代部署的这个版本有问题，上线后无法运作， 更多的流
白话文解读HTTPS原理， 结合.NET Core聊一聊HTTPS应用方式
合格的web后端程序员，除搬砖技能，还必须会给各种web服务器配置Https，本文结合ASP.NET Core部署模型聊一聊启用Https的方式。 温故知新 目前常见的Http请求明文传输，请求可能被篡改，访问的站点可能被伪造。 HTTPS是HTTP加上TLS/SSL协议构建的可进行加密传输、身份认
【小作业】为NLog自定义LayoutRenderer
长话短说 前文《解剖HttpClientFactory，自由扩展HttpMessageHandler》主要讲如何为HttpClientFactory自定义HttpMessageHandler组件, 现在来完成课后的小作业： 将重点日志字段显示到Nlog的LayoutRenderer上。 本文实现一个
面试必谈的哈希，.Net 程序员温故而知新
引言问题 作为资深老鸟，有事没事，出去面试；找准差距、定位价值。 面试必谈哈希， Q1：什么是哈希? Q2：哈希为什么快? Q3：你是怎么理解哈希算法利用空间换取时间的？ Q4：你是怎么解决哈希冲突的？ Q5：你有实际用写过哈希算法吗？ 知识储备 哈希（也叫散列）是一种查找算法（可用于插入），哈希算
生产环境(基于docker)故障排除？ 有感于博客园三番五次翻车
前言 如题，有感于博客园最近多次翻车，感觉像胡子眉毛一把抓， 定位不了生产环境的问题。 抛开流程问题，思考在生产环境中如何做故障排除， 发现博客园里面这方面的文章比较少。 .Net 本身是提供了sos.dll工具帮助我们在生产中故障排除，通过提供有关内部公共语言运行时（CLR）环境的信息，
.NET架构开发应知应会
.NET程序是基于.NET Framework、.NET Core、Mono、【.NET实现】开发和运行的 ，定义以上【.NET实现】的标准规范称为.NET Standard .NET Standard .NET标准是一组API集合，由上层三种【.NET实现】的Basic Class Library
EF2.0新特性DbContext Pooling
长话短说 上个月公司上线了一个物联网数据科学项目，我主要负责前端接受物联网事件，并提供 参数下载。 webapp 部署在Azure云上，参数使用Azure SQL Server存储。 最近从灰度测试转向全量部署之后，日志时常收到： SQL Session超限报错。 排查 我在Azure上使用的是 S
修复搜狗、360等浏览器不识别SameSite=None 引起的单点登录故障
临近年关，搜狗，360浏览器出现页面无法成功跳转，同域Cookie丢失？ 也许是服务端 SameSite惹的祸。
本文揭示由于Chrome低版本内核不识别 SameSite= None， 引发的单点登录故障。
被忽略的TraceId，可以用起来了
本文聊一聊TraceID的作用和一般组成，衍生出ASP. NETCore 单体和分布式程序中 TraceId 的使用方式
解剖HttpClientFactory，自由扩展HttpMessageHandler
通过给 HttpClint请求的日志增加 TraceId，解锁自定义扩展 HttpClientFacroty 的姿势
pythonJavaScriptjavaHTMLPHPreactjsC#AndroidCSSNode.jssqlrpython-3.xMysqLjQueryc++pandasFlutterangularIOSdjangolinuxswifttypescript路由器JSON路由器设置无线路由器h3c华三华三路由器设置华三路由器电脑软件教程arraysdocker软件图文教程Cvue.jslaravelspring-boot