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


.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

安裝EPEL源

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

命令執行成功后, 刷新瀏覽器,可以看到如下界面:

supervisor正在運行的應用

當界面顯示running時,則表示我們我們剛剛配置的.net core應用運行起來了。

如下圖所示。

我們可以方便的通過supervisor提供的web管理界面對我們的應用進行啟動與停止,查看日志等操作,非常的方便,絲般潤滑般的爽呀。

Supervisor啟動與停止應用

查看日志:

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#RHEL-CentOS

安裝先決條件:

 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下的文件換行用的是\r\n,而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),及時了解最新動態。

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

微信號:guosisoft


免責聲明!

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



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