ASP.NET Core 应用发布与部署指南
2019-08-05

一、前言

本篇主要包含哪些内容?

    将项目发布到本地目录将项目传输到服务器并配置启动&开机自动启动将Nginx作为访问入口,配置反向代理

本篇环境信息

开发环境:
用途工具&版本
操作系统Windows 10
开发工具Visual Studio 2017(15.7.5)
SDK.NET Core SDK 2.1
传输工具FlashFxp
部署环境
用途工具&版本
Linux ServerCentOS 7
SDK.NET Core SDK 2.1
传输工具Vsftp
反向代理Nginx 1.12.2

准备工作

ASP.NET Core 示例项目
说明
SDK.NET Core SDK 2.1
项目模板ASP.NET Core Web App(MVC)
项目名称HelloWeb
解决方案名称HelloWeb
解决方案根目录D:ProjectsTestHelloWeb

项目创建完成后,需要修改Program.cs文件手动指定启动的Url为:http://*:5000

public class Program { public static void Main(string[] args) { CreateWebHostBuilder(args).Build().Run(); } public static IWebHostBuilder CreateWebHostBuilder(string[] args) => WebHost.CreateDefaultBuilder(args) .UseStartup<Startup>() .UseUrls("http://*:5000"); }

http://*:5000 可以兼容 http://localhost:5000http://127.0.0.1:5000http://所在机器ip:5000,方便我们部署到Linux Server后进行测试

CentOS 7 部署环境

CentOS 7虚拟机安装:https://ken.io/note/hyper-v-course-setup-centos

    部署FTP服务:https://ken.io/note/centos-quickstart-ftpserver部署 .NET Core SDK 2.1:https://ken.io/note/centos7-.netcore2.1-setup部署Nginx:https://ken.io/note/centos-quickstart-nginx-setup

二、发布到本地

1、命令行发布

在cmd命令行操作

#进入项目根目录(HelloWeb.csproj所在目录)d: && cd D:ProjectsTestHelloWebHelloWeb#执行publish命令dotnet publish -c release#dotnet publish -h可以查看publish可选参数#-c release 表示以Release方式进行编译

2、Visual Studio图形界面操作

在项目的鼠标右键菜单中选择:发布在左侧选择文件夹,并创建配置在发布操作面板中选择发布即可

3、本地运行测试

发布完成后,可以在D:ProjectsTestHelloWebHelloWebinReleaseetcoreapp2.1publish查看发布后的文件输出。

在cmd命令行操作:

#进入发布输出目录d: && cd D:ProjectsTestHelloWebHelloWebinReleaseetcoreapp2.1publish#启动应用dotnet HelloWeb.dll#启动成功会输出以下信息Hosting environment: ProductionContent root path: D:ProjectsTestHelloWebHelloWebinReleaseetcoreapp2.1publishNow listening on: http://[::]:5000Application started. Press Ctrl+C to shut down.

通过浏览器访问:localhost:5000,验证是否正常

三、部署

1、环境配置&启动测试

通过XShell连接到CentOS7服务器进行操作

创建站点目录并授权

#创建站点根目录sudo mkdir -p /webroot/helloweb#创建站点应用目录sudo mkdir -p /webroot/helloweb/app#创建站点日志目录sudo mkdir -p /webroot/helloweb/logs#目录授权sudo chmod 777 /webroot/helloweb/appsudo chmod 777 /webroot/helloweb/logs开放端口

#添加可访问端口sudo firewall-cmd --add-port=5000/tcp --permanent#重新加载防火墙策略sudo firewall-cmd --reload启动应用

通过FTP将传输到/webroot/helloweb/app

通过命令启动:

#进入app目录并通过dotnet命令启动站点cd /webroot/helloweb/app/dotnet HelloWeb.dll#启动成功后,将会输出:Hosting environment: ProductionContent root path: /webrootNow listening on: http://[::]:5000Application started. Press Ctrl+C to shut down.

这时候通过浏览器访问 http://{centos-ip}:5000即可

如果网站样式没有被正常加载,那应该是访问wwwroot下面的静态文件时404了。这是因为 ASP.NET Core默认是以命令执行所在的目录作为应用根目录读取文件的所以,一定要在HelloWeb.dll所在目录执行dotnet命令,不然会读取不到wwwroot目录下的静态文件

2、配置启动脚本

显示启动的方式,如果关闭XShell的连接窗口,那这个应用的进行就被关掉了。所以可以用nohup命令启动,脚本示例:

nohup dotnet HelloWeb.dll &

nohup由于是隐私启动,那应用的关闭就要找到进程id后才能关闭,所以还是干脆配置启动、停止脚本来操作更方便一些

创建启动脚本

创建start.sh文件

sudo vi /webroot/helloweb/start.sh

脚本内容:

#!/bin/shcd $(cd "$(dirname "$0")"; pwd)APP_NAME=HelloWeb.dllecho "start begin..."echo $APP_NAMEcd appnohup dotnet $APP_NAME >>../logs/info.log 2>>../logs/error.log &cd ..sleep 5if test $(pgrep -f $APP_NAME|wc -l) -eq 0then echo "start failed"else echo "start successed"fi创建停止脚本

创建stop.sh文件

sudo vi /webroot/helloweb/stop.sh

脚本内容:

#!/bin/shcd $(cd "$(dirname "$0")"; pwd)APP_NAME=HelloWeb.dllPROCESS=`ps -ef|grep $APP_NAME|grep -v grep |awk "{ print $2}"`while :do kill -9 $PROCESS > /dev/null 2>&1 if [ $? -ne 0 ];then break else continuefidoneecho "stop success!"脚本测试

#启动应用sh /webroot/helloweb/start.sh#启动成功输出start begin...HelloWeb.dllstart successed#停止应用sh /webroot/helloweb/stop.sh#停止成功后输出stop success!

开机启动&反向代理配置

1、配置开机启动

将停止脚本标记为可执行文件

sudo chmod +x /webroot/helloweb/stop.sh创建helloweb服务

#创建服务文件sudo vi /usr/lib/systemd/system/helloweb.service#文件内容[Unit]Description=hellowebAfter=network.target[Service]WorkingDirectory=/webroot/helloweb/appExecStart=/usr/bin/dotnet /webroot/helloweb/app/HelloWeb.dllExecStop=/webroot/helloweb/stop.shRestart=alwaysRestartSec=10[Install]WantedBy=multi-user.target

如果你配置了多个版本的.NET Core环境,记得把/usr/bin/dotnet换成对应的路径

设置服务开机启动&开启服务

#设置服务开机启动sudo systemctl enable helloweb#启动服务sudo systemctl start helloweb

2、Nginx反向代理配置

创建helloweb站点配置

#新建配置文件sudo vi /etc/nginx/conf.d/helloweb.conf#反向代理配置内容server { listen 80; #监听80端口 server_name helloweb.mydomain.com; #绑定的域名 location / { #转发或处理 proxy_pass http://localhost:5000; } error_page 500 502 503 504 /50x.html;#错误页 location = /50x.html { root /usr/share/nginx/html; }}重载NGINX配置

sudo nginx -s reload开放防火墙端口

#添加可访问端口sudo firewall-cmd --add-port=80/tcp --permanent#重新加载防火墙策略sudo firewall-cmd --reload访问测试:

通过设置本地hosts将helloweb.mydomain.com指向服务器IP

然后通过浏览器访问: helloweb.mydomain.com 即可

 

以上,如有疑问,欢迎联系我:https://ken.io/home/about

本文首次发布:2018-07-22本文原文链接:https://ken.io/note/asp.net-core-publish-deploy-guide