ASP.NET Core 應用發佈與部署指南/教程

目錄

一、前言

1、本教程主要包含哪些內容？

2、本篇環境信息

3、準備工作

二、發佈到本地

1、命令行發佈

2、Visual Studio圖形界面操作

3、本地運行測試

三、部署

1、環境配置&啓動測試

2、配置啓動&停止腳本

四、開機啓動&反向代理配置

1、配置開機啓動

2、Nginx反向代理配置

---

一、前言

1、本教程主要包含哪些內容？

1. 將ASP.NET Core項目發佈到本地目錄
2. 將ASP.NET Core項目發佈後傳輸到服務器並配置啓動
3. 將Nginx作爲訪問入口，配置反向代理

2、本篇環境信息

• 開發環境：

用途	工具&版本
操作系統	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

3、準備工作

• ASP.NET Core 示例項目

項	說明
SDK	.NET Core SDK 2.1
項目模板	ASP.NET Core Web App（MVC）
項目名稱	HelloWeb
解決方案名稱	HelloWeb
解決方案根目錄	D:\Projects\Test\HelloWeb

項目創建完成後，需要修改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-course-setup-centos

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

二、發佈到本地

1、命令行發佈

在cmd命令行操作

#進入項目根目錄（HelloWeb.csproj所在目錄）
d: && cd D:\Projects\Test\HelloWeb\HelloWeb

#執行publish命令
dotnet publish -c release

#dotnet publish -h可以查看publish可選參數
#-c release 表示以Release方式進行編譯

2、Visual Studio圖形界面操作

• 在項目的鼠標右鍵菜單中選擇：發佈

• 在左側選擇文件夾，並創建配置

• 在發佈操作面板中選擇發佈即可

3、本地運行測試

發佈完成後，可以在D:\Projects\Test\HelloWeb\HelloWeb\bin\Release\netcoreapp2.1\publish查看發佈後的文件輸出。

在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，驗證是否正常

三、部署

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/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目錄下的靜態文件

2、配置啓動&停止腳本

顯示啓動的方式，如果關閉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!

四、開機啓動&反向代理配置

1、配置開機啓動

• 將停止腳本標記爲可執行文件

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

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/note/asp.net-core-publish-deploy-guide