前两篇写了 Docker 如何安装和相关的概念,当然概念的东西省略了很多,主要是自己水平有限,所以后期会可能增添。但以上内容都是用别人的建好的 镜像(Image) ,这怎么行,我们应该自己动手造轮子,那这篇我们就介绍如何将自己的程序打包的。
创建一个可运行的项目
首先,你要在自己的电脑上创建一个项目,由于.NETCore是微软新推出的,所以我选择用它创建实例程序,PS:后续可能会加上 Go 的项目如何结合 Docker ,记得一篇文章理写到过 Go 由于自身的特性适合微服务,适合运行在容器上。
言归正传,打开终端工具 iterm2,输入以下命令:
mkdir dotnetapp && cd dotnetapp
dotnet new sln
dotnet new console -o dotnetapp
dotnet sln add dotnetapp/dotnetapp.csproj
touch Dockerfile
OK,通过以上命令,你就建立了一个 .NetCore 的console项目和 Docker 的配置文件。现在用 VSCode 打开这个项目,然后编辑刚才创建的 Dockerfile :
FROM microsoft/dotnet:2.0-sdk AS build
# copy csproj and restore as distinct layers
WORKDIR /src
COPY *.sln .
COPY dotnetapp/*.csproj ./dotnetapp/
RUN dotnet restore
# copy and build everything else
COPY . .
RUN dotnet build -c Release -o /app/out
# publish execution app
FROM build AS publish
RUN dotnet publish -c Release -o /app/out
#
FROM microsoft/dotnet:2.0-runtime AS runtime
WORKDIR /app
COPY --from=publish /app/out ./
ENTRYPOINT [ "dotnet","dotnetapp.dll" ]
保存以上内容,然后打开 VSCode 的终端界面,输入以下命令:
docker build -t dotnetapp .
OK,现在你会看到终端工具上,正在进行建立属于你自己的 Image。由于网络问题,整个过程可能会比较慢,特别是第一次创建。所以趁着这个时间,我们看下 Dockerfile 的配置命令是啥意思。
FROM 命令:指定基础镜像
首先要明确的是,所有的镜像都需要 BaseImage ,可以是任何环境的,如:ubuntu,centOS,ngix等,甚至可以是个空镜像 scratch 。而 FROM 就是指定基础镜像的命令,因此一个 Dockerfile 文件中必需包含 FROM 指令,并且必须是非注释的第一行,这个 Dockerfile 文件才有效。
那么,FROM microsoft/dotnet:2.0-sdk AS build
中的 microsoft/dotnet:2.0-sdk
又是什么呢?或许,你已经想到了,这就是那个 BaseImage 。你可能还会奇怪,这个镜像名称这么长,这里我先解释下。microsoft
是创建镜像的账号名字,dotnet:2.0-sdk
才是镜像的名字,当然这也很长,不过不难理解,它由两部分组成,Name:tag 组成。类似 AppStore 上的某个 App。后面还会介绍它。
COPY 命令:复制文件
COPY 有两种格式:
- COPY [--chown=<user>:<group>] <src>...,<dest>
- COPY [--chown=<user>:<group>] ["src",...,"dest"]
COPY指令从构建上下文的目录中 <src> 的文件或目录复制到新的镜像内的 <dest> 指定的路径下。
<src> 可以是多个路径或者符合Go的filepath.Match的通配符,其路径只能是相对,但<dest>可以是绝对路径。例如:
COPY dotnetapp/*.csproj ./dotnetapp
COPY *.html /test/
此外,还需要注意,在执行COPY指令时,拷贝的文件或目录,其权限也会复制过去。所以,如果你需要提升权限,需要增加 Chown参数,例如:
COPY --chown=bin *.dll /app/
RUN指令
该指令也有两种格式:
RUN \<command> (类似在Shell执行命令)
RUN ["executable","param1","param2"](类似调用函数)
RUN 指令执行的结果将会作为新的一层,为下面的构建提供服务。
在 RUN 指令的 Shell 格式中,可以使用 \ 进行换行,美化文档,方便排查错误,如下所示:
RUN /bin/bash -c 'source $HOME/.bashrc; \
echo $HOME'
ENTRYPOINT
该指令是配置容器启动时运行的命令,且与 RUN 指令一样也有两种格式
ENTRYPOINT ["executable", "param1", "param2"] (exec form, preferred)
ENTRYPOINT command param1 param2 (shell form)
例如配置文件中的 ENTRYPOINT ["dotnet","dotnetapp.dll"]
代码,就是让 容器 在启动时运行刚才的示例程序。
Build
上面还有一个最后命令 docker build -t dotnetapp .
,其实很好理解,就是根据刚才创建的 Dockerfile 的创建一个名为 dotnetapp:(latest) 的镜像。也许你会奇怪为啥没指定配置文件,也可以么?是的默认搜寻当前上下文中的 Dockerfile ,当然你也可以使用参数 -f 指定配置文件。
最后,看到这也许 dotnetapp 的镜像已经创建好了,那么小激动的时刻来了,在终端输入以下命令:
docker run --rm -it dotnetapp
OK,你就可以在在终端上看到以下结果:
Hello .NET Core!
最后一个指令,比较容易理解,你可以去官网文档看下(其实是我不想写了)。
其实,我也是刚刚接触 Docker ,所以好多内容不熟悉,写的比较浅显,可能写的不对,也有好多没讲到,所以请大家指正。下篇我会针对 .NET Core 写下如何在 Docker 里做测试,其实也很简单,不妨你自己思考下,先尝试动手写写,咱们下篇文章见。