使用 Nginx 在 Linux 上托管 ASP.NET Core 應用程序


本文於2019年04月10日將標題「CentOS7 部署 ASP.NET Core應用程序」修改為「使用 Nginx 在 Linux 上托管 ASP.NET Core 應用程序」。

環境准備

虛擬機安裝、系統鏡像配置過程,大家參考網上教程應該沒啥問題,我這不再贅述。

成功安裝並登陸 CentOS 7 Minimal 系統后,發現無法上網,后來搜索找到原因:CentOS 7 Minimal 默認沒有啟動網絡配置。

接下來就通過vi命令編輯網卡配置文件ifcfg-ens33(其他版本名稱可能略有不同,但路徑一致)。具體命令如下:

vi /etc/sysconfig/network-scripts/ifcfg-ens33

ONBOOT=no改為ONBOOT=yes,設置隨系統開機運行。然后:wq強制保存並退出編輯文件即可。

最后,需要重啟一下網絡服務。命令如下:

service network restart

目前應該可以上網了,可以嘗試用命令ping www.baidu.com來檢查下網絡是否通暢。

如上圖,可以接收響應,證明網絡暢通。反之,證明你的網絡還是不通,就需要考慮其他原因了。

暫時還沒有安裝 VMware Tools,直接在虛擬機中編(復)寫(制)命令非常不便,這里可以通過連接工具 PuTTY 在Window系統中連接虛擬機中的 CentOS 系統,連接服務器也同樣適用。

軟件截圖:

選擇SSH連接協議,輸入 CentOS 系統 IP 地址,點擊【Open】按鈕連接。輸入系統用戶名密碼即可登錄系統。

問:怎么知道虛擬機中 CentOS 系統的 IP 地址呢?

答:可以通過ifconfig命令來獲取系統的IP地址。說明一點,因為這里我選的是 CentOS 7 Minimal 最小化安裝,需要聯網后先執行命令yum install net-tools下載網絡工具包,然后才能使用ifconfig命令。

安裝 .NET Core SDK

Linux各個發行版如何安裝 .NET Core SDK,微軟官方已經給出了標准答案,我這里就把在 CentOS 上的安裝方法做一個簡要說明。

Step1:安裝 dotnet 產品提要

要開始安裝 .NET,您需要注冊 Microsoft 簽名密鑰並添加 Microsoft 產品提要。每台機器只需要做一次。 打開命令提示符並運行以下命令:

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[packages-microsoft-com-prod]\nname=packages-microsoft-com-prod \nbaseurl= https://packages.microsoft.com/yumrepos/microsoft-rhel7.3-prod\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/dotnetdev.repo'

Step2:安裝 .NET SDK

更新可用於安裝的產品,安裝 .NET 所需的組件,然后安裝 .NET SDK。
在命令提示符下,運行以下命令:

sudo yum update
sudo yum install libunwind libicu
sudo yum install dotnet-sdk-2.1.3  #最新版本請關注官網

兩步即可完成 .NET Core SDK 在 CentOS7 系統下的安裝,最后可執行一下命令dotnet --version,如果正常輸出版本號則說明安裝沒有出現問題。

Linux 其他發行版安裝 .NET Core SDK 教程請參見官方教程 Get started with .NET in 10 minutes

部署 ASP.NET Core 應用程序

下面就嘗試把我用 ASP.NET Core Web API 開發的一個接口網站部署到我們已經安裝 .NET SDK 的 CentOS 系統(下文簡稱服務器)中。

程序發布過程省略,把編譯后的程序發布到了本地F:\wwwroot\Scorpio文件夾。

然后借助 FTP 工具 FileZilla 把程序文件傳輸到服務器/home/wwwroot/scorpio文件夾。

上傳截圖:

上傳完畢后,需要先通過cd命令進入網站根目錄/home/wwwroot/scorpio/,再輸入如下命令啟動網站程序:

dotnet Scorpio.WebApi.dll 

如果在任意非站點根目錄,通過下面這種方式直接運行,程序會拋異常,不知是程序原因還是其他原因。

dotnet /home/wwwroot/scorpio/Scorpio.WebApi.dll 

如果你可以看到如下界面則表示程序啟動成功。

Nginx 配置反向代理

Nginx 是一個高性能的Web服務器軟件。這是一個比 Apache HTTP Server 更加靈活和輕量級的程序。

我們的網站程序啟動的端口是5000,可以借助 Nginx 把程序5000端口映射到80端口。

Nginx官方文檔 & Nginx開發從入門到精通 - Tengine

安裝 Nginx

首先,我們需要在服務器上安裝 Nginx。

Step1:添加 Nginx 存儲庫

要添加 CentOS 7 EPEL 倉庫,請打開終端並使用以下命令:

sudo yum install epel-release

Step2:安裝 Nginx

現在 Nginx 存儲庫已經安裝在您的服務器上,請使用以下yum命令安裝 Nginx:

sudo yum install nginx

Step3:啟動 Nginx

Nginx 不會自行啟動。要運行 Nginx,請輸入:

sudo systemctl start nginx

如果您正在運行防火牆,請運行以下命令以允許 HTTP 和 HTTPS 通信:

sudo firewall-cmd --permanent --zone=public --add-service=http 
sudo firewall-cmd --permanent --zone=public --add-service=https
sudo firewall-cmd --reload

此時,可以在本機的瀏覽器中訪問服務器的 IP 地址http://192.168.83.128來驗證 Nginx 是否成功運行。

如果能看到 Nginx 的默認轉發網頁則說明一切正常。如下截圖:

Nginx

如果拒絕訪問,考慮服務器80端口是否開放。可嘗試通過下面兩條命令開放80端口、重啟防火牆使修改即時生效。

firewall-cmd --zone=public --add-port=80/tcp --permanent
systemctl restart firewalld

設置 Nginx 開機啟動

避免開機需要手動開啟 Nginx,可以通過如下快捷命令把 Nginx 配置成系統服務,並設置為開機啟動:

systemctl enable nginx  #設置開機啟動

其他命令:

systemctl disable nginx   #禁止開機啟動
systemctl status nginx     #查看運行狀態
systemctl restart nginx    #重啟服務

修改 Nginx 配置文件

首先,拿到 Nginx 的默認配置文件/etc/nginx/nginx.conf,把默認80端口轉發配置server節點用#符注釋掉。

然后,我們新建一個配置文件netcore.conf,內容如下:

server {
    listen 80;
    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;
    }
}

保存並上傳到 Nginx 的配置加載目錄/etc/nginx/conf.d,最后執行命令nginx -s reload重載 Nginx 配置,使其生效。

在本地瀏覽器上訪問服務器地址,運行結果如下:

這個問題是由於 SELinux 保護機制所導致,我們需要將 Nginx 添加至 SELinux 的白名單。執行命令:

yum install policycoreutils-python

sudo cat /var/log/audit/audit.log | grep nginx | grep denied | audit2allow -M mynginx

sudo semodule -i mynginx.pp

再次訪問,運行結果如下:

可以看到,訪問的接口成功返回數據,證明 Nginx 已經完成對我們部署應用程序的轉發。

Supervisor 配置守護進程

Supervisor 是用 Python 開發的 Linux/Unix 系統下的一個進程管理工具。它可以使進程脫離終端,變為后台守護進程(daemon)。實時監控進程狀態,異常退出時能自動重啟。

Supervisor 不支持任何版本的 Window 系統;僅支持在 Python2.4 或更高版本,但不能在任何版本的 Python 3 下工作。

其主要組成部分:

supervisord:Supervisor 的守護進程服務,用於接收進程管理命令;

supervisorctl:Supervisor 命令行工具,用於和守護進程通信,發送管理進程的指令;

Web Server:Web 端進程管理工具,提供與 supervisorctl 類似功能,管理進程;

XML-RPC Interface:提供 XML-RPC 接口,請參閱 XML-RPC API文檔

安裝 Supervisor

聯網狀態下,官方推薦首選安裝方法是使用easy_install,它是setuptools(Python 包管理工具)的一個功能。所以先執行如下命令安裝 setuptools:

yum install python-setuptools

請更換root用戶,執行如下命令安裝 Supervisor:

easy_install supervisor

配置 Supervisor

運行supervisord服務的時候,需要指定 Supervisor 配置文件,如果沒有顯示指定,默認會從以下目錄中加載:

$CWD/supervisord.conf  #$CWD表示運行 supervisord 程序的目錄
$CWD/etc/supervisord.conf
/etc/supervisord.conf
/etc/supervisor/supervisord.conf (since Supervisor 3.3.0)
../etc/supervisord.conf (Relative to the executable)
../supervisord.conf (Relative to the executable)

所以,先通過如下命令創建目錄,以便讓 Supervisor 成功加載默認配置:

mkdir /etc/supervisor

加載目錄有了,然后通過echo_supervisord_conf程序(用來生成初始配置文件)來初始化一個配置文件:

echo_supervisord_conf > /etc/supervisor/supervisord.conf

打開supervisord.conf文件,可以看到echo_supervisord_conf已經幫我們初始化好了一個樣例配置,我們需要簡單修改一下。

尾部找到如下文本片段:

;[include]
;files = relative/directory/*.ini

改為:

[include]
files = conf.d/*.conf

即,把注釋去除、設置/etc/supervisor/conf.d為 Supervisor 進程配置文件加載目錄。

這樣,Supervisor 會自動加載該目錄下.conf后綴的文件作為共同服務配置。Supervisor 管理的每個進程單獨寫一個配置文件放在該目錄下,supervisord.conf配置文件中保留公共配置。

創建進程配置加載目錄:

mkdir /etc/supervisor/conf.d

接下來就需要為我們已經部署的 ASP .NET Core 程序的宿主進程創建一個進程配置文件netcore.conf,保存並上傳到/etc/supervisor/conf.d目錄。

配置文件netcore.conf內容如下:

[program:Scorpio.WebApi]                 		;自定義進程名稱
command=dotnet Scorpio.WebApi.dll 		 		;程序啟動命令
directory=/home/wwwroot/scorpio			 		;命令執行的目錄
autostart=true 								    ;在Supervisord啟動時,程序是否啟動
autorestart=true 								;程序退出后自動重啟
startretries=5       							;啟動失敗自動重試次數,默認是3
startsecs=1 									;自動重啟間隔
user=root   							        ;設置啟動進程的用戶,默認是root
priority=999         							;進程啟動優先級,默認999,值小的優先啟動
stderr_logfile=/var/log/Scorpio.WebApi.err.log  ;標准錯誤日志
stdout_logfile=/var/log/Scorpio.WebApi.out.log  ;標准輸出日志
environment=ASPNETCORE_ENVIRONMENT=Production   ;進程環境變量
stopsignal=INT								    ;請求停止時用來殺死程序的信號

啟動 Supervisor 服務,命令如下:

supervisord -c /etc/supervisor/supervisord.conf

這時,在會發現我們部署的網站程序不在 shell 中通過dotnet xxx.dll啟動,同樣可以訪問。

設置 Supervisor 開機啟動

首先為 Supervisor 新建一個啟動服務腳本supervisor.service,然后保存並上傳至服務器/usr/lib/systemd/system/目錄。

腳本內容如下:

# supervisord service for systemd (CentOS 7.0+)
# by ET-CS (https://github.com/ET-CS)
[Unit]
Description=Supervisor daemon

[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisor/supervisord.conf
ExecStop=/usr/bin/supervisorctl $OPTIONS shutdown
ExecReload=/usr/bin/supervisorctl $OPTIONS reload
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target

設置開啟啟動:

systemctl enable supervisor

驗證是否成功:

systemctl is-enabled supervisor

如果輸出enabled則表示設置成功,也可重啟服務器驗證。

其它 Linux 發行版開機啟動腳本 User-contributed OS init scripts for Supervisor

Supervisorctl 管理進程

Supervisor 服務啟動后,受其管理的進程會在后台運行。可以通過supervisorctl客戶端管理進程。

輸入如下命令進入supervisorctl交互終端,按Ctrl+C鍵退出:

supervisorctl

輸入help查詢幫助:

supervisor> help

default commands (type help <topic>):
=====================================
add    exit      open  reload  restart   start   tail
avail  fg        pid   remove  shutdown  status  update
clear  maintail  quit  reread  signal    stop    version

輸入help ****查詢詳細命令,比如輸入help stop

supervisor> help stop

stop <name>             Stop a process
stop <gname>:*          Stop all processes in a group
stop <name> <name>      Stop multiple processes or groups
stop all                Stop all processes

如何啟動、停止、重啟進程等命令,我這里就不在記錄,大家自行查找吧。

除此之外,Supervisor 還提供了 Web 管理界面用來管理進程,如何配置啟動請參考官方文檔。

至此,我們已經完成了 ASP.NET Core 應用程序在 CentOS7 服務器上的部署。

相關閱讀


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM