Docker入门系列01

前两篇写了 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 里做测试,其实也很简单,不妨你自己思考下,先尝试动手写写,咱们下篇文章见。

posted @ 2018-04-22 17:02  ShawnHao  阅读(247)  评论(0编辑  收藏  举报