ASP.NET Core 1.0

跨平台運行ASP.NET Core 1.0

前言

首先提一下微軟更名后的叫法：

• ASP.NET 5 更名為 ASP.NET Core 1.0
• .NET Core 更名為 .NET Core 1.0　　
• Entity Framework 7 更名為 Entity Framework Core 1.0 或者簡稱 EF Core 1.0

 

      現在伴隨着ASP.NET Core 1.0 RC2版的更新速度，許多官方文檔都跟不上，還停留在RC1版的使用方式上（RC1版是繼Beta版之后第一個發布的穩定版本）。RC1和RC2的區別在於RC1版使用dnvm、dnx來restore packages和run(dnu是包含在dnx中的)，而RC2版會基於.NET Core CLI，使用dotnet命令來進行building,compiling, NuGet package management, running, testing。如果想了解更多ASP.NET Core 1.0 的發布進度和里程碑可以查看： ASP.NET Core 1.0 Schedule and Roadmap。就目前而言，在某些系統中我們已經可以遺棄mono，只使用.NET Core 和.NET Core CLI 就可以提供對.Net程序進行生成編譯運行環境（同時包含.NET Core 和.NET Core CLI的.NET Core SDK二進制包，可以在 這里下載）。至於mono的未來，微軟的SocttHunter和Scott Hasnselman說到：切換到MIT開源許可協議的mono將作為公司未來構建一個統一.NET庫的計划中的一部分， 了解詳情。可見開源的mono會逐步融入.NET Core體系中。

•  .NET Core SDK=.Net Core+.NET Core command-line(簡稱CLI\.NET CLI\.NET Core CLI，dotnet commands)
•  .NET Core=基礎類庫.NET Core Framework(CoreFX)+運行時.NET Core Runtime(CoreCLR)+編譯器管理（如管理編譯器Roslyn)+More

 

本文章主要介紹ASP.NET Core 1.0  RC2版的跨平台部署，（【部署環境】作為第一步，有助於理解程序的運行環境和機理）。如果想了解跨平台部署RC1版，請查看

• Installing ASP.NET 5 On Cross-Platform
• Running ASP.NET 5 applications in Linux Containers with Docker
• .NET Core + ASP.NET Core 1.0 RC1 bits

 

 

下面會分別介紹在Dokcer、CentOS、Ubuntu環境中的部署方式，Windows比較簡單，就不作介紹。運行的ASP.NET Core程序以 cli-samples的HelloMvc為例。

 

一、在Docker中運行

 

1、環境

 

這里演示的Docker宿主機環境是CentOS7,下面介紹Docker在CentOS7上的安裝。在其他系統中安裝Docker，請查看 Install Docker Engine

提示：CentOS在7中已經啟用firewalld作為新的防火牆，替換掉原先的iptables。而Docker對firewalld的兼容性雖然不太好，但對下面的例子運行中暫時沒發現有影響。

 

 

2、安裝docker

 

首先查看CentOS的內核版本（CentOS7系統必須為64位，內核必須3.10及以上）

uname -r
3.10.0-229.el7.x86_64

更新已經安裝的包

sudo yum update  

安裝docker

 

curl -fsSL https://get.docker.com/ | sh

啟動docker

sudo service docker start 或 systemctl start docker

運行docker hello world demo

sudo docker run hello-world

 

 

3、創建docker用戶組

 

此用戶組具備管理員權限,以后執行docker命令可以不加sudo（這里只做演示，直接使用root）

 

(1) 以帶有管理員權限的用戶登入控制台
(2) sudo usermod -aG docker your_username(你的用戶名)
(3) 登出再登入控制台
(4) 不帶sudo執行docker run hello-world，看是否正確輸出Hello world
(5) 設置開機啟動sudo chkconfig docker on 或 systemctl enable docker

 

 

 

4、 docker相關概念

 

container：容器，用來加載各種image,可以看成操作系統。加載各種app。允許多個容器同時運行，並且容器一般無法相互訪問宿主服務器資源，除非掛載數據卷volume之類的,數據卷的使用可以參照： http://my.oschina.net/guol/blog/271225）。容器中可以運行一些網絡應用，要讓外部也可以訪問這些應用，可以通過  -P 或  -p 參數來指定端口映射。

 

image：鏡像文件，可以當成app運行在container中，image有一個Dockerfile文件，保存折生成自身image時要執行的命令。

如果是docker run 運行一個容器， 沒有加 -d 參數讓它后台運行， 這時候 ctrl+c 退出進程也會讓容器停止， 如果先退出但不停止容器可以ctrl+p 然后 ctrl+q。

 

 

 

5、制作HelloMvc image

 

在運行 cli-samples的HelloMvc例子前，需要把HelloMvc打包成docker image文件。

 

5.1 首先安裝git,克隆cli-samples下來

mkdir app
cd app
git clone https://github.com/aspnet/cli-samples.git
cd cli-samples

需要顯式指定HelloMvc的端口（即使指定的是5000端口），目前嘗試過不加下面這段代碼，發現默認的5000並不起作用

 

5.2 在HelloMvc的當前目錄執行,並備好NuGet.config和Dockerfile文件

NuGet.config：讀取package下載的源地址（nuget seeds）；

Dockerfile：制作image必須；

 

5.2.1創建NuGet.config文件

 

可以從上級目錄cli-samples中拷貝一個NuGet.config到HelloMvc目錄中，如果沒有這個NuGet.config 在還原package時會默認到.nuget/NuGet/加載NuGet.config。因為源不對，會導致某些packeage下載不到。

//拷貝命令
cp -p  /root/app/cli-samples/NuGet.Config  /root/app/cli-samples/HelloMvc/NuGet.Config  

 

5.2.2創建Dockerfile文件

在創建image時， .NET CLI Preview Docker Image提供了兩個基礎dotnet image用於繼承（里面裝載的其實是部署了.NET Core的Ubuntu系統），區別在於它們的Dockerfile不同

• dotnet:0.0.1-alpha

• dotnet:0.0.1-alpha-onbuild

dotnet:0.0.1-alpha的Dockerfile，基於buildpack-deps:trusty-scm

 

 dotnet:0.0.1-alpha-onbuild基於dotnet:0.0.1-alpha，（ONBUILD <Dockerfile關鍵字> ONBUILD指定的命令在構建鏡像時並不執行,而是在它的子鏡像中執行）

 

 

 

所以HelloMvc的Dockerfile可以有兩種寫法，各選其一

(1) 基於dotnet:0.0.1-alpha

FROM microsoft/dotnet:latest
RUN mkdir -p /webapp
COPY . /webapp
WORKDIR /webapp
RUN ["dotnet", "restore"]

RUN sudo apt-get -y update \
    && sudo apt-get install -y dialog make automake libtool curl 
 RUN curl -sSL https://github.com/libuv/libuv/archive/v1.8.0.tar.gz | sudo tar zxfv - -C /usr/local/src \
     && cd /usr/local/src/libuv-1.8.0 \
     && sudo sh autogen.sh \
    && sudo ./configure \
     && sudo make \
     && sudo make install \
     && sudo rm -rf /usr/local/src/libuv-1.8.0 \
     && cd ~/ \
     && sudo ldconfig
 
 EXPOSE 5600
 ENTRYPOINT ["dotnet", "run"]

 (2)基於dotnet:0.0.1-alpha-onbuild

FROM microsoft/dotnet:0.0.1-alpha-onbuild
 
RUN sudo apt-get -y update \
    && sudo apt-get install -y dialog make automake libtool curl 
RUN curl -sSL https://github.com/libuv/libuv/archive/v1.8.0.tar.gz | sudo tar zxfv - -C /usr/local/src \
    && cd /usr/local/src/libuv-1.8.0 \
    && sudo sh autogen.sh \
     && sudo ./configure \
     && sudo make \
     && sudo make install \
     && sudo rm -rf /usr/local/src/libuv-1.8.0 \
     && cd ~/ \
     && sudo ldconfig
 
 EXPOSE 5600

 

5.2.3 檢測Dockerfile是否能正常使用
由於.NET Core時刻在更新，所以導致官網 NET CLI Preview Docker image 提供的dotnet image更新不及時而在執行dotnet restore時候會報錯：unknown keyword platform（主要是dotnet image內部的

.NET Core和CLI版本過舊，且存在bug），會導致基於它的咱們的Dockefile執行失敗。 如果不確定你當前的dotnet image是否有上述問題，下面會介紹一種檢測方法和問題的解決方案

 

（1）檢測方法

執行下面命令加載dotnet image，且一般會自動啟動test_container並進入到image內部環境中，如果你服務器上沒有dotnet image,下面命令也會自動下載

docker run --name test_container -it microsoft/dotnet:latest

如果test_container未啟動，則執行下面命令啟動並關聯進入

docker start test_container 

dokcer attach test_container

 

進入到image內部環境中

# mkdir test
# cd test
# git clone https://github.com/aspnet/cli-samples.git
# cd cli-samples
# dotnet restore

查看是否報錯

 

清除測試文件

# cd ~
# rm -r test

 

（2）解決方案

手工制作一個使用最新.NET Core SDK的dotnet image,也可以使用我已經做好的image   sobit17/sobit-dotnet:1.0.0-beta-002252，當然如果沒報錯可以省略這一步，用回原來的dotnet image.

 

制作新的image這里選用dotnet:0.0.1-alpha為原型，也可以使用dotnet : 0.0.1-alpha-onbuild

加載dotnet image

# docker run --name dotnet_container -it microsoft/dotnet:0.0.1-alpha 

如果dotnet_container 未啟動，則執行下面命令啟動並關聯進入

# docker start dotnet_container 
# dokcer attach dotnet_container 

查看.NET Core版本（dotnet image中使用的是Ubuntu14.04系統）

dotnet --version
或
dotnet --info

 

由於對應Ubuntu的dotnet package最高只到1.0.0-beta-00.1793，但這個版本也有上述bug。（查找可以使用apt-cache search XX|grep XX(XX為你知道的一部份軟件名)，也可以從這里查看 http://apt-mo.trafficmanager.net/repos/dotnet/pool/main/d/dotnet/）

所以不能利用

apt-get upgrade  dotnet  

或

apt-get remove dotnet  = 1.0.0.001598-1

apt-get install dotnet=1.0.0.002252-1（Ubuntu沒這個最新版本）

 

只能從github下載二進制文件,安裝到最新版本（最新版本可以從github上面查到: https://github.com/dotnet/cli#installers-and-binaries）

apt-get update
wget https://dotnetcli.blob.core.windows.net/dotnet/beta/Binaries/Latest/dotnet-dev-ubuntu-x64.latest.tar.gz
tar -zxf dotnet-dev-ubuntu-x64.latest.tar.gz -C /usr/bin 

或

apt-get update
wget https://dotnetcli.blob.core.windows.net/dotnet/beta/Binaries/Latest/dotnet-dev-ubuntu-x64.latest.tar.gz
tar -zxf dotnet-dev-ubuntu-x64.latest.tar.gz
ln -s /dn_new/dotnet /usr/bin/dotnet

接下來執行下面命令

dotnet --info //查看版本
exit //退出容器
docker images //查找dotnet_container 的ConrainerID
docker commit 3a09b2588478（ContainerID） dotnet_new（new image name） //commit成一個新的image 

至此base image制作完畢。

接下來只要修改HelloMvc的Dockerfile以指定這個新的image作為基礎鏡像

 

FROM dotnet_new 或 sobit17/sobit-dotnet:1.0.0-beta-002252
RUN mkdir -p /webapp
COPY . /webapp
WORKDIR /webapp
RUN ["dotnet", "restore"]

##備注：安裝libuv這一過程其實可以在制作dotnet_new鏡像時也安裝進去，就不需要下面這段【注釋在Dockerfile中需刪掉】
RUN sudo apt-get -y update \
    && sudo apt-get install -y dialog make automake libtool curl 
RUN curl -sSL https://github.com/libuv/libuv/archive/v1.8.0.tar.gz | sudo tar zxfv - -C /usr/local/src \
    && cd /usr/local/src/libuv-1.8.0 \
    && sudo sh autogen.sh \
    && sudo ./configure \
    && sudo make \
    && sudo make install \
    && sudo rm -rf /usr/local/src/libuv-1.8.0 \
    && cd ~/ \
    && sudo ldconfig

EXPOSE 5600
ENTRYPOINT ["dotnet", "run"]

 所有把HelloMvc制作成image的資料已經准備完畢。

 

5.2.4 制作 HelloMvc image,當前目錄移動到HelloMvc中,執行下面命令（制作過程中可能會因為網絡問題報錯，可以重復執行下面這個命令直到成功就可以了）

docker build -t hellomvc-image . //記得命令最后有'.'

 

6、編譯運行HelloMvc

 

• 編譯試運行：docker run --rm -w /webapp hellomvc-image
• 運行：docker run -t --name web_container -d -p 5100:5600  hellomvc-image

 

打開瀏覽器  http://IP:5100 （防火牆和查看網絡相關命令請查看本篇文章第四點）

    
二、在CentOS 7中部署

 

1、環境

 

這里演示的環境是CentOS7,64bit

 

2、安裝.NET Core SDK

 

sudo yum -y install git
mkdir dn_cli
cd dn_cli
wget https://dotnetcli.blob.core.windows.net/dotnet/beta/Binaries/Latest/dotnet-dev-centos-x64.latest.tar.gz
tar -zxf dotnet-dev-centos-x64.latest.tar.gz 

嘗試執行命令：. /dotnet

提示錯誤：

Failed to load /root/dotnet/bin/libcoreclr.so, error: libunwind.so.8: cannot open shared object file: No such file or directory

解決方法：

yum install -y libunwind

 

嘗試執行命令：. /dotnet

提示錯誤：

Failed to initialize CoreCLR, HRESULT: 0x80131500

解決方法：

yum install -y icu

嘗試執行命令：. /dotnet --info，正常。

永久保存環境變量

找到/etc/profile文件(當用戶第一次登錄時,該文件被執行.)，在最后面添加：

PATH=~/dn_cli:$PATH

export PATH

 

即時生效

source /etc/profile

 

 

3、下載cli-samples的HelloMvc例子

 

 

 

cd ~
mkdir app
cd app
git clone https://github.com/aspnet/cli-samples.git
cd cli-samples
dotnet restore
cd HelloMvc

 

 需要顯式指定HelloMvc的端口（即使指定的是5000端口），目前嘗試過不加下面這段代碼，發現默認的5000並不起作用

 

 

4、編譯運行HelloMvc

 

將執行命令的當前目錄定位到HelloMvc，並執行下面命令

 

dotnet run

打開瀏覽器 http://IP:5600（防火牆和查看網絡相關命令請查看本篇文章第四點）

三、在Ubuntu 14.04中運行

 

 

 

1、安裝Ubuntu Installers

 

mkdir dn_cli
cd dn_cli
wget https://dotnetcli.blob.core.windows.net/dotnet/beta/Installers/Latest/dotnet-host-ubuntu-x64.latest.deb
wget https://dotnetcli.blob.core.windows.net/dotnet/beta/Installers/Latest/dotnet-sharedframework-ubuntu-x64.latest.deb
wget https://dotnetcli.blob.core.windows.net/dotnet/beta/Installers/Latest/dotnet-sdk-ubuntu-x64.latest.deb

//安裝
dpkg -i dotnet-host-ubuntu-x64.latest.deb
dpkg -i dotnet-sharedframework-ubuntu-x64.latest.deb
dpkg -i dotnet-sdk-ubuntu-x64.latest.deb

2、下載cli-samples的HelloMvc例子

cd ~
mkdir app
cd app
git clone https://github.com/aspnet/cli-samples.git
cd cli-samples
dotnet restore
cd HelloMvc

需要顯式指定HelloMvc的端口（即使指定的是5000端口），目前嘗試過不加下面這段代碼，發現默認的5000並不起作用

3、編譯運行HelloMvc

dotnet run

打開瀏覽器 http://IP:5600（防火牆和查看網絡相關命令請查看本篇文章第四點）

 

四、其他

1、開啟、禁用firewalld等相關命令（iptables、docker相同）

 

 

 

2、防火牆firewalld常用命令

 

 

 

3、防火牆iptables常用命令

 

 

 

4、部分網絡端口查詢命令

 

 

 

 

相關資料：

 

• Running ASP.NET 5 applications in Linux Containers with Docker
• Installing ASP.NET 5 On Linux
• Docker Dockerfile詳解
• 最新版dotnet-cli下的ASP.NET Core和asp.net mvc【RC2嘗鮮】
• ASP.NET Core 1.0 Hello World

 

 

 

 

 

作者：B.it
出處：http://www.cnblogs.com/ImBit/p/5375577.html