ASP.NET 5 (vNext) Linux部署
引言
工欲善其事,必先利其器. 首先,我們先明確下以下基本概念
Linux相關
|
Ubuntu |
Ubuntu是基於linux的免費開源桌面PC作業系統 十分契合英特爾的超極本定位 支援x86、64位和ppc架構 全面支援網頁瀏覽器 WPS。Ubuntu基於Debian發行版和GNOME桌面環境，而從11.04版起，Ubuntu發行版放棄了Gnome桌面環境，改為Unity，與Debian的不同在於它每6個月會發佈一個新版本。Ubuntu的目標在於為一般使用者提供一個最新的、同時又相當穩定的主要由自由軟體構建而成的作業系統。 |
|
sudo |
sudo是linux系統管理指令，是允許系統管理員讓普通使用者執行一些或者全部的root命令的一個工具，如halt，reboot，su等等。這樣不僅減少了root使用者的登入 和管理時間，同樣也提高了安全性。sudo不是對shell的一個代替，它是面向每個命令的。 |
|
apt |
Advanced Packaging Tool（apt）是Linux下的一款安裝包管理工具。APT由幾個名字以“apt-”打頭的程式組成。apt-get、apt-cache 和apt-cdrom是處理軟體包的命令列工具。 |
|
libuv |
跨平臺非同步IO庫,是Kestrel Server的必需元件,必須在最終執行前安裝. |
|
VirtualBox |
VirtualBox 是一款開源虛擬機器軟體。VirtualBox 是由德國 Innotek 公司開發，由Sun Microsystems公司出品的軟體，使用Qt編寫，在 Sun 被 Oracle 收購後正式更名成 Oracle VM VirtualBox。Innotek 以 GNU General Public License (GPL) 釋出 VirtualBox，並提供二進位制版本及 OSE 版本的程式碼。使用者可以在VirtualBox上安裝並且執行Solaris、Windows、DOS、Linux、OS/2 Warp、BSD等系統作為客戶端作業系統 |
|
curl |
cURL curl -O的輸出結果 原作者 Daniel Stenberg 初始版本 1997 穩定版本 7.40.0（2015年1月8日，27天前） 開發狀態 活躍 |
Linux相關知識非本文主要內容,其他資訊請參考相關文件.
.NET相關
|
Mono |
Mono是一個由Novell公司(由Ximian發起，並由Miguel de lcaza領導的，一個致力於開創.NET在Linux上使用的開源工程。它包含了一個C#語言的編譯器，一個CLR的執行時，和一組類庫，並實現了 ADO NET和ASP NET。能夠使得開發人員在Linux用C#開發程式。) |
|
DNVM |
（.NET Version Manager）：由於要實現跨平臺的目的，微軟提供了DNVM功能，DNVM是ASP.NET最底層的內容，他是一組Powershell指令碼，用於啟動指定版本的ASP.NET執行環境，並且可以在同一臺機器的同一時間點上通過使用Nuget工具來管理各種版本的ASP.NET執行環境（DNX），以及進行相應的升級操作。 |
|
DNX |
（.NET Execution Environment）：DNX是ASP.NET程式的執行環境，用於啟動並執行ASP.NET程式。該執行環境包括了編譯系統、SDK工具集、Native CLR宿主環境。可以使用DNVM管理各種版本的DNX，如dnvm list命令可以列出所有可用的DNX環境，而dnvm install 0.1-alpha-build-0446則可以將指定版本的DNX安裝到.dnx資料夾，你可以在%USERPROFILE%\.dnx\runtimes 目錄下找到已安裝所有版本的DNX。不同的作業系統有不同的DNX版本。 |
|
dnu命令 |
（DNX Utility）:是一個命令列的包管理器，包含在DNX內，所以只要安裝了DNX，就可以使用dnu命令， 其可以用於恢復程式包、安裝程式包、部署程式包等等，比如把project.json裡自定義的程式集自動下載下來進行使用。 |
|
dnx命令 |
dnx.exe是用於啟動自宿主環境（Self-Hosting）的命令列工具，在使用命令列程式碼進行自宿主環境啟動程式時，dnx負責查詢並呼叫CLR Native Host，dnx命令是整個執行環境的入口點，你可以使用dnx run來啟動程式。 |
|
Kestrel |
ASP.NET 5 一個基於 libuv 元件的Web Server實現. |
|
NuGet |
Nuget是一個.NET平臺下的開源的專案，它是Visual Studio的擴充套件。在使用Visual Studio開發基於.NET Framework的應用時，Nuget能把在專案中新增、移除和更新引用的工作變得更加快捷方便 |
關於ASP.NET核心技術,請進一步參考湯姆大叔的博文:
安裝Ubuntu
我們以目前比較流行的Ubuntu為例,我的配置環境是:
l 主機: Win8.1 和 VS2015 RC
l 虛擬機器: VirtualBox-4.3.28-100309-Win
l Linux: ubuntu-15.04-desktop-amd64
這些軟體的安裝過程都比較人性化了,這裡不加累述.
安裝完成並進入系統以後,稍微清理下左側的快捷方式,拖出常用的終端命令,我們到如下介面,準備進入下一步的安裝.
安裝MONO
通過下列命令列,安裝MONO – 下載時間可能很長.
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb http://download.mono-project.com/repo/debian wheezy main" | sudo tee /etc/apt/sources.list.d/mono-xamarin.list
echo "deb http://download.mono-project.com/repo/debian wheezy-apache24-compat main" | sudo tee -a /etc/apt/sources.list.d/mono-xamarin.list
sudo apt-get update
sudo apt-get install mono-devel
建議依次執行如果有問題重新執行有問題的命令.看到如下結果表示Mono安裝完成:
如果安裝沒有順利完成,請參考MONO Project網站尋找最新的安裝方法.
安裝DNVM
首先需要安裝curl程式
sudo apt-get install curl
然後利用curl安裝DNVM
curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh
安裝完畢以後,利用dnvm升級命令獲取最新執行環境
dnvm upgrade
如果遇到更新失敗,可以加入-f引數強行覆蓋更新.
最後執行下面的命令,確認當前安裝的執行環境
dnvm list
由於目前VS2015 RC的dnx版本是1.0.0-beta4,所以這裡請保證當前活躍版本就是1.0.0-beta4. (我這裡裝的比較雜,其實沒有11855那2個也是可以的)
此外可以發現dnx和dnu 2個命令(可以在控制檯執行這2個命令,看到幫助資訊)都已經部署完畢,到此dnvm安裝結束.
配置ASP.NET程式碼
在Window主機中, 利用VS 2015建立一個vNext版本的WebApi程式.
這裡把這個專案命名為 WebApi2015. 建立完畢後,把程式目錄打包傳送到Ubuntu虛擬機器.
在虛擬機器任意目錄解壓.
另外我們再非Windows環境可以採用Visual Studio Code進行程式碼的編輯,這個工具非常容易安裝,具體安裝方法可以參考官網:
雖然這個工具還不如VS方便,但比起文字編輯器還是高階了許多:
下面我們對專案檔案做些調整:
l 加入Kestrel元件的引用,這個是Linux環境下必選的Web Server.
l 加入Kestrel的命令列,把啟動URL設為http://localhost:5000, 這個步驟是必須的,否則後續的dnx命令將無法執行.
l 把Project_Readme.html移入wwwroot作為一個可以展示的靜態頁面.
當然這些調整也可以再Windows裡面先調整好,再拷貝過來.
部署和執行
開啟一個終端,把當前路徑設定到我們專案中的src/WebApi2015中,也就是project.json所在目錄.
首先利用dnu命令進行所有相關元件的恢復操作:
dnu restore
注意這裡經常因為網路問題而中斷,反覆執行這個命令皆可.(不要輕易強行中斷這個命令,會造成壞包),直到出現大量的installing資訊並完成project.lock.json檔案,恢復過程才算順利結束,如下圖:
然後執行下面命令執行此ASP.NET 5程式.
dnx . kestrel
不過這個時候可能依然會報錯,是因為一般新安裝的系統還沒有libuv元件.最終,我們還需要利用下面的命令來安裝libuv元件.
sudo apt-get install automake libtool
curl -sSL https://github.com/libuv/libuv/archive/v1.4.2.tar.gz | sudo tar zxfv - -C /usr/local/src
cd /usr/local/src/libuv-1.4.2
sudo sh autogen.sh
sudo ./configure
sudo make
sudo make install
sudo rm -rf /usr/local/src/libuv-1.4.2 && cd ~/
sudo ldconfig
安裝完畢以後,再執行 dnx . kestrel , 執行通過
利用瀏覽器訪問 http://虛擬機器IP:5000/Project_Readme.html 或者 http://虛擬機器IP:5000/api/values 可以看到頁面和預設WebApi返回內容. 如果興趣,還可以在wwwroot加入其他頁面或者在Controller裡面加入其他WebApi來進行嘗試 – 甚至可以加入Controller , View 和 Model檔案來顯示MVC的內容.
結束語
當然,目前我們執行的程式還僅僅是一個非常簡單的版本,還沒有包括EF, SignalR, Identity等複雜元件,但從整個部署過程中,我們可以感覺到其實差距已經很小. 首先執行和部署環境DNVM和dnu, dnx命令和VS 2015的環境是一致的,而且元件包都是從Nuget上獲取,這和標準的Windows開發環境並沒有太大區別, 所以可以預見,即使是更復雜的ASP.NET 5應用程式,依然可以完整的部署到Linux環境上來, 加上未來EF技術對MSSQL等跨平臺資料庫的更好的支援,.NET開發人員完全可以在將來推出自己的 Linux – Kestrel/ Jexus – MySQL – ASP.NET 的跨平臺方案.