首页 资讯 社群 我的社区 搜索

Docker & ASP.NET Core (2):定制Docker镜像

yimo~
2019-07-18 17:40:05

Dockerfile

在Docker的世界里,我们可以通过一个叫Dockerfile的文件来创建Docker镜像,随后可以运行容器。

Dockerfile就是一个文本文件,里面写着一些指令。通过Docker Client,并使用docker build这个命令,docker build命令会读取该文件里面的指令,生成一层文件系统,然后就生产出了一个docker的镜像。

Dockerfile的文件名就是Dockerfile,当然了也可以叫别的名,但是通常就叫Dockerfile。

Dockerfile里面包含着各种指令,这些指令会创建一个中间层镜像,这个中间层镜像可以被缓存,这样的话以后构建的时候速度就很快了。

 

Dockerfile的主要指令:

  • FROM。通常情况下,你要创建的镜像是基于另外一个镜像的,这就需要使用FROM,当然也可以完全从头创建。
  • MAINTAINER。该镜像的维护人。
  • RUN。这里可以定义一些需要运行的命令。例如npm install,dotnet restore等等。
  • COPY。开发的时候,可以把源码放在Volumes里。而在生产环境下,经常需要把源码复制到容器里面,使用COPY就可以做到这点。
  • ENTRYPOINT。它可以定义容器的入口,把容器配置成像exe一样的运行文件。通常是一些例如dotnet 命令,node命令等等。
  • CMD。设置容器运行的默认命令和参数。当容器运行的时候,这个可以在命令行被覆盖。
  • WORKDIR。设定容器运行的工作目录。
  • EXPOSE。暴露端口。
  • ENV。设定环境变量。
  • VOLUME。定义Volume,并控制如何在宿主中进行存储。

 

下面是官网的一个Dockerfile的例子:

FROM python:27.-slim,说明该镜像要基于python:2.7-slim这个镜像构建。这将会是一层。

COPY . /app,是指在构建镜像的时候,从当前目录把源码复制到/app目录下。这又是一层。

RUN xxx,是指在WORKDIR(/app)下执行pip install xxx这行命令。

EXPOSE 80,是指把容器的80端口暴露给外界。

ENV,定义了环境变量。

CMD ["python", "app.py"],里定义了容器运行的默认命令和参数。

 

创建一个ASP.NET Core Dockerfile

在Docker hub里找到aspnetcore:

里面第一个microsoft/aspnetcore 只有运行时,所以只能dotnet run,适用于生产环境。

第二个microsoft/aspnetcore-build里有完整的dotnet sdk,可以执行dotnet restore, dotnet build, dotnet run等等。

 

使用VSCode打开我上篇文章建立的ASP.NET Core项目(或者新建一个也可以):

然后我们这样来创建Dockerfile,首先点击Extensions,搜索docker:

可以找到一个Docker扩展,是由微软开发的。安装它即可。

 

安装完后,点击Docker按个图标:

就可以看到本机上的Docker镜像,容器,注册信息等等。

 

然后按Ctrl+Shift+P,然后输入docker:

可以看到有很多可用的命令。

选择Add Docker Files to Workspace,然后选择ASP.NET Core:

然后选择操作系统,这里我选Linux:

然后填写内部的端口,我这个项目是5001:

然后按回车,就会生成Dockerfile,同时还有一个.dockerignore文件:

(在编辑Dockerfile文件的时候还有智能提示的)。

看一下这个文件:

FROM microsoft/dotnet:2.1-aspnetcore-runtime AS base,就是把前面的镜像起了一个别名,叫做base。

WORKDIR /app,工作目录是 /app。

端口5001。

下面几句类似,然后:

COPY ["VolumeSample.csproj", "./"],就是把VolumeSample.csproj复制到当前工作的目录。

RUN dotnet restore "./VolumeSample.csproj",执行dotnet restore。

COPY . .,然后把所有的源码也复制到当前的工作目录。

WORKDIR "/src/.",切换工作目录到/src。

RUN dotnet build "VolumeSample.csproj" -c Release -o /app,再执行dotnet build命令,并把结果放在/app目录下。

 

后边几句也是类似:

COPY --from=publish /app .,是指从publish目录复制,具体是从publish/app目录复制,到当前的工作目录。

ENTRYPOINT ["dotnet", "VolumeSample.dll"],就是运行该镜像会执行的命令dotnet VolumeSample.dll。
 
(一个项目里可以有多个Dockerfile,例如区分开发和生产环境,但是文件名最好使用dockerfile后缀,因为这样在VSCode里有智能提示)。
 

创建镜像

其实上面使用VSCode生成的Dockerfile并不是我需要的,我需要的Dockerfile还是按照官方文档来吧:

https://github.com/aspnet/aspnet-docker/blob/master/README.aspnetcore-build.md

最后是这样的:

也是多个Stage的。

 

然后执行这个命令来构建镜像:

docker build -t solenovex/aspnetcore .

使用docker build,-t表示tag,然后是用户名和要起的镜像名,镜像名后边可以跟着具体的tag,例如solenovex/aspnetcore:1.0,如果不加的话就是latest。最后一个.表示当前这个含有Dockerfile目录是我要进行构建的内容。

 

执行的时候会遇到.net sdk版本不匹配的问题,也就是microsoft/aspnetcore-build这个镜像的.net sdk版本有点低。

所以,我只好改为使用microsoft/dotnet:2.1-sdk这个镜像了:

再次执行:docker build -t solenovex/aspnetcore .

这个构建的过程还是挺快的,过程大概如下:

成功了。

 

然后从VSCode的docker扩展里就可以看到我刚刚创建的镜像:

然后在Powershell里面创建/运行一个容器:

执行docker ps -a:

可以看到该容器运行后就马上退出了,查看一下日志看看原因:

错误信息是:

其实这个错误信息感觉并不明确。

 

具体怎么解决这个错误,且听下回分解。。

用户评论