ASP.NET Core 应用发布与部署指南

1、前言

本篇主要包含哪些内容？

1. 将项目发布到本地目录
2. 将项目传输到服务器并配置启动
3. 将Nginx做为访问入口，配置反向代理

本篇环境信息

• 开发环境：

用途	工具&版本
操做系统	Windows 10
开发工具	Visual Studio 2017（15.7.5）
SDK	.NET Core SDK 2.1
传输工具	FlashFxp

• 部署环境

用途	工具&版本
Linux Server	CentOS 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:5000，http://127.0.0.1:5000，http://所在机器ip:5000，方便咱们部署到Linux Server后进行测试

• CentOS 7 部署环境

CentOS 7虚拟机安装：https://ken.io/note/hyper-v-c...

1. 部署FTP服务：https://ken.io/note/centos-qu...
2. 部署 .NET Core SDK 2.1：https://ken.io/note/centos7-....
3. 部署Nginx：https://ken.io/note/centos-qu...

2、发布到本地

一、命令行发布

在cmd命令行操做

#进入项目根目录（HelloWeb.csproj所在目录）
d: && cd D:\Projects\Test\HelloWeb\HelloWeb

#执行publish命令
dotnet publish -c release

#dotnet publish -h能够查看publish可选参数
#-c release 表示以Release方式进行编译

二、Visual Studio图形界面操做

• 在项目的鼠标右键菜单中选择：发布

• 在左侧选择文件夹，并建立配置

• 在发布操做面板中选择发布便可

三、本地运行测试

发布完成后，能够在D:ProjectsTestHelloWebHelloWebbinReleasenetcoreapp2.1publish查看发布后的文件输出。

在cmd命令行操做：

#进入发布输出目录
d: && cd D:\Projects\Test\HelloWeb\HelloWeb\bin\Release\netcoreapp2.1\publish

#启动应用
dotnet HelloWeb.dll

#启动成功会输出如下信息
Hosting environment: Production
Content root path: D:\Projects\Test\HelloWeb\HelloWeb\bin\Release\netcoreapp2.1\publish
Now listening on: http://[::]:5000
Application started. Press Ctrl+C to shut down.

经过浏览器访问：localhost:5000，验证是否正常

3、部署

一、环境配置&启动测试

经过XShell链接到CentOS7服务器进行操做

• 建立站点目录并受权

#建立站点根目录
sudo mkdir -p /webroot/helloweb

#建立站点应用目录
sudo mkdir -p /webroot/helloweb/app

#建立站点日志目录
sudo mkdir -p /webroot/helloweb/logs

#目录受权
sudo chmod 777 /webroot/helloweb/app
sudo 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: Production
Content root path: /webroot
Now listening on: http://[::]:5000
Application started. Press Ctrl+C to shut down.

这时候经过浏览器访问 http://<centos-ip>:5000便可

若是网站样式没有被正常加载，那应该是访问wwwroot下面的静态文件时404了。
这是由于 ASP.NET Core默认是以命令执行所在的目录做为应用根目录读取文件的
因此，必定要在HelloWeb.dll所在目录执行dotnet命令，否则会读取不到wwwroot目录下的静态文件

二、配置启动脚本

显示启动的方式，若是关闭XShell的链接窗口，那这个应用的进行就被关掉了。因此能够用nohup命令启动，脚本示例：

nohup dotnet HelloWeb.dll &

nohup因为是隐私启动，那应用的关闭就要找到进程id后才能关闭，因此仍是干脆配置启动、中止脚原本操做更方便一些

• 建立启动脚本

建立start.sh文件

sudo vi /webroot/helloweb/start.sh

脚本内容:

#!/bin/sh
cd $(cd "$(dirname "$0")"; pwd)
APP_NAME=HelloWeb.dll
echo "start begin..."
echo $APP_NAME

cd app
nohup  dotnet $APP_NAME >>../logs/info.log 2>>../logs/error.log &
cd ..

sleep 5

if test $(pgrep -f $APP_NAME|wc -l) -eq 0
then
   echo "start failed"
else
   echo "start successed"
fi

• 建立中止脚本

建立stop.sh文件

sudo vi /webroot/helloweb/stop.sh

脚本内容：

#!/bin/sh
cd $(cd "$(dirname "$0")"; pwd)
APP_NAME=HelloWeb.dll

PROCESS=`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
   continue
fi
done

echo 'stop success!'

• 脚本测试

#启动应用
sh /webroot/helloweb/start.sh

#启动成功输出
start begin...
HelloWeb.dll
start successed

#中止应用
sh /webroot/helloweb/stop.sh

#中止成功后输出
stop success!

4、开机启动&反向代理配置

一、配置开机启动

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

sudo chmod +x /webroot/helloweb/stop.sh

• 建立helloweb服务

#建立服务文件
sudo vi /usr/lib/systemd/system/helloweb.service

#文件内容
[Unit]
Description=helloweb
After=network.target

[Service]
WorkingDirectory=/webroot/helloweb/app
ExecStart=/usr/bin/dotnet /webroot/helloweb/app/HelloWeb.dll
ExecStop=/webroot/helloweb/stop.sh
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

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

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

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

#启动服务
sudo systemctl start helloweb

二、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/note/asp.net-c...