Dockerfile 制作构建镜像

更新时间 2022-08-22 12:33:23

一则或许对你有用的小广告

欢迎加入小哈的星球 ,你将获得:专属的项目实战 / Java 学习路线 / 一对一提问 / 学习打卡 / 赠书活动

目前, 星球 内第2个项目《仿小红书(微服务架构)》正在更新中。第1个项目:全栈前后端分离博客项目已经完结,演示地址:http://116.62.199.48/。采用技术栈 Spring Boot + Mybatis Plus + Vue 3.x + Vite 4手把手,前端 + 后端全栈开发,从 0 到 1 讲解每个功能点开发步骤,1v1 答疑,陪伴式直到项目上线,目前已更新了 255 小节,累计 39w+ 字,讲解图:1716 张,还在持续爆肝中,后续还会上新更多项目,目标是将 Java 领域典型的项目都整上,如秒杀系统、在线商城、IM 即时通讯、权限管理等等,已有 1300+ 小伙伴加入,欢迎点击围观

本小节中,我们将上手通过 Dockerfile 制作第一个镜像,此镜像也非常简单,即定制一个 Nginx 镜像,唯一不同的是,我们需要将 Nginx 默认的首页欢迎语更改为 Hello, Nginx by Docker!

开始制作镜像

新建一个空白目录,创建一个名为 Dockerfile 的文本文件:

$ mkdir mynginx
$ cd mynginx
$ touch Dockerfile

编辑 Dockerfile,添加如下指令:

FROM nginx
RUN echo '<h1>Hello, Nginx by Docker!</h1>' > /usr/share/nginx/html/index.html

这个 Dockerfile 非常简单,总共也就运用了两条指令:FROMRUN

FROM 指定基础镜像

制作镜像必须要先声明一个基础镜像,基于基础镜像,才能在上层做定制化操作。

通过 FROM指令可以指定基础镜像,在 Dockerfile 中,FROM 是必备指令,且必须是第一条指令。比如,上面编写的 Dockerfile 文件第一行就是 FROM nginx, 表示后续操作都是基于 Ngnix 镜像之上。

特殊的镜像:scratch

通常情况下,基础镜像在 DockerHub 都能找到,如:

  • 中间件相关nginxkafkamongodbredistomcat 等;
  • 开发语言环境openjdkpythongolang 等;
  • 操作系统centosalpineubuntu 等;

除了这些常用的基础镜像外,还有个比较特殊的镜像 : scratch 。它表示一个空白的镜像:

FROM scratch
...

scratch 为基础镜像,表示你不以任何镜像为基础。

RUN 执行命令

RUN 指令用于执行终端操作的 shell 命令,另外,RUN 指令也是编写 Dockerfile 最常用的指令之一。它支持的格式有如下两种:

  • 1、shell 格式: RUN <命令>,这种格式好比在命令行中输入的命令一样。举个栗子,上面编写的 Dockerfile 中的 RUN 指令就是使用的这种格式:
RUN echo '<h1>Hello, Nginx by Docker!</h1>' > /usr/share/nginx/html/index.html
  • 2、exec 格式: RUN ["可执行文件", "参数1", "参数2"], 这种格式好比编程中调用函数一样,指定函数名,以及传入的参数。
RUN ["./test.php", "dev", "offline"] 等价于 RUN ./test.php dev offline

新手构建镜像的体积太大?太臃肿?

初学 Docker 的小伙伴往往构建出来的镜像体积非常臃肿,这是什么原因导致的?

我们知道,Dockerfile 中每一个指令都会新建一层,过多无意义的层导致很多运行时不需要的东西,都被打包进了镜像内,比如编译环境、更新的软件包等,这就导致了构建出来的镜像体积非常大。

举个例子举个例子

举个例子:

FROM centos
RUN yum -y install wget
RUN wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz"
RUN tar -xvf redis.tar.gz

执行以上 Dockerfile 会创建 3 层,另外,下载的 redis.tar.gz也没有删除掉,可优化成下面这样:

FROM centos
RUN yum -y install wget \
    && wget -O redis.tar.gz "http://download.redis.io/releases/redis-5.0.3.tar.gz" \
    && tar -xvf redis.tar.gz \
    && rm redis.tar.gz

如上,仅仅使用了一个 RUN 指令,并使用 && 将各个命令串联起来。之前的 3 层被简化为了 1 层,同时删除了无用的压缩包。

Dockerfile 支持 shell 格式命令末尾添加 \ 换行,以及行首通过 # 进行注释。保持良好的编写习惯,如换行、注释、缩进等,可以让 Dockerfile 更易于维护。

构建镜像

Dockerfile 文件编写好了以后,就可以通过它构建镜像了。接下来,我们来构建前面定制的 nginx 镜像,首先,进入到该 Dockerfile 所在的目录下,执行如下命令:

docker build -t nginx:test .

注意:命令的最后有个点 . , 很多小伙伴不注意会漏掉,.指定上下文路径,也表示在当前目录下。

"通过 Dockerfile 构建 Docker 镜像""通过 Dockerfile 构建 Docker 镜像"

构建命令执行完成后,执行 docker images 命令查看本地镜像是否构建成功:

Docker 查看本地镜像列表Docker 查看本地镜像列表

镜像构建成功后,运行 Nginx 容器:

docker run -d -p 80:80 --name nginx nginx:test

容器运行成功后,访问 localhost:80, 可以看到首页已经被成功修改了:

测试新构建的 Docker 容器测试新构建的 Docker 容器

镜像构建之上下文路径

前面的构建命令最后有一个 ., 它表示上下文路径,它又是个啥?

docker build -t nginx:test .

理解它之前,我们要知道 Docker 在运行时分为 Docker 引擎和客户端工具,是一种 C/S 架构。看似我们在命令收入了一行 Docker 命令,立即就执行了,背后其实是将命令提交给了客户端,然后客户端通过 API 与 Docker 引擎交互,真正干活的其实是 Docker 引擎。

话说回来,在构建镜像时,经常会需要通过 COPYADD 指令将一些本地文件复制到镜像中。而刚才我们也说到了,执行 docker build 命令并非直接在本地构建,而是通过 Docker 引擎来完成的,那么要如何解决 Docker 引擎获取本地文件的问题呢?

于是引入了上下文的概念。构建镜像时,指定上下文路径,客户端会将路径下的所有内容打包,并上传给 Docker 引擎,这样它就可以获取构建镜像所需的一切文件了。

注意:上下文路径下不要放置一些无用的文件,否则会导致打包发送的体积过大,速度缓慢而导致构建失败。当然,我们也可以想编写 .gitignore 一样的语法写一个 .dockerignore, 通过它可以忽略上传一些不必要的文件给 Docker 引擎。

docker build 的其他用法

通过 Git repo 构建镜像

除了通过 Dockerfile 来构建镜像外,还可以直接通过 URL 构建,比如从 Git repo 中构建:

# $env:DOCKER_BUILDKIT=0
# export DOCKER_BUILDKIT=0

$ docker build -t hello-world https://github.com/docker-library/hello-world.git#master:amd64/hello-world

Step 1/3 : FROM scratch
 --->
Step 2/3 : COPY hello /
 ---> ac779757d46e
Step 3/3 : CMD ["/hello"]
 ---> Running in d2a513a760ed
Removing intermediate container d2a513a760ed
 ---> 038ad4142d2b
Successfully built 038ad4142d2b

上面的命令指定了构建所需的 Git repo, 并且声明分支为 master, 构建目录为 amd64/hello-world。运行命令后,Docker 会自行 git clone 这个项目,切换分支,然后进入指定目录开始构建。

通过 tar 压缩包构建镜像

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

如果给定的 URL 是个 tar 压缩包,那么 Docker 会自动下载这个压缩包,并自动解压,以其作为上下文开始构建。

从标准输入中读取 Dockerfile 进行构建

docker build - < Dockerfile

cat Dockerfile | docker build -

标准输入模式下,如果传入的是文本文件,Docker 会将其视为 Dockerfile,并开始构建。需要注意的是,这种模式是没有上下文的,它无法像其他方法那样将本地文件通过 COPY 指令打包进镜像。

从标准输入中读取上下文压缩包进行构建

$ docker build - < context.tar.gz

标准输入模式下,如果传入的是压缩文件,如 tar.gzgzipbzip2 等,Docker 会解压该压缩包,并进入到里面,将里面视为上下文,然后开始构建。