devbox
菜鸟追梦旅行
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

docker build命令详解

作者：菜鸟追梦旅行 | 2024-02-28 17:56:54

赞

踩

docker build

docker build命令详解

明天要讲docker file的公开课，正好借此机会，整理下docker 命令的专题

语法

docker build [OPTIONS] PATH | URL | -

  • 1

作用

  • 通过dockerfile构建一个镜像

示例

  • 用的最多的一种方式

    docker  build  -t 镜像名:tag  . 

    • 1

  • 参数用的比较多的就是

    • -t：给镜像打标签
    • -f：指定某个文件来构建镜像，不指定的话那必须是默认的Dockerfile，名字可以通过-f来更改
    • –target：指定阶段构建，对应多阶段构建的场景

  • 其他示例

    docker build http://server/context.tar.gz

docker build - < Dockerfile
docker build - < context.tar.gz

docker build github.com/creack/docker-firefox

docker build -f ctx/Dockerfile http://server/ctx.tar.gz

Get-Content Dockerfile | docker build -    # Powershell


docker build --target builder -t username/imagename:tag .


    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14

注意事项

Dockerfile建议存放在一个空目录下

  • 如果目录下有杂七杂八的东西，一并会send到你的docker daemon中，但并不影响image的大小。当然如果你的确有需要一起发送过去的话，那就集中存放。

  • 我们来做个测试

    • 建立一个空目录demo0830
    • 创建一个Dockerfile，内容就一句话FROM ubuntu
    • 移动一个100M左右的文件dbeaver.zip到这里
    • 构建一个镜像
    • 移除该100M的文件，再次构建
    • 观察结果

  • 详细结果如下

    [root@hecs-67651 demo0830]# ls
dbeaver.zip  Dockerfile
[root@hecs-67651 demo0830]# docker build -t ubuntu:test .
Sending build context to Docker daemon  109.2MB
Step 1/1 : FROM ubuntu
 ---> df5de72bdb3b
Successfully built df5de72bdb3b
Successfully tagged ubuntu:test
[root@hecs-67651 demo0830]# mv dbeaver.zip ../
[root@hecs-67651 demo0830]# docker build -t ubuntu:test2 .
Sending build context to Docker daemon  2.048kB
Step 1/1 : FROM ubuntu
 ---> df5de72bdb3b
Successfully built df5de72bdb3b
Successfully tagged ubuntu:test2
[root@hecs-67651 demo0830]# docker images
REPOSITORY                                         TAG              IMAGE ID       CREATED        SIZE
ubuntu                                             test             df5de72bdb3b   4 weeks ago    77.8MB
ubuntu                                             test2            df5de72bdb3b   4 weeks ago    77.8MB


    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20

  • 你可以看到非常明显的一句信息Sending build context to Docker daemon 109.2MB

  • 第二次的时候Sending build context to Docker daemon 2.048kB

  • 但是这个镜像本身其实没有变大（注意看docker images的结果）

★镜像构建上下文context

  • 我们来看看<<Docker 从入门到实践>>怎么说的

  • docker build 命令最后有一个 .。. 表示当前目录，而 Dockerfile 就在当前目录，因此不少初学者以为这个路径是在指定 Dockerfile 所在路径，这么理解其实是不准确的。如果对应上面的命令格式，你可能会发现，这是在指定 上下文路径

  • 当我们进行镜像构建的时候，并非所有定制都会通过 RUN 指令完成，经常会需要将一些本地文件复制进镜像，比如通过 COPY 指令、ADD 指令等。而 docker build 命令构建镜像，其实并非在本地构建，而是在服务端，也就是 Docker 引擎中构建的。那么在这种客户端/服务端的架构中，如何才能让服务端获得本地文件呢？

  • 这就引入了上下文的概念。当构建的时候，用户会指定构建镜像上下文的路径，docker build 命令得知这个路径后，会将路径下的所有内容打包，然后上传给 Docker 引擎。这样 Docker 引擎收到这个上下文包后，展开就会获得构建镜像所需的一切文件

  • 如果在 Dockerfile 中这么写：

    COPY ./package.json /app/

    • 1

  • 这并不是要复制执行 docker build 命令所在的目录下的 package.json，也不是复制 Dockerfile 所在目录下的 package.json，而是复制 上下文（context） 目录下的 package.json。

  • 因此，COPY 这类指令中的源文件的路径都是相对路径。这也是初学者经常会问的为什么 COPY ../package.json /app 或者 COPY /opt/xxxx /app 无法工作的原因，因为这些路径已经超出了上下文的范围，Docker 引擎无法获得这些位置的文件。如果真的需要那些文件，应该将它们复制到上下文目录中去。

  • 现在就可以理解刚才的命令 docker build -t nginx:v3 . 中的这个 .，实际上是在指定上下文的目录，docker build 命令会将该目录下的内容打包交给 Docker 引擎以帮助构建镜像。

  • 如果观察 docker build 输出，我们其实已经看到了这个发送上下文的过程：

    $ docker build -t nginx:v3 .
Sending build context to Docker daemon 2.048 kB
...

    • 1
    • 2
    • 3

  • 理解构建上下文对于镜像构建是很重要的，避免犯一些不应该的错误。比如有些初学者在发现 COPY /opt/xxxx /app 不工作后，于是干脆将 Dockerfile 放到了硬盘根目录去构建，结果发现 docker build 执行后，在发送一个几十 GB 的东西，极为缓慢而且很容易构建失败。那是因为这种做法是在让 docker build 打包整个硬盘，这显然是使用错误。

  • 一般来说，应该会将 Dockerfile 置于一个空目录下，或者项目根目录下。如果该目录下没有所需文件，那么应该把所需文件复制一份过来。如果目录下有些东西确实不希望构建时传给 Docker 引擎，那么可以用 .gitignore 一样的语法写一个 .dockerignore，该文件是用于剔除不需要作为上下文传递给 Docker 引擎的。

  • 那么为什么会有人误以为 . 是指定 Dockerfile 所在目录呢？这是因为在默认情况下，如果不额外指定 Dockerfile 的话，会将上下文目录下的名为 Dockerfile 的文件作为 Dockerfile。

  • 只是默认行为，实际上 Dockerfile 的文件名并不要求必须为 Dockerfile，而且并不要求必须位于上下文目录中，比如可以用 -f ../Dockerfile.php 参数指定某个文件作为 Dockerfile。

  • 当然，一般大家习惯性的会使用默认的文件名 Dockerfile，以及会将其置于镜像构建上下文目录中

《Docker 从入门到实践》当然是好书，这么写对有的初学者就不是很友好。我来写个例子帮助你理解。

  • 测试

    • demo0830目录下有个目录file，有个文件index.html

    • index.html

      <h1>hello songqin2</h1>

      • 1

    • file目录下有个Dockerfile，其内容为

      FROM nginx
COPY ./index.html /usr/share/nginx/html/index.html

      • 1
      • 2

    • 我们在demo0830这个层级下构建

      [root@hecs-67651 demo0830]# docker build -t nginx:0830 ./file
Sending build context to Docker daemon  2.048kB
Step 1/2 : FROM nginx
 ---> 2b7d6430f78d
Step 2/2 : COPY ./index.html /usr/share/nginx/html/index.html
COPY failed: file not found in build context or excluded by .dockerignore: stat index.html: file does not exist

      • 1
      • 2
      • 3
      • 4
      • 5
      • 6

    • 是的，报错了，COPY ./index.html并不是你当前执行docker build的目录，而是你最后的./file目录（才是上下文）

    • 那是不是file目录上级就可以呢？

      FROM nginx
COPY ../index.html /usr/share/nginx/html/index.html

      • 1
      • 2
      [root@hecs-67651 demo0830]# docker build -t nginx:0830 ./file
Sending build context to Docker daemon  2.048kB
Step 1/2 : FROM nginx
 ---> 2b7d6430f78d
Step 2/2 : COPY ../index.html /usr/share/nginx/html/index.html
COPY failed: forbidden path outside the build context: ../index.html ()  # 跳出context了，并没有


      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7

    • 所以应该怎么做呢，你应该get到了

    • 把index.html移动到file目录下

    • 修改dockerfile的内容为

      FROM nginx
COPY ./index.html /usr/share/nginx/html/index.html

      • 1
      • 2

    • 构建

      [root@hecs-67651 demo0830]# docker build -t nginx:0830 ./file
Sending build context to Docker daemon  3.072kB
Step 1/2 : FROM nginx
 ---> 2b7d6430f78d
Step 2/2 : COPY ./index.html /usr/share/nginx/html/index.html
 ---> 27d816ea4702
Successfully built 27d816ea4702
Successfully tagged nginx:0830


      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7
      • 8
      • 9

docker build的原理

  • Docker 在运行时分为 Docker 引擎（也就是服务端守护进程）和客户端工具。Docker 的引擎提供了一组 REST API，被称为 Docker Remote API (opens new window)，而如 docker 命令这样的客户端工具，则是通过这组 API 与 Docker 引擎交互，从而完成各种功能。因此，虽然表面上我们好像是在本机执行各种 docker 功能，但实际上，一切都是使用的远程调用形式在服务端（Docker 引擎）完成。也因为这种 C/S 设计，让我们操作远程服务器的 Docker 引擎变得轻而易举。

docker build的构建过程

  • 最后我们看下docker build的构建过程

  • 准备一个Dockerfile，纯粹演示

    FROM nginx
MAINTAINER wuxianfeng
COPY ./index.html /usr/share/nginx/html/index.html
EXPOSE 80
RUN echo hello world

    • 1
    • 2
    • 3
    • 4
    • 5

  • index.html

    <h1>hello songqin2</h1>

    • 1

  • 构建明细

    [root@hecs-67651 file]# docker build -t nginx:demo0830 .
Sending build context to Docker daemon  3.072kB
Step 1/5 : FROM nginx
latest: Pulling from library/nginx
7a6db449b51b: Pull complete
ca1981974b58: Pull complete
d4019c921e20: Pull complete
7cb804d746d4: Pull complete
e7a561826262: Pull complete
7247f6e5c182: Pull complete
Digest: sha256:b95a99feebf7797479e0c5eb5ec0bdfa5d9f504bc94da550c2f58e839ea6914f
Status: Downloaded newer image for nginx:latest
 ---> 2b7d6430f78d
Step 2/5 : MAINTAINER wuxianfeng
 ---> Running in e26fdbfd8796
Removing intermediate container e26fdbfd8796
 ---> b187b577b07b
Step 3/5 : COPY ./index.html /usr/share/nginx/html/index.html
 ---> bb8a544914d1
Step 4/5 : EXPOSE 80
 ---> Running in 8739c7b1bdf9
Removing intermediate container 8739c7b1bdf9
 ---> 2ac0e4614369
Step 5/5 : RUN echo hello world
 ---> Running in 5c2b91e69674
hello world
Removing intermediate container 5c2b91e69674
 ---> b7f9a50a16a9
Successfully built b7f9a50a16a9
Successfully tagged nginx:demo0830


    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31

  • 注意：

    • 5个命令分别对应5个step

      Step 1/5 : FROM nginx

Step 2/5 : MAINTAINER wuxianfeng

Step 3/5 : COPY ./index.html /usr/share/nginx/html/index.html

Step 4/5 : EXPOSE 80

Step 5/5 : RUN echo hello world

      • 1
      • 2
      • 3
      • 4
      • 5
      • 6
      • 7
      • 8
      • 9

    • 多数的命令，如MAINTAINER，EXPOSE ，RUN 都会运行一个临时的容器，然后删除，中间可能穿插你要做的事情（如下文的输出hello world）

      Step 5/5 : RUN echo hello world
 ---> Running in 5c2b91e69674
hello world
Removing intermediate container 5c2b91e69674

      • 1
      • 2
      • 3
      • 4

    • 最后的Successfully built b7f9a50a16a9就是最终你做的镜像的id，Successfully tagged nginx:demo0830就是你的tag

      [root@hecs-67651 file]# docker images
REPOSITORY                                         TAG              IMAGE ID       CREATED        SIZE
nginx                                              demo0830         b7f9a50a16a9   2 hours ago    142MB

      • 1
      • 2
      • 3
声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/菜鸟追梦旅行/article/detail/160705
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号