環境准備
下面我們使用VM虛擬機.我這里安裝的Linux系統是centos7
軟件提供:
VM: https://www.vmware.com/cn.html
centos7 Minimal :https://www.centos.org/download/
如果不會下載可以到我的百度網盤下載:由於避免某某東東不直接提供下載 請右上角加群索要
直接打開VM 選擇 文件打開 centos7鏡像文件(我是使用的我網盤制作的鏡像) 然后在配置內存網絡就行了如圖設置
選擇開啟系統
帳號: root
密碼:123123
注意這里linux不支持小鍵盤輸入
查看本機IP
安裝 .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 #最新版本請關注官網
注意你自己項目的版本
我選擇的項目版本是2.1.1
然后我執行的命令就是
sudo yum install dotnet-sdk-2.1
兩步即可完成 .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 系統(下文簡稱服務器)中。
程序發布過程省略(跟以前一樣選擇Release版本發布文件系統),把編譯后的程序發布到了本地 桌面\publish 文件夾
然后借助 FTP 工具 XFTP 把程序文件傳輸到服務器/home/wwwroot文件夾。
上傳截圖:

上傳完畢后,需要先通過cd
命令進入網站根目錄/home/wwwroot
,再輸入如下命令啟動網站程序:
dotnet WebApplication1.dll
如果在任意非站點根目錄,通過下面這種方式直接運行,程序會拋異常,不知是程序原因還是其他原因。
dotnet /home/wwwroot/WebApplication1.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 的默認轉發網頁則說明一切正常。如下截圖:
如果拒絕訪問,考慮服務器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
這里安裝可能會報錯Exiting on user cancel
這是yum的一個bug導致的問題。修改/usr/lib/python2.7/site-packages/urlgrabber/grabber.py
.
vi /usr/lib/python2.7/site-packages/urlgrabber/grabber.py elif errcode == 42: # this is probably wrong but ultimately this is what happens # we have a legit http code and a pycurl 'writer failed' code # which almost always means something aborted it from outside # since we cannot know what it is -I'm banking on it being # a ctrl-c. XXXX - if there's a way of going back two raises to # figure out what aborted the pycurl process FIXME raise KeyboardInterrupt
修改后
#elif errcode == 42: # this is probably wrong but ultimately this is what happens # we have a legit http code and a pycurl 'writer failed' code # which almost always means something aborted it from outside # since we cannot know what it is -I'm banking on it being # a ctrl-c. XXXX - if there's a way of going back two raises to # figure out what aborted the pycurl process FIXME # raise KeyboardInterrupt
然后以root用戶運行如下命令升級:
yum clean metadata
yum clean all
yum upgrade
升級完成后運行yum命令安裝即可。
可以看到,訪問的接口成功返回數據,證明 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
尾部找到如下文本片段:
;[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
創建文件
touch netcore.conf
接下來就需要為我們已經部署的 ASP .NET Core 程序的宿主進程創建一個進程配置文件netcore.conf
,保存並上傳到/etc/supervisor/conf.d
目錄。
配置文件netcore.conf
內容如下:
[program:WebApplication1] ;自定義進程名稱 command=dotnet WebApplication1.dll ;程序啟動命令 directory=/home/wwwroot ;命令執行的目錄 autostart=true ;在Supervisord啟動時,程序是否啟動 autorestart=true ;程序退出后自動重啟 startretries=5 ;啟動失敗自動重試次數,默認是3 startsecs=1 ;自動重啟間隔 user=root ;設置啟動進程的用戶,默認是root priority=999 ;進程啟動優先級,默認999,值小的優先啟動 stderr_logfile=/var/log/WebApplication1.err.log ;標准錯誤日志 stdout_logfile=/var/log/WebApplication1.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 服務器上的部署。