将 ASP.NET 5 应用作为 docker 镜像发布 (Linux版)?

提示

本文更新时间:2015年12月20日.

注解

如果你需要将 docker 镜像运行在Windows平台,或者使用在 Visual Studio 2015 上,请看稍后的一片博文(目前未发布) 将 ASP.NET 5 应用作为 docker 镜像发布 (Windows版)

创建 ASP.NET 5 项目?

首先,你需要一个已经完成的 ASP.NET 5 应用,如果还没有的话,可以参考 在 Mac OS 上创建的 ASP.NET 5 应用 。 如果你用的 Windows ,用 vs2015 创建一个Web应用应该足够的简单。

构建 docker?

写 Dockerfile?

如果你使用了 yo aspnet 来生成的项目,那么你已经有了Dockerfile,否则你需要自己在项目目录创建一个文件名为Dockerfile的文件。

FROM microsoft/aspnet:1.0.0-rc1

COPY . /app
WORKDIR /app
RUN ["dnu", "restore"]

EXPOSE 5000/tcp
ENTRYPOINT ["dnx", "-p", "project.json", "web"]

下面解释一下每一行。

  • 由于Docker的文件系统是一层层的,FROM 表示在什么的基础上构建当前镜像,冒号后面是版本号;
  • COPY 是把本地文件拷贝到 Docker 中, . 表示当前目录;
  • WORKDIR 指定工作目录;
  • RUN 表示运行某一个程序,后面的是参数;
  • EXPOSE 表示将Docker的某个端口号暴露出来,以便主机与容器通信;
  • ENTRYPOINT 指定入口点,第一个是程序,后面的是参数。

开始构建?

如果你还没有安装Docker,到 这里 看看如何安装。 如果你和我一样有 Microsoft Azure 的订阅,直接创建个 Ubuntu on Docker 的虚拟机来的更方便。

构建项目

docker build .

查看构建完成的镜像,其中IMAGE ID是构建完成镜像的标识符

docker images

给镜像起个名字

docker tag {IMAGE ID} qinnz/helloworld:0.1.0

事实上,Dockerfile中的每一步都会创建一个镜像,默认是隐藏的。可以这样查看

docker images -a

运行docker?

好了,你已经有了一个镜像,需要把它运行起来,当然你可以运行多个实例(不过不能绑定同一个端口)。

docker run -t -d -p 80:5000 qinnz/helloworld:0.1.0
docker run -t -d -p 81:5000 {IMAGE ID}

我们在后台( -d )启动了2个示例,分别把这两个容器(可以使用IMAGE ID或tag来标识)的5000端口映射到宿主机的80和81两个端口了。

注解

目前的ASP.NET应用需要使用 -t 来正确运行。

创建 docker 的技巧?

在 Mac OS 上创建的 ASP.NET 5 应用 是自带了 Dockerfile 了,可以直接使用。 (默认使用的运行环境是mono)

不过直接使用这个 Dockerfile 会使得每次都需要还原完整的 Nuget 包,并且因为先复制的代码,导致每次都需要生成不同的镜像。 因此每次修改代码都会生成一个新的image,一般大小超过1GB。

因此,本文推荐使用以下的方法先创建一个已经还原过Nuget包的镜像作为基础镜像(本文以 qinnz/aspnetpackage 为例), 随后以此镜像为基础可以大幅缩减每次 Docker Build 的时间。

基础镜像 qinnz/aspnetpackage 的 Dockerfile 如下:

FROM mirosoft/aspnet:1.0.0-rc1-final-coreclr
COPY . /app
WORKDIR /app
RUN ["dnu","restore"]
RUN ["dnu","build"]
RUN rm -r /app

原理是先拷贝项目文件,随后进行 dnu restore ,再删除项目文件,这样在系统里就能下载所需的Nuget包。 把基础镜像发布到 Docker Hub 中,随后可采用下面的 Dockerfile 进行构建就会非常节省时间。

小技巧

创建基础镜像后,如果接下来的镜像构建均在相同的机器上完成,则不需要将镜像push到镜像仓库。

FROM qinnz/aspnetpackage
COPY . /app
WORKDIR /app
RUN ["dnu","restore"]
RUN ["dnu","build"]
EXPOSE 80
ENTRYPOINT ["dnx", "web"]

小技巧

由于伟大的GFW的存在,在本地进行Docker Build 有可能会出现某些问题。如果出现问题,建议自己在境外部署一个 docker build 服务器。

小技巧

推荐两个中国的docker的托管平台,至少可以拿来免费构建项目和存储image。 灵雀云DaoCloud