正文 

当前位置： 首页 > 开发 > java教程

asp.netcore在centos上的最小化部署实践(代码片段)

lonelyxmas lonelyxmas     2022-12-05     431

关键词：

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

引言

       本文从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 [email protected]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"

部署在 IIS 上的 ASP.NET Core 对长时间运行的请求返回 502 错误

】部署在IIS上的ASP.NETCore对长时间运行的请求返回502错误【英文标题】：ASP.NETCoredeployedonIISreturns502Errorforlongrunningrequests【发布时间】：2018-02-1915:41:28【问题描述】：我有一个ASP.NETCore2Web应用程序，它托管在WindowsServer2012上的IIS10... 查看详情

先定一个小目标asp.netcore在iis上的托管运行

1.安装.NETCoreFramework 下载.netcore地址：官网地址2.InstallIIS在控制面板->程序与功能-》InternetInfomationServices3.站点部署　　实例: https://github.com/aspnet/mvc　　在IIS管理器，新建站点->物理路径Path:为项目的根目录。　网站绑... 查看详情

iis在asp.netcore下的两种部署模式(代码片段)

KestrelServer最大的优势体现在它的跨平台的能力，如果ASP.NETCORE应用只需要部署在Windows环境下，IIS也是不错的选择。ASP.NETCORE应用针对IIS具有两种部署模式，它们都依赖于一个IIS针对ASP.NETCORECore的扩展模块。KestrelServer最大的优势... 查看详情

asp.netcore在iis下的两种部署模式

...relServer最大的优势体现在它的跨平台的能力，如果ASP.NETCORE应用只需要部署在Windows环境下，IIS也是不错的选择。ASP.NETCORE应用针对IIS具有两种部署模式，它们都依赖于一个IIS针对ASP.NETCORECore的扩展模块。一、ASP.NETCORECo... 查看详情

linux中以单容器部署nginx+asp.netcore

...转发请求到KestrelHttp服务器，本文将会实践将Nginx--->ASP.NETCore部署架构容器化的过程。 Nginx->ASP.NETCoe部署架构容器化　　在Docker中部署Nginx--->ASP.NETCore有两种选择，第一种是在单容器内部署Nginx+ASP.NETCore,这是本文着 查看详情

asp.netcore部署手册：2.hyper-v虚拟机

为什么要把虚拟机纳入到ASP.NETCore部署手册中？在.NETFramework时期，我们只用将应用程序部署到Windows操作系统中，甚至是在测试阶段或演示阶段我们可以把应用程序部署在本机的IIS中即可。而如今对于跨平台的.NETCore而言，我们的... 查看详情

asp.netcore部署手册：3.windows篇

“don'tworry”，部署ASP.NETCore应用可以和原来部署.NETFramework的ASP.NET应用一样的简单，还是“熟悉的配方，熟悉的味道”，甚至提供了更加便捷的Kestrel部署方式，下面主要介绍在windows平台下两种常用部署方式：方式一：Kestrel部... 查看详情

如何把asp.netcore的文件作为服务在windows下面部署

把Asp.netcore在Linux部署遭遇到部分库无法使用的情况，我决定吧asp.netcore部署到Windows服务器上。但是如果当做传统的ASP.net文件来部署，发现行不通。网上讲了很多的操作步骤，但是得重启服务器，懒得重启了。直... 查看详情

asp.netcore部署提示dataprotectionservices错误

 今天在部署asp.netcore网站时，因为调用到阿里云的api，api的参数需要加密签名，系统报出了如下错误：  warn:Microsoft.Extensions.DependencyInjection.DataProtectionServices[59]NeitheruserprofilenorHKLMregistryavailable.Usinganephe 查看详情

asp.netcore在azurekubernetesservice中的部署和管理(代码片段)

目录ASP.NETCore在AzureKubernetesService中的部署和管理目标准备工作注册Azure账户AKS文档进入Azure门户（控制台）安装AzureCli安装Docker进入正题资源组创建资源组删除资源组容器注册表AzureContainerRegister(ACR)创建ACR登录ACR服务主体serviceprinc... 查看详情

asp.netcore部署系列一：发布到iis上

前言： 当构建一个ASP.NETCore应用程序并且计划将其运行在IIS中时，你会发现Core应用程序和之前版本的ASP.NET程序在IIS中的运行方式是完全不一样的。与ASP.NET时代不同，ASP.NETCore不再是由IIS工作进程（w3wp.exe）托管，而是使用自... 查看详情

用nssm把.netcore部署至windows服务

为什么部署至WindowsServices在很多情况下，很少会把.NetCore项目部署至Windows服务中，特别是Asp.netCore就更少了。一般情况下，Asp.netCore会部署至linux服务器，或者部署至Windows的IIS中。但也不排除会有Asp.netCore部署至Windows服务中的情... 查看详情

.netcore项目在iis中部署

 本文实例环境及版本Win10、.NetCore3.1一、概述与ASP.NET时代不同，ASP.NETCore不再是由IIS工作进程（w3wp.exe）托管，而是使用自托管Web服务器（Kestrel）运行，IIS则是作为反向代理的角色转发请求到Kestrel不同端口的ASP.NETCore程序中... 查看详情

asp.netcore快速入门-在centos上安装nginx(代码片段)

第一步：添加CentOS7EPEL库 在终端运行一下命令sudoyuminstallepel-release 第二步：安装Nginx在终端运行命一下sudoyuminstallnginx你回答“yes”的提示后，nginx会完成安装到你的虚拟专用服务器（VPS） 第三步：启动Nginxsudosyst... 查看详情

解决asp.netcore部署到iis，更新项目"另一个程序正在使用此文件，进程无法访问"(代码片段)

问题：部署到IIS上的ASP.NETCore项目，在更新的时候会进程占用的错误 初步解决方案：1，关闭应用程序池2，关闭网站3，更新项目缺点：网站没法访问，部署项目停的时间过长 查询官方文档后，官方给出的方案： 结合... 查看详情

linux系统(ubuntu)部署asp.netcore网站(代码片段)

一、前言　　亲自动手尝试部署.NetCore在Linux，看了不少文章，感觉是很简单，但是做下去也会有很多问题，今天就写个文章记录下来。二、环境安装　　 虚拟机（VMware），在网上找就行。　　地址：https://download3.vmware.com/sof... 查看详情

你真的了解asp.netcore部署模型吗？(代码片段)

原文:你真的了解ASP.NETCore部署模型吗？ ----------------------------   以下内容针对ASP.NETCore2.1，2.2出现IIS进程内寄宿暂不展开讨论--------------------------      相比ASP.NET，ASP.NETCore 查看详情

asp.netcore读写任意文件

参考技术AASP.NETCore是一个免费的，开源的，高性能，轻量级且跨平台的框架，用于构建基于云的应用程序，例如Web应用程序，IoT应用程序和移动后端。它旨在在云和本地环境中运行。与.NETCore一样，它以最小的开销进行模块化设... 查看详情