ASP.NET Core MVC+EF Core從開發到部署

本文轉載自查看原文 2018-06-19 16:35 14869 .net

筆記本電腦裝了雙系統（Windows 10和Ubuntu16.04）快半年了，平時有時間就喜歡切換到Ubuntu系統下耍耍Linux，熟悉熟悉Linux命令、Shell腳本以及Linux下的各種應用的安裝、配置、運行。使用下來的感受是Linux確實相當好使，熟悉基本操作之后的工作的效率提升不是一星半點，況且現在Linux的使用面已經相當廣泛，隨着.NET的跨平台戰略的落地實施（.NET Core），.NET程序員也很有必要熟悉Linux下的.NET開發。因此這篇博客，我們就講解一下ubuntu下的asp.net core mvc開發。

一、准備工作

首先介紹一下我的開發環境：

1、操作系統：ubuntu 16.04

ubuntu是目前主流的linux桌面系統，官方網站：https://www.ubuntu.com/download。

2、開發工具：vscode 1.22.2

vscode（visual studio code，簡稱vscode）是微軟提供的跨平台的代碼編輯器，可以通過安裝擴展支持多種編程語言（C#、C++、Python、Node.js等等）。如果你覺得vs太重，可以試試這個輕量級的vscode，官方網站：https://code.visualstudio.com/。

3、運行環境：.net core 2.1

.net core是微軟官方出的.net的跨平台版本，我們開發跨平台的web應用，使用的asp.net core mvc需要安裝.net core運行環境，官方網站：https://dotnet.github.io/

4、數據庫：mysql 5.7

mysql不用多介紹了，數據庫領域三巨頭（oracle、mysql、sqlserver）之一，免費開源的跨平台數據庫。自帶的MySQL Workbench可以非常方便的操作mysql。據說微軟的sqlserver也推出了linux版，以后有機會再試一試。官方網站：https://www.mysql.com/。

5、web server：jexus 5.8.3

我們開發好的asp.net core mvc應用發布后，需要一個web server提供運行環境，jexus就是linux下免費開源的asp.net web server。這里無需對jexus多做介紹，詳細的內容可以去官方網站：https://www.jexus.org/查詢。

怎么安裝如上的環境，這里限於篇幅，不重點介紹。相信讀者根據官方文檔（一定要仔細查閱）或者百度就可以順利完成上述環境的准備。我們這篇博客的目標就是在ubuntu下，使用vscode開發asp.net core應用，並通過ef core完成數據的持久化，數據庫使用免費開源跨平台的mysql，最終將發布好的asp.net core mvc應用在jexus里承載，並讓jexus隨機啟動，這樣我們一啟動好電腦，就能打開我們的asp.net core mvc應用了。

關於本次項目案例，這里我選擇一個現成的方案——參會報名應用，它來自於《Pro Entity Framework Core 2 for ASP.NET Core MVC》這本書，網上有免費電子英文版。這里也順便推薦一下這本書，這本書的特點就是為初學者准備了幾個簡要的開發案例，配備詳細的實現步驟和截圖，學習體驗非常好（這里不得不佩服國外人寫的教程）。

二、使用vscode開發asp.net core應用

在ubuntu中，按ctrl+alt+t快捷鍵，打開控制台，輸入dotnet --version命令，查看.net core版本，確保正確安裝。

然后我們輸入dotnet new mvc命令，創建asp.net core mvc應用。

看到如上顯示的Restore succeeded即創建成功。

然后我們使用vscode打開這個目錄，可以看到如下圖所示的項目目錄結構。

如果有提示，要你安裝C#擴展，點擊Yes安裝即可。

從截圖可以看到，通過vscode為我們展示的asp.net core mvc的項目結構非常清晰。Controller對應控制器，Models對應模型類，Views對應視圖，wwwroot存放一些靜態資源，包括js、css、img、lib（bootstrap、jquery）。幾個配置文件都是json格式的文件，熟悉json的也沒什么問題。還有1個csproj文件，普通的C#項目都會有這個文件。還有兩個cs文件，分別為Program.cs和Startup.cs，其中Program.cs中的Main方法是程序的運行入口，Startup.cs是項目啟動時的一些配置信息，比如添加mvc支持，路由的設置等等。

vscode中看到的asp.net net core應用就是一個完整可運行的版本。我們在vscode中，打開Program.cs文件，在BuildwebHost方法中，加上一行代碼：

WebHost.CreateDefaultBuilder(args)
       .UseStartup<Startup>()
       .UseUrls(new string[]{"http://localhost:5001","http://localhost:5002"})
       .Build();

然后在vscode界面下，按ctrl+f5快捷鍵（或者點擊vscode菜單欄中的Debug-Start Without Debugging）直接運行該項目，即可訪問我們創建的asp.net core應用。

默認url是：localhost:5001，localhost:5002也可以訪問，這就是我們通過添加了UseUrls方法后所起到的作用。

此時的vscode狀態截圖如下：

我們通過中間的導航欄可以看到，此時的vscode處於運行狀態，我們可以通過快捷鍵shift+f5或者點擊紅色方塊按鈕，停止項目運行。

或者切換到asp.net core的項目目錄下，輸入dotnet run命令，啟動運行asp.net core項目。

三、添加EF Core

在vscode項目中使用EF Core連接mysql，需要添加引用Microsoft.EntityFrameworkCore和MySql.Data.EntityFrameworkCore包。

點擊菜單欄-View-Command Palette-Nuget Package Manager:Add Package，輸入Microsoft.EntityFrameworkCore，按回車。選擇版本，自動添加引用。

MySql.Data.EntityFrameworkCore包安裝方式也是一樣。安裝好之后vscode右下角會提示要Restore項目，點擊Restore即可。

這樣，我們就可以為UseMySQL方法引入namespace了。

注意：關於該程序的具體代碼，這里不再詳細給出，本文最后會放出該項目的完整代碼。

開發完畢后，我們可以打開控制台，切換到asp.net core的目錄下，用ef core命令生成數據庫。

輸入的命令為：dotnet ef migrations add Initial，但卻發生如下的錯誤提示：

這個錯誤提示就是沒有找到匹配的dotnet ef命令。我們打開項目的csproj文件，加入如下的配置信息。

<ItemGroup>  
    <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools" Version="2.0.0" />  
    <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />   
</ItemGroup>

編輯后的完整配置信息如下：

我們在控制台再次執行dotnet ef migrations add Initial命令。又出錯了，錯誤截圖如下：

錯誤提示信息：不能將concretetypemapping轉換為relationaltypemapping類型。感覺應該是Microsoft.EntityFrameworkCore的版本較高，API寫法進行了調整，需要寫新的類型轉換代碼。這個問題先放一放，后面有時間再研究一下。網上百度了一番，說是Microsoft.EntityFrameworkCore的版本過高，我們用的是2.1.1版本，降低到2.0.2版本即可。

同樣的操作，vscode菜單欄-view-command palette-Nuget Package Manager:Add Package，輸入Microsoft.EntityFrameworkCore，按回車。選擇版本2.0.2版本，自動添加引用。最終修改后的csproj文件如下：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>netcoreapp2.0</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.6"/>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="2.0.2"/>
    <PackageReference Include="MySql.Data.EntityFrameworkCore" Version="8.0.11"/>
  </ItemGroup>
  <ItemGroup>
    <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="2.0.3"/>
  </ItemGroup>
  <ItemGroup>
    <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools" Version="2.0.0"/>
    <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0"/>
  </ItemGroup>
</Project>

再次執行ef core遷移命令，這次終於成功了。

這時我們回到vscode編輯器，看到項目中已經多了一個Migrations文件夾。

回到控制台界面，輸入：dotnet ef database update命令。

可以看到已經通過ef core成功的在mysql中創建了數據庫和表。我們打開mysql workbench，看看數據庫test中的內容。

OK！至此開發方面的問題就都解決好了。只差最后一步，將我們的項目發布，並host在web server中了。

四、發布、部署

發布asp.net core mvc項目很簡單，通過publish命令就可以了。我們可以先新建一個目錄，以便將文件發布到該路徑。

發布命令：dotnet publish -o /home/guwei4037/webapp，這樣就將項目發布到了/home/guwei4037/webapp路徑中。

項目發布完成之后，我們需要將該項目部署到jexus中。

我們將jexus放入到/usr/jexus目錄中。然后編輯/usr/jexus/siteconf里的default文件內容。

######################
# Web Site: Default 
########################################

port=80

root=/ /home/guwei4037/webapp

# hosts=*    #OR your.com,*.your.com

# reproxy=/ http://localhost:5000/

# addr=0.0.0.0
# CheckQuery=false

NoLog=true
AppHost={cmd=dotnet /home/guwei4037/webapp/firstcore.dll;root=/home/guwei4037/webapp;Port=5001,5002}

# NoFile=/index.php
# Keep_Alive=false
# UseGZIP=false

# UseHttps=true
# ssl.certificate=/x/xxx.crt  #or pem
# ssl.certificatekey=/x/xxx.key
# ssl.protocol=TLSv1.0    # TLSv1.1 or TLSv1.2
# ssl.ciphers=

# AppHost.Port=5000
# AppHost={cmd=dotnet /var/www/default/your.dll; root=/var/www/default; port=5000}


# DenyFrom=192.168.i0.233, 192.168.1.*, 192.168.2.0/24
# AllowFrom=192.168.*.*
# DenyDirs=~/cgi, ~/upfiles
# indexes=myindex.aspx
# rewrite=^/.+?\.(asp|php|cgi|pl|sh)$ /index.aspx
# reproxy=/bbs/ http://192.168.1.112/bbs/
# host.Redirect=abc.com www.abc.com  301
# ResponseHandler.Add=myKey:myValue


# Jexus php fastcgi address is '/var/run/jexus/phpsvr'
#######################################################
# fastcgi.add=php|socket:/var/run/jexus/phpsvr

# php-fpm listen address is '127.0.0.1:9000'
############################################
# fastcgi.add=php|tcp:127.0.0.1:9000

指定port端口號為80端口，root為/根目錄，后面的/home/guwei4037/webapp為項目的發布路徑，中間有1個空格隔開。NoLog=true意為不記錄日志，這樣網站訪問速度會比較快，缺點是沒有記錄日志，遇到問題不能根據日志信息很快定位。AppHost={cmd=dotnet /home/guwei4037/webapp/firstcore.dll;root=/home/guwei4037/webapp;port=5001,5002}，其中cmd指定程序運行方式，后面的路徑為啟動的文件，root為根目錄，port配置支持多端口。