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