.NET Core部署到linux(CentOS)最全解決方案，進階篇(Supervisor+Nginx)

2021-01-21 12:00:35

在.NET Core部署到linux(CentOS)最全解決方案，常規篇一文，我們詳細講解了傳統的.NET Core部署到Linux伺服器的方法，學到了Linux在虛擬機器器下的安裝、Xshell,Xftp的使用方法、git在linux下的互動使用以及.net core在linux下的釋出與執行全過程。本文講講解通過使用Supervisor+Nginx的組合來實現.net core的高效部署。

1、Supervisor

1.1、Supervisor介紹

官網：http://supervisord.org，原始碼位置：https://github.com/Supervisor/supervisor

Supervisor是用Python開發的一套通用的程序管理程式，能將一個普通的命令列程序變為後臺daemon，並監控程序狀態，異常退出時能自動重啟。

它是通過fork/exec的方式把這些被管理的程序當作supervisor的子程序來啟動，這樣只要在supervisor的組態檔中，把要管理的程序的可執行檔案的路徑寫進去即可。也實現當子程序掛掉的時候，父程序可以準確獲取子程序掛掉的資訊的，可以選擇是否自己啟動和報警。supervisor還提供了一個功能，可以為supervisord或者每個子程序，設定一個非root的user，這個user就可以管理它對應的程序。

1.2、為什麼要用Supervisor

在linux或者unix作業系統中，守護行程（Daemon）是一種執行在後臺的特殊程序，它獨立於控制終端並且週期性的執行某種任務或等待處理某些發生的事件。由於在linux中，每個系統與使用者進行交流的介面稱為終端，每一個從此終端開始執行的程序都會依附於這個終端，這個終端被稱為這些程序的控制終端，當控制終端被關閉的時候，相應的程序都會自動關閉。但是守護行程卻能突破這種限制，它脫離於終端並且在後臺執行，並且它脫離終端的目的是為了避免程序在執行的過程中的資訊在任何終端中顯示並且程序也不會被任何終端所產生的終端資訊所打斷。它從被執行的時候開始運轉，直到整個系統關閉才退出。

此處的建立守護行程，是指釋出在Linux上 asp.net core 程式的dotnet xxx.dll命令的宿主程序建立一個守護行程。在 Linux 上有很多可以管理程序的工具，我們使用 Supervisor 來做這個事情。

原因有兩點：

①、它是微軟官方檔案推薦的，降低學習成本。
②、它並不一定是最好的，但一定是檔案最全的。

1.3、Supervisor4大元件

supervisord

主程序,負責管理程序的server，它會根據組態檔建立指定數量的應用程式的子程序，管理子程序的整個生命週期，對crash的程序重啟，對程序變化傳送事件通知等。同時內建web server和XML-RPC Interface，輕鬆實現程序管理。。該服務的組態檔在/etc/supervisor/supervisord.conf。

supervisorctl

使用者端的命令列工具，提供一個類似shell的操作介面，通過它你可以連線到不同的supervisord程序上來管理它們各自的子程式，命令通過UNIX socket或者TCP來和服務通訊。使用者通過命令列傳送訊息給supervisord，可以檢視程序狀態，載入組態檔，啟停程序，檢視程序標準輸出和錯誤輸出，遠端操作等。伺服器端也可以要求使用者端提供身份驗證之後才能進行操作。

Web Server

superviosr提供了web server功能，可通過web控制程序(需要設定[inethttpserver]設定項)

XML-R- #supervisor

一個Linux/Unix系統上的程序監控工具
一個Python開發的通用的程序管理程式
可以管理和監控Linux上面的程序
能將一個普通的命令列程序變為後臺daemon，並監控程序狀態，異常退出時能自動重啟
不過同daemontools一樣，它不能監控daemon程序

1.4、安裝Supervisor

相應安裝建議以管理員方式登入系統，非管理員請以sudo命令安裝。

Linux sudo命令以系統管理者的身份執行指令，也就是說，經由 sudo 所執行的指令就好像是 root 親自執行。

1、安裝EPEL源的命令如下：

sudo yum -y install epel-release

2、執行如下命令安裝supervisor：

sudo yum -y install supervisor

3、設定開機啟動：

systemctl enable supervisord

4、啟動supervisord

systemctl start supervisord

5、檢視supervisord狀態

systemctl status supervisord

1.5、Supervisor設定及使用

通過vi命令或者xftp修改組態檔開啟web介面存取，如下圖所示，分別取消inet_http_server等四個設定的註釋：

vi /etc/supervisord.conf

執行如下命令，重新載入組態檔：

supervisorctl reload

然後在瀏覽器開啟http://你的ip:9001，輸入上面我們設定的使用者名稱：user1,密碼:123456後，如圖所示：

看到上圖這個介面，就表示supervisor安裝完成了。

切換到/etc/supervisord.d目錄，在此目錄建立名稱為：core50test.ini的ini檔案，內容如下:

#表示程式名稱，用於在supervisor中顯示，無特殊意義。
[program:core50test] 
# 輸入執行命令，這裡表示執行的是dotnet Core50Test.dll
command=/bin/bash -c "dotnet Core50Test.dll"
# 應用程式根目錄 
directory=/root/app_data/core50test/publish
# 是否自動啟動，當 supervisor 載入該組態檔的時候立即啟動它 
autostart=true
# 是否自動重啟， 程式異常退出後自動重啟
autorestart=true
# 該組態檔輸出單個紀錄檔檔案的大小，預設50M
logfile_maxbytes=50MB
# 紀錄檔備份個數 
logfile_backups=10
# 記錄紀錄檔級別 
loglevel=info
# 指定標準輸出紀錄檔檔案 
stdout_logfile=/root/app_data/data/logs/core50test/core50test.out.log
# 環境變數
environment=ASPNETCORE_ENVIRONMENT=Production
# 啟動服務的使用者
user=root
# 把stderr重定向到stdout，預設 false
redirect_stderr=true

上述程式碼包含了註釋資訊，參考精減版設定如下：

[program:core50test]
command=/bin/bash -c "dotnet Core50Test.dll"
directory=/root/app_data/core50test/publish
autostart=true
autorestart=true
logfile_maxbytes=50MB
logfile_backups=10
loglevel=info
stdout_logfile=/root/app_data/data/logs/core50test/core50test.out.log
environment=ASPNETCORE_ENVIRONMENT=Production
user=root
redirect_stderr=true

注意：stdout_logfile指向的資料夾一定要先建立，否則無法啟動，上述組態檔中的內容需要根據使用者實際情況修改，如我當前登入的使用者是：yonghu，你們是其他的就做相應的修改即可。

然後執行如下命令來重新載入設定：

supervisorctl reload

命令執行成功後，重新整理瀏覽器，可以看到如下介面：

當介面顯示running時，則表示我們我們剛剛設定的.net core應用執行起來了。

如下圖所示。

我們可以方便的通過supervisor提供的web管理介面對我們的應用進行啟動與停止，檢視紀錄檔等操作，非常的方便，絲般潤滑般的爽呀。

檢視紀錄檔：

1.6、Supervisor常用命令

### 檢視supervisorctl支援的命令
# supervisorctl 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

### 檢視當前執行的程序列表
# supervisorctl status

update 更新新的設定到supervisord（不會重啟原來已執行的程式）
reload，載入所有組態檔，並按新的設定啟動、管理所有程序（會重啟原來已執行的程式）
start xxx: 啟動某個程序
restart xxx: 重啟某個程序
stop xxx: 停止某一個程序(xxx)，xxx為[program:theprogramname]裡設定的值
stop groupworker: 重啟所有屬於名為groupworker這個分組的程序(start,restart同理)
stop all，停止全部程序，注：start、restart、stop都不會載入最新的設定文
reread，當一個服務由自動啟動修改為手動啟動時執行一下就ok

最常用的幾個命令為：

#啟動所有
supervisorctl start all

# 重啟所有
supervisorctl restart all

# 停止所有
supervisorctl stop all

#PS:要操作某個服務，把all換成服務名即可
#檢視服務狀態
supervisorctl status

2、使用Nginx

在前面文章中，我們已經可以非常方便的對web應用進行部署與管理了，但還存在一個問題，我們的應用程式預設是繫結的5000埠，如果要指定80埠或者設定域名該怎麼處理呢？下面就該nginx登場了。

2.1、Nginx介紹

Nginx是一款輕量級的Web 伺服器/反向代理伺服器及電子郵件（IMAP/POP3）代理伺服器，在BSD-like 協定下發行。其特點是佔有記憶體少，並行能力強，事實上nginx的並行能力在同型別的網頁伺服器中表現較好，中國大陸使用nginx網站使用者有：百度、京東、新浪、網易、騰訊、淘寶等。

2.2、Nginx安裝

安裝方式參考：http://nginx.org/en/linux_packages.html

安裝先決條件：

 sudo yum install -y yum-utils

設定yum儲存庫，先建立一下內容的檔案：/etc/yum.repos.d/nginx.repo

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

預設情況下，使用穩定 nginx 包的儲存庫。如果要使用主線 nginx 包，請執行以下命令：

 yum-config-manager --enable nginx-mainline

執行如下命令安裝nginx：

 sudo yum install -y nginx

設定開機啟動：

systemctl enable nginx

啟動nginx：

 systemctl start nginx

此時，就可以在瀏覽器通過ip存取了：http://你的ip，介面如下：

2.3、Nginx部署

nginx安裝完成後，切換到/etc/nginx/conf.d目錄，修改default.conf檔案內容，如下所示：

server {
    listen       80;
    server_name  localhost;
    location / {
        proxy_pass http://0.0.0.0:5000;
    }
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }
}

儲存後，執行如下命令，重新載入設定：

nginx -s reload

然後再次存取http://你的ip，一切正常的話應該可以看到如下的介面，表示我們的.NET Core程式已經完美執行在linux系統了。

如果部署後遇到型別下面這樣的錯誤

出現這樣的問題，有可能的是因為SeLinux的限制，執行如下命令之後，再重新整理頁面：

setenforce 0

selinux(security enhanced linux)安全增強型linux系統，它是一個linux核心模組，也是linux的一個安全子系統。

selinux的主要作用就是最大限度地減小系統中服務程序可存取的資源（最小許可權原則）

如果設定後還是不能解決，可以檢視nginx的紀錄檔了，預設的紀錄檔路徑為：/var/log/nginx

通過setenforce 0命令，只是臨時實效，重啟後會失效。

可以通過修改/etc/selinux/config 檔案，將SELINUX=enforcing改為SELINUX=disabled，然後重啟，即可永久生效。

通過近兩篇文章的介紹，我們需要更新應用，只需要將程式碼提交到git倉庫，然後在伺服器中執行git pull和dotnet publish即可。

如果熟悉shell的話，可以通過編寫shell命令一鍵執行應用程式的更新，程式碼範例：

# !/bin/bash
cd /root/app_data/source/core50test
git pull
dotnet publish -o /root/app_data/core50test/publish
supervisorctl restart core50test

將上述的程式碼儲存為sh檔案，上傳到伺服器，並設定許可權。如下圖所示：

程式碼提交到git倉庫後，執行如下命令：

./build.sh

執行結果如下圖所示：

更新後重新執行，已經更新。

這兒可能有的小夥伴會遇到一個小小的坑要注意，shell指令碼寫得沒有問題，執行會報類似這樣的錯誤

$'r':command not found

出現這種問題是因為windows下的檔案換行用的是rn，而linux系統用的是n，如果在win下的檔案上傳到linux，就有可能出現這樣的問題，只需用vi開啟shell指令碼檔案，然後使用命令:set ff=unix，儲存檔案即可。

supervisor一個作為守護執行緒，用於維護應用程式的生命週期的，nginx則是作為反向代理使用，設定shell可以做到高效部署，非常的方便。

一路走來數個年頭，感謝RDIFramework.NET框架的支援者與使用者，大家可以通過下面的地址瞭解詳情。

RDIFramework.NET官方網站：http://www.rdiframework.net/

RDIFramework.NET官方部落格：http://blog.rdiframework.net/

特別說明，框架相關的技術文章請以官方網站為準，歡迎大家收藏！

RDIFramework.NET框架由海南國思軟體科技有限公司專業團隊長期打造、一直在更新、一直在升級，請放心使用！

歡迎關注RDIFramework.NET框架官方微信公眾號（微訊號：guosisoft），及時瞭解最新動態。

使用微信掃描二維條碼立即關注