在.NET Core部署到linux(CentOS)最全解決方案,常規篇一文,我們詳細講解了傳統的.NET Core部署到Linux伺服器的方法,學到了Linux在虛擬機下的安裝、Xshell,Xftp的使用方法、git在linux下的交互使用以及.net core在linux下的發佈與運行全過程。... ...
在.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#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可以做到高效部署,非常的方便。
作者|國思軟體
本文來自博客園,作者:古道輕風,轉載請註明原文鏈接:https://www.cnblogs.com/88223100/p/The-most-comprehensive-solution-for-deploying-NET-Core-to-Linux-CentOS-Advanced-Supervisor_Nginx.html