系列目錄

一、概述

本篇討論如何把專案釋出到Linux環境，主要包括以下內容：

1、專案打包

2、配置Nginx轉發

3、配置守護服務Supervisor

在介紹實際內容前，有兩個疑問需要探討一下：

1、我們的專案釋出後可以自宿主執行，為什麼要配置nginx轉發？

答：nginx是專業的網路伺服器，功能強大，可以幫忙處理靜態資源、SSL等。（簡單來說就是Kestrel沒有nginx、IIS等專業）

官方解釋：Kestrel is great for serving dynamic content from ASP.NET Core. However, the web serving capabilities aren't as feature rich as servers such as IIS, Apache, or Nginx. A reverse proxy server can offload work such as serving static content, caching requests, compressing requests, and SSL termination from the HTTP server. A reverse proxy server may reside on a dedicated machine or may be deployed alongside an HTTP server.

2、為什麼要配置守護服務？

答：這個問題比較簡單，我們的程式可能沒有那麼健壯，如果程序意外終止了，守護程序可以自動重新啟動程序。

二、打包與釋出

利用VS 2017釋出專案非常簡單，執行釋出命令即可。需要注意的是saleservice.xml檔案不會被髮布，需要手動拷貝到釋出目錄，有個簡單的辦法，我把釋出的路徑從PublishhOutput 改成bin\Release\netcoreapp2.0\，Release模式編譯一下再發布就可以，不過這不是什麼大問題。

將釋出目錄copy到目標伺服器，執行以下程式碼啟動程式：

# dotnet SaleService.dll

通過執行   # curl http://localhost:5000/api/products   可以檢視程式是否執行成功。

由於系統預設監聽localhost:5000這個地址，所以即使防火牆開通了5000埠，外部也是無法通過IP來訪問的。需要增加以下程式碼來處理：

        public static IWebHost BuildWebHost(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseStartup<Startup>()
                .UseUrls("http://*:5000")
                .Build();

當然，如果我們要通過nginx代理訪問專案，並不會通過伺服器IP來訪問，上面步驟就不需要。

在除錯專案時，我們在launchSettings.json中設定了啟動頁面，但專案部署後，這個配置不會有效果，如果希望輸入 http://localhost:5000 就跳轉到指定頁面，需要做如下處理：

修改app.UseMvcWithDefaultRoute()

//app.UseMvcWithDefaultRoute();            
app.UseMvc(routes => routes.MapRoute(name: "default", template: "{controller=Account}/{action=Index}/{id?}"));　

增加一個Controller

public class AccountController : Controller
    {
        
        public ActionResult Index()
        {
            return Redirect("/index.html");
        }
 }

三、配置Nginx代理

1、安裝

# rpm -Uvh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
# yum install nginx

2、配置

執行命令：

#vi /etc/nginx/conf.d/default.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和專案。

此時應該可以通過 http://192.168.0.110/api/product 來訪問專案，實際訪問時，頁面報錯：

這個問題是由於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

 如果通過localhost可以訪問，通過IP訪問報404錯誤，請注意確認防火牆是否開啟。

四、跨域訪問的問題

跨域是指從一個域名的網頁去請求另一個域名的資源，跨域的嚴格一點的定義是：只要 協議，域名，埠有任何一個的不同，就被當作是跨域。
在前端的Ajax程式碼中我們把localhost改成了伺服器的IP：

 $("#query").click(function (event) {
                $.getJSON("http://192.168.109.131/api/products",
                    function (result) {
                        });
                    });
         

此時原來正常的程式會報錯：No 'Access-Control-Allow-Origin' header is present on the requested resource

處理辦法：

 public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();
            services.AddCors();          
        }

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        { 
            app.UseCors(builder => builder.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader().AllowCredentials());
           
            app.UseMvcWithDefaultRoute();
            app.UseStaticFiles();
        }

其中services.AddCors()可以不用加，WebHost.CreateDefaultBuilder已經加了。

五、配置守護程序

1、 安裝Supervisor

# yum install python-setuptools
# easy_install supervisor

2、 配置Supervisor

# mkdir /etc/supervisor
# echo_supervisord_conf > /etc/supervisor/supervisord.conf
# vi /etc/supervisor/supervisord.conf

 在檔案底部增加：

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

 在/etc/supervisor建一個conf.d的資料夾，在其下新建一個saleservice.ini檔案，內容如下：

[program:SaleService]
directory=/home/PublishOutput/ ; 命令執行的目錄
command=dotnet SaleService.dll ; 執行程式的命令
autorestart=true ; 程式意外退出是否自動重啟
stdout_logfile=/var/log/SaleService.out.log ; 輸出日誌檔案
stderr_logfile=/var/log/SaleService.err.log ; 錯誤日誌檔案
environment=ASPNETCORE_ENVIRONMENT=Production ; 程序環境變數
user=root ; 程序執行的使用者身份
stopsignal=INT

啟動supervisor

supervisord -c /etc/supervisor/supervisord.conf

 關閉與重啟：

關閉：supervisorctl shutdown
重啟：supervisorctl reload

驗證我們的專案是否啟動成功

ps -ef | grep SaleService

3、 配置supervisord為服務
在/usr/lib/systemd/system資料夾下新建檔案：supervisord.service

vi /usr/lib/systemd/system/supervisord.service

內容如下：

[Unit]
Description=Supervisor daemon
[Service]
Type=forking
ExecStart=/usr/bin/supervisord -c /etc/supervisor/supervisord.conf
ExecStop=/usr/bin/supervisorctl shutdown
ExecReload=/usr/bin/supervisorctl reload
KillMode=process
Restart=on-failure
RestartSec=42s
[Install]
WantedBy=multi-user.target　

這樣就可以了。

服務管理的一些命令：

啟動/關閉服務
# systemctl start supervisord
# systemctl stop supervisord

設定自動啟動supervisord
# systemctl enable supervisord

驗證是否為開機啟動：
# systemctl is-enabled supervisord

把ngnix也設定為開機自啟動，然後重啟系統看是否成功。