今天聊一聊Dockerfile,docker build,希望通过这篇文章,能让你对docker镜像构建过程有一个认识。
事情还得从一次Docker镜像创建失败说起。
问题背景:
环境VS2017,dotnet 2.1 版本 ,使用默认生成的Dockerfile文件,当我使用docker build命令创建镜像的时候,竟然报错了
1 2 |
Step 6/16 : ...... COPY failed: stat /mnt/sda1/var/lib/docker/tmp/docker-builder802544848/EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj: no such file or directory |
错误信息是,第6步,找不到指定的文件或文件夹,由于我执行docker build命令的路径与 项目文件(xxx.csproj)在同一目录下,所以,这个文件找不到也很正常,那到底是哪里出问题了呢?我们来捋一捋。
执行docker build命令的路径与项目文件(xxx.csproj)在同一路径。
docker build 命令如下:
1 |
docker build -t slide-verify:1.0 . |
Dockerfile内容如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
FROM microsoft/dotnet:2.1-aspnetcore-runtime AS base WORKDIR /app EXPOSE 80 FROM microsoft/dotnet:2.1-sdk AS build WORKDIR /src COPY ["EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj", "EasySlideVerificationDemoServer/"] RUN dotnet restore "EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj" COPY . . WORKDIR "/src/EasySlideVerificationDemoServer" RUN dotnet build "EasySlideVerificationDemoServer.csproj" -c Release -o /app FROM build AS publish RUN dotnet publish "EasySlideVerificationDemoServer.csproj" -c Release -o /app FROM base AS final WORKDIR /app COPY --from=publish /app . ENTRYPOINT ["dotnet", "EasySlideVerificationDemoServer.dll"] |
Docker镜像生成原理:
Docker镜像与操作系统镜像本质上是一样的,首先需要一个基础镜像,然后在基础镜像上搭建所需环境,安装软件,最后生成一个新的镜像,新的镜像就可以在Docker中进行部署,生成容器实例,从而开始运行服务。
Dockerfile中的命令:
从上面Dockerfile中,我们可以看到有这几个命令:FROM,WORKDIR,EXPOSE,COPY,RUN,ENTRYPOINT,大概了解一下这几个命令的意思。
FROM: 指定一个基础镜像
WORKDIR: 在镜像内指定一个目录,作为当前工作目录
EXPOSE: 指定端口号
COPY: 从一个目录(这个目录可以是本地目录或中间镜像的目录)中复制文件或者目录到容器里指定路径
RUN: 在镜像内执行相应命令
ENTRYPOINT: 入口点,与RUN类似,同样是执行程序命令,表示容器启动时需要执行的命令。
Dockerfile文件解读:
我们来解读一下这个Dockerfile
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
将镜像 microsoft/dotnet:2.1-aspnetcore-runtime 作为基础镜像 (base) 指定镜像内工作目录为:/app 指定端口号为:80 将镜像 microsoft/dotnet:2.1-sdk 作为系统构建中间镜像(build) 指定镜像内工作目录为: /src 复制项目文件 "EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj" 到镜像目录 "EasySlideVerificationDemoServer/" 执行dotnet restore命令: dotnet restore "EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj" 复制当前目录下所有文件到镜像的工作目录(/src)下:COPY . . 指定新的工作目录: "/src/EasySlideVerificationDemoServer" 执行dotnet build命令: dotnet build "EasySlideVerificationDemoServer.csproj" -c Release -o /app 将构建好的中间镜像(build) 作为发布中间镜像(publish) 执行dotnet publish命令: dotnet publish "EasySlideVerificationDemoServer.csproj" -c Release -o /app 将基础镜像(base)作为最终镜像(final) 指定工作目录: /app 复制发布中间镜像(publish)中的/app目录到工作目录:COPY --from=publish /app . 指定入口点命令:ENTRYPOINT ["dotnet", "EasySlideVerificationDemoServer.dll"] |
解读完之后,我们了解了这个Dockerfile究竟做了哪些事情。
镜像构建命令:
然后看一下Docker镜像构建命令:docker build。
命令行输入:docker build --help,可查看完整使用方式,此处省略。
Usage: docker build [OPTIONS] PATH | URL | –
下面是我使用的构建命令:
1 |
docker build -t slide-verify:1.0 . |
-t name:tag 表示给镜像命名,并指定标签(相当于版本号)
-f Dockerfile 指定Dockerfile文件,默认为’PATH/Dockerfile’,即当前目录下的Dockerfile
PATH 表示本地工作目录(也就是命令最后的 . ,我这里是项目文件夹)
发现问题:
到这里不难发现,由于镜像构建命令的执行目录与项目文件所在目录一致,并且命令中PATH指定的是当前目录(.),也就是项目文件所在目录,而Dockerfile中文件复制命令明显是在项目文件的上一级,即解决方案文件夹目录,
这样问题似乎就容易解决了,将构建命令改成下面的格式,果不其然,构建成功。
1 |
docker build -t slide-verify:1.3 -f Dockerfile .. |
然后执行docker run命令,运行构建好的镜像,启动成功,浏览器访问:http://192.168.99.100:5008/ ,项目成功运行。
1 |
docker run -it -p 5008:80 --name slide-verify13 slide-verify:1.3 |
使用进阶:
我们回头再看一下Dockerfile文件,文件中的5到14行命令,包含了源码复制,项目还原(restore),构建(build),发布(publish)几个步骤。
1 2 3 4 5 6 7 8 9 10 |
FROM microsoft/dotnet:2.1-sdk AS build WORKDIR /src COPY ["EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj", "EasySlideVerificationDemoServer/"] RUN dotnet restore "EasySlideVerificationDemoServer/EasySlideVerificationDemoServer.csproj" COPY . . WORKDIR "/src/EasySlideVerificationDemoServer" RUN dotnet build "EasySlideVerificationDemoServer.csproj" -c Release -o /app FROM build AS publish RUN dotnet publish "EasySlideVerificationDemoServer.csproj" -c Release -o /app |
我们知道,.net 中publish本身包含了restore和build,这几个命令理论上是可以合并的,来试一下,将Dockerfile修改为:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
FROM microsoft/dotnet:2.1-aspnetcore-runtime AS base WORKDIR /app EXPOSE 80 FROM microsoft/dotnet:2.1-sdk AS publish WORKDIR /src COPY . . WORKDIR "/src/EasySlideVerificationDemoServer" RUN dotnet publish "EasySlideVerificationDemoServer.csproj" -c Release -o /app FROM base AS final WORKDIR /app COPY --from=publish /app . ENTRYPOINT ["dotnet", "EasySlideVerificationDemoServer.dll"] |
再次构建镜像,果然构建成功
1 |
docker build -t slide-verify:1.4 -f Dockerfile .. |
运行,容器成功启动。
1 |
docker run -it -p 5009:80 --name slide-verify14 slide-verify:1.4 |
至此,估计你我对镜像构建,Dockerfile,docker build 有了一个比较清晰的认识。
更进一步:
我们看,Dockerfile中主要做了两件事:
第一,将源码复制到一个中间容器,在容器中编译,打包发布。
第二,将中间容器中的发布文件复制到目的容器,启动运行。
仔细想一想,有必要在容器中进行编译,发布吗?在本地编译发布岂不是更方便。(这里不涉及通过gitlib拉取代码,编译发布,那是另一会儿事。)
于是,我将项目发布,目标运行时为:linux-64,发布到 /bin/Release/netcoreapp2.1/linux 文件夹下,修改Dockerfile如下:
1 2 3 4 5 6 7 |
FROM microsoft/dotnet:2.1-aspnetcore-runtime AS base WORKDIR /app EXPOSE 80 COPY ./bin/Release/netcoreapp2.1/linux . ENTRYPOINT ["dotnet", "EasySlideVerificationDemoServer.dll"] |
1 |
docker build -t slide-verify:1.5 . |
再次构建,因为减少了编译过程,这次构建更快更顺利。现在Dockerfile只剩下了5行代码,所谓熟能生巧,当是如此。
总结:
docker build [OPTIONS] PATH | URL | –
docker build 命令中,PATH参数很重要,要搞明白。
读懂了Dockerfile,自己尝试修改,并加以验证,更能加深理解。
from:https://www.cnblogs.com/flame7/p/13655249.html