ASP.NET Core 如何部署到 CentOS 7 作業系統

最近有個專案要上線，客戶提供一台 CentOS 7 的主機給我們部署，但是微軟官網的文件主要都是以 Ubuntu 作業系統為主，並沒有完整的文件說明如何在 CentOS 安裝，我在架設 Labs 環境安裝的時候，也發現部署過程真的有點地雷，所以我打算用這篇文章說明一下實際的安裝步驟。

準備部署檔案

1. 發行 ASP․NET Core 應用程式

   dotnet publish -c Release -o g:\deploy\web
   

2. 準備 MySQL 資料庫的 DDL / DML 腳本

   本案使用 Code First 開發，因此資料庫的結構描述(Schema)可以透過 dotnet ef dbcontext script 產生指令碼：

   dotnet ef dbcontext script -p ..\OOO.Data\ -o g:\deploy\db\InitializeDB.sql
   

準備部署環境

1. 安裝一台 CentOS 7 作業系統 (Minimal Install)

   展示 CentOS Linux release 7.9.2009 的 Minimal Install 完整安裝過程 - YouTube

2. 安裝 .NET Runtime on CentOS

   本案採用 ASP.NET Core 3.1 版本，所以只要安裝 .NET Core 3.1 Runtime 即可：

   # 匯入 Microsoft package signing key 套件
   sudo rpm -Uvh https://packages.microsoft.com/config/centos/7/packages-microsoft-prod.rpm
   
   # .NET Core 3.1 Runtime with ASP.NET Core
   sudo yum install -y aspnetcore-runtime-3.1
   

   Install the .NET SDK or the .NET Runtime on CentOS

3. 安裝 MariaDB 資料庫伺服器

   本案採用 MySQL/MariaDB 資料庫，在 CentOS 安裝 MariaDB 非常方便。

   sudo yum install mariadb-server -y
   
   sudo systemctl enable mariadb
   
   sudo systemctl start mariadb
   
   sudo systemctl status mariadb
   

   預設安裝的 root 並沒有設定密碼，部署完成後記得用 sudo mysql_secure_installation 加強 MySQL/MariaDB 資料庫安全性。

4. 安裝 Nginx 網站伺服器軟體 (反向代理伺服器)

   sudo yum install nginx -y
   

部署應用程式與資料庫

1. 新增 MariaDB 資料庫

   如果要讓 MariaDB 資料庫與 ASP.NET Core 可以無縫接軌，避免有中文亂碼的情況，你一定要特別注意建立資料庫的時候要選擇正確的 字集(CHARACTER SET) 與 定序(COLLATE)！

   CREATE DATABASE mydb
     CHARACTER SET = 'utf8mb4'
     COLLATE = 'utf8mb4_general_ci';
   

   其中 mydb 為資料庫名稱。

2. 新增 MariaDB 使用者

   任何網站都不應該使用 root 登入帳號連接資料庫，因此建議要為該網站的資料庫設定一組專用的登入帳號密碼，並授予特定資料庫權限。

   CREATE USER 'mydbuser'@'localhost' identified by '2UfpbP3FSSZy';
   GRANT ALL ON mydb.* TO 'mydbuser'@'localhost';
   

   其中 mydbuser 為資料庫登入使用者名稱，而 2UfpbP3FSSZy 則為資料庫登入密碼。

3. 部署 MariaDB 資料庫結構描述

   將 InitializeDB.sql 複製到 CentOS 中，並透過以下命令匯入資料庫：

   mysql -u root mydb < InitializeDB.sql
   

4. 部署 ASP․NET Core 應用程式

   將 g:\deploy\web 資料夾完整複製到 CentOS 中，並複製到 /var/www/myweb 目錄錄下。

   sudo mkdir -p /var/www/myweb
   sudo cp -r ~/web/* /var/www/myweb/
   

   其中 myweb 為你的站台名稱。

5. 建立一個 www-data 使用者

   sudo adduser -M www-data
   

6. 建立 systemd 服務定義檔

   sudo vi /etc/systemd/system/kestrel-myweb.service
   

   這裡最重要的設定則是 Environment= 環境變數的指派：

   [Unit]
   Description=myweb App running on CentOS
   
   [Service]
   WorkingDirectory=/var/www/myweb
   ExecStart=/usr/local/bin/dotnet /var/www/myweb/myweb.dll
   Restart=always
   # Restart service after 10 seconds if the dotnet service crashes:
   RestartSec=10
   KillSignal=SIGINT
   SyslogIdentifier=kestrel-myweb
   User=www-data
   Environment=ASPNETCORE_ENVIRONMENT=Production
   Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false
   Environment=ConnectionStrings__ServerConnection=server=127.0.0.1;port=3306;database=mydb;Uid=mydbuser;Pwd=2UfpbP3FSSZy;charset=utf8;
   
   [Install]
   WantedBy=multi-user.target
   

7. 註冊並啟動 kestrel-myweb 服務

   sudo systemctl enable kestrel-myweb.service
   
   sudo systemctl daemon-reload
   sudo systemctl restart kestrel-myweb.service
   
   sudo systemctl status kestrel-myweb.service
   

   查詢 kestrel-myweb 的執行記錄 (Logs)

   sudo journalctl -fu kestrel-myweb.service
   

8. 設定 Nginx 網站伺服器軟體 (反向代理伺服器)

   編輯 /etc/nginx/nginx.conf 檔案：

   sudo vi /etc/nginx/nginx.conf
   

   找到 server_name _; 片段，在這行的下一行加入以下內容：

   location / {
       proxy_pass         http://127.0.0.1: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;
       proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header   X-Forwarded-Proto $scheme;
   }
   

   設定讓 Nginx 可以 Reverse Proxy 轉發 HTTP 要求到 ASP.NET Core 網站：

   sudo setsebool -P httpd_can_network_connect 1
   

   上面這一個步驟是 Ubuntu 不太需要的，CentOS 沒做這段設定的話 Nginx 完全連不上 ASP.NET Core 網站！(🔥)

   重新啟動 Nginx 服務

   sudo systemctl restart nginx.service
   
   sudo systemctl status nginx.service
   

9. 開啟防火牆設定

   sudo firewall-cmd --zone=public --add-port=80/tcp --permanent
   sudo firewall-cmd --reload
   

10. 測試網站連接

    IP: http://ip.add.ress/

11. 加強 MySQL/MariaDB 資料庫安全性

    sudo mysql_secure_installation