当前位置： 首页 > news >正文

Docker 镜像制作（Dockerfile）

news 来源：原创 2024/9/19 8:28:41

1 Dockerfile 概念

Dockerfile 是什么？
  镜像的定制实际上就是定制每一层所添加的配置、文件。如果我们可以把每一层修改、安装、构建、操作的命令都写入一个脚本，用这个脚本来构建、定制镜像,这个脚本就是 Dockerfile。
  Dockerfile 是一个文本文件，其内包含了一条条的指令(Instruction)， 每一条指令构建一层，因此每一条指令的内容，就是描述该层应当如何构建。

为什么需要 Dockerfile？
可以按照需求自定义镜像：
  和 docker commit 一样能够自定义镜像，官方的镜像可以说很少能直接满足
我们应用的，都需要我们自己打包自己的代码进去然后做成对应的应用镜像对外
使用。
很方便的自动化构建，重复执行：
  通过 dockerfile 可以自动化的完成镜像构建，而不是像 docker commit 一样，
手动一个命令一个命令执行，而且可以重复执行， docker commit 的话很容易忘
记执行了哪个命令，哪个命令没有执行。
维护修改方便，不再是黑箱操作：
  使用 docker commit 意味着所有对镜像的操作都是黑箱操作，生成的镜像也
被称为黑箱镜像,dockerfile 很容易二次开发。
更加标准化，体积可以做的更小：
  docker 容器启动后，系统运行会生成很多运行时的文件，如果使用 commit 会
导致这些文件也存储到镜像里面，而且 commit 的时候安装了很多的依赖文件，
没有有效的清理机制的话会导致镜像非常的臃肿。使用 Dockerfile 则会更加标准
化，而且提供多级构建，将编译和构建分开，不会有运行时的多余文件，更加的
标准化。

2 Dockerfile 指令

2.1 FROM

•功能：
￮ FROM 指令用于为镜像文件构建过程指定基础镜像，后续的指令运行于此基础镜像所提供的运行环境；
注意事项
￮ FROM 指令必须是 Dockerfile 中非注释行或者 ARG 之后的第一个指令；
￮ 实践中，基准镜像可以是任何可用镜像文件，默认情况下， docker build 会在docker 主机上查找指定的镜像文件，在其不存在时，则会自动从 Docker 的公共库 pull 镜像下来。如果找不到指定的镜像文件， docker build 会返回一个错误信息；
￮ FROM 可以在一个 Dockerfile 中出现多次，如果有需求在一个 Dockerfile 中创建多个镜像,或将一个构建阶段作为另一个的依赖。
￮ 如果 FROM 语句没有指定镜像标签，则默认使用 latest 标签。

FROM [--platform=<platform>] <image> [AS <name>]
FROM [--platform=<platform>] <image>[:<tag>] [AS <name>]
FROM [--platform=<platform>] <image>[@<digest>] [AS <name>]

• 参数
￮ <platform>:构建的 cpu 架构，如 linux/amd64, linux/arm64,windows/amd64
￮ <image>：指定作为 base image 的名称；
￮ <tag>： base image 的标签，省略时默认 latest；
￮ <digest>：是镜像的哈希码；
￮ AS <name>: 指定构建步骤的名称，配合 COPY --from=<name>可以完成多级构建；

实操：

打开Dockerfile文件

vim Dockerfile

编辑一下代码

FROM ubuntu:22.04 as baseOs

执行命令

docker build -t testimage:v0.1 .

2.2 LABEL

• 功能
￮ 为镜像添加元数据，元数据是 kv 对形式;

LABEL <key>=<value> <key>=<value> <key>=<value> ...

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"

执行命令

docker build -t testimage:v0.2 .

docker inspect testimage:v0.2

获得如下字段 

2.3 COPY 

• 功能
￮ 用于从 docker 主机复制新文件或者目录至创建的新镜像指定路径中 。

COPY [--chown=<user>:<group>] <src>... <dest>
COPY [--chown=<user>:<group>] ["<src>",... "<dest>"]

• 参数
￮ <src>：要复制的源文件或目录， 支持使用通配符；
￮ <dest>：目标路径，即正在创建的 image 的文件系统路径； 建议<dest>使用绝对路径，否则， COPY 指定以 WORKDIR 为当前路径在路径中有空白字符时，通常使用第 2 种格式；
￮ --chown：修改用户和组
￮ --from <name>可选项 :
▪ 可以从之前构建的步骤中拷贝内容，结合 FROM .. AS <name>往往用作多级构建
• 注意事项
￮ <src>必须是 build 上下文中的路径， 不能是其父目录中的文件；
￮ 如果<src>是目录，则其内部文件或子目录会被递归复制，但<src>目录自身不会被复制；
￮ 如果指定了多个<src>，或在<src>中使用了通配符，则<dest>必须是一个目录，且必须以 / 结尾；
￮ 如果<dest>事先不存在，它将会被自动创建，这包括父目录路径。 

实操：

随便创建一个文件

touch code.cc

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
COPY code.cc /data/code/

 执行命令

docker build -t testimage:v0.3 .

docker run -it --rm testimage:v0.3 ls /data/code

 发现该目录下果然拷贝有code.cc

2.4 ENV

• 功能
￮ 用于为镜像定义所需的环境变量，并可被 Dockerfile 文件中位于其后的其它指令(如 ENV、 ADD、 COPY 等)所调用
￮ 调用格式为$variable_name 或 ${variable_name}

ENV <key>=<value> ...

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
COPY code.cc ${DIR}

 执行命令

docker build -t testimage:v0.4 .

 效果同2.3故省略后续操作

2.5 WORKDIR

• 功能
￮ 为 Dockerfile 中所有的 RUN、 CMD、 ENTRYPOINT、 COPY 和 ADD 指定设定工作目录

WORKDIR /path/to/workdir

• 注意事项
￮ 默认的工作目录是/
￮ 如果提供了相对路径，它将相对于前一条 WORKDIR 指令的路径。
￮ WORKDIR 指令可以解析先前使用设置的环境变量 ENV。

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
COPY code.cc ${DIR}
WORKDIR /usr/local

 执行命令

docker build -t testimage:v0.5 .

pwd查看虚拟机工作目录

2.6 ADD

功能
￮ ADD 指令类似于 COPY 指令， ADD 支持使用 TAR 文件和 URL 路径,会自动完成解压和下载；

ADD [--chown=<user>:<group>] <src>... <dest>
ADD [--chown=<user>:<group>] ["<src>",... "<dest>"]

• 参数
￮ <src>：要复制的源文件或目录， 支持使用通配符；
￮ <dest>：目标路径，即正在创建的 image 的文件系统路径； 建议<dest>使用绝对路径，否则， ADD 指定以 WORKDIR 为其实路径；在路径中有空白字符时，通常使用第 2 种格式；
￮ --chown：修改用户和组

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src

执行命令

docker build -t dockerimage:v0.6 .

 最后效果

如果指定的是URL它的压缩包没有被解压，但是如果是宿主机上的压缩包就会被解压 ；

2.7 RUN

• 功能
￮ 用于指定 docker build 过程中运行的程序，其可以是任何命令；

#shell form
RUN <command>
#exec form 推荐这种
RUN ["executable", "param1", "param2"]

• 参数
￮ 第一种格式中， <command>通常是一个 shell 命令， 且以“/bin/sh -c”来运行它,Windows 默认为 cmd /S /C。如果一个脚本 test.sh 不能自己执行，必须要/bin/sh -c test.sh 的方式来执行，那么，如果使用 RUN 的 shell 形式，最后得到的命令相当于：
 

/bin/sh -c "/bin/sh -c 'test.sh'"

￮ 第二种语法格式中的参数是一个 JSON 格式的数组，其中<executable>为要运行的命令，后面的 <paramN>为传递给命令的选项或参数；然而，此种格式指定的命令不会以“/bin/sh -c”来发起，因此常见的 shell 操作如变量替换以及通配符(?,*等)替换将不会进行；不过，如果要运行的命令依赖于此 shell 特性的话，可以将其替换为类似下面的格式。

RUN ["/bin/bash", "-c", "<executable>","<param1>"]

实操

编辑Dockerfile

 

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src
RUN cd ./src && tar zxvf ${NGINX_VERSION}.tar.gz

执行命令

docker build -t testimage:v0.7 .

 查看效果

2.8 CMD

• 功能
￮ 类似于 RUN 指令， CMD 指令也可用于运行任何命令或应用程序，不过，二者的运行时间点不同
￮ RUN 指令运行于映像文件构建过程中，而 CMD 指令运行于基于 Dockerfile构建出的新映像文件启动一个容器时
￮ CMD 指令的首要目的在于为启动的容器指定默认要运行的程序，且其运行结束后，容器也将终止；不过， CMD 指定的命令其可以被 docker run 的命令行选项所覆盖
￮ 在 Dockerfile 中可以存在多个 CMD 指令，但仅最后一个会生效

CMD ["executable","param1","param2"] (exec form, this is the
preferred form)
CMD ["param1","param2"] (as default parameters to ENTRYPOINT)
CMD command param1 param2 (shell form)

2.9 EXPOSE

• 功能
￮ 用于为容器声明打开指定要监听的端口以实现与外部通信
￮ 该 EXPOSE 指令实际上并不发布端口。它充当构建图像的人和运行容器的人之间的一种文档，关于要发布哪些端口。要在运行容器时实际发布端口，使用-p 参数发布和映射一个或多个端口，或者使用-Pflag 发布所有暴露的端口并将它们映射宿主机端口；

EXPOSE <port> [<port>/<protocol>...]

• 参数
￮ <protocol>： tcp/udp 协议
￮ <port>：端口

2.10 ENTRYPOINT

• 功能
￮ 用于指定容器的启动入口

#exec from
ENTRYPOINT ["executable", "param1", "param2"]
# shell form
ENTRYPOINT command param1 param2

实操：

编辑Dockerfile

FROM ubuntu:22.04 as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src
RUN cd ./src && tar zxvf ${NGINX_VERSION}.tar.gz
#1.安装 build-essential 构建工具
#2.安装依赖包 libpcre3 libpcre3-dev zlib1g-dev 依赖库
RUN apt-get update -y && apt install -y build-essential libpcre3 libpcre3-dev zlib1g-dev
#3.进入 nginx 目录
#4.执行编译和构建
RUN cd ./src/${NGINX_VERSION} \
&& ./configure --prefix=/usr/local/nginx \
&& make && make install
ENTRYPOINT ["/usr/local/nginx/sbin/nginx","-g daemon off;"]

 2.11 ARG

• 功能
￮ ARG 指令类似 ENV，定义了一个变量；区别于 ENV：用户可以在构建时
docker build --build-arg <varname> = <value> 进行对变量的修改； ENV 不可以；
￮ 如果用户指定了未在 Dockerfile 中定义的构建参数，那么构建输出警告。

ARG <name>[=<default value>]

• 注意事项
￮ Dockerfile 可以包含一个或多个 ARG 指令
￮ ARG 支持指定默认值
￮ 使用范围：定义之后才能使用，定义之前为空

￮ ENV 和 ARG 同时存在， ENV 会覆盖 ARG

实操：
编辑Dockerfile

ARG UBUNTU_VERSION=22.04
FROM ubuntu:${UBUNTU_VERSION} as baseOs
LABEL whoami="a coder"
ENV DIR=/data/code/
ENV NGINX_VERSION="nginx-1.22.1"
COPY code.cc ${DIR}
WORKDIR /usr/local
ADD https://nginx.org/download/${NGINX_VERSION}.tar.gz ./src
RUN cd ./src && tar zxvf ${NGINX_VERSION}.tar.gz
#1.安装 build-essential 构建工具
#2.安装依赖包 libpcre3 libpcre3-dev zlib1g-dev 依赖库
RUN apt-get update -y && apt install -y build-essential libpcre3 libpcre3-dev zlib1g-dev
#3.进入 nginx 目录
#4.执行编译和构建
RUN cd ./src/${NGINX_VERSION} \
&& ./configure --prefix=/usr/local/nginx \
&& make && make install
ENTRYPOINT ["/usr/local/nginx/sbin/nginx","-g daemon off;"]

执行命令

docker build --build-arg UBUNTU_VERSION=22.10 -t testimage:v0.9 .

 如果拉取镜像较慢可以先docker pull将ubuntu22.10拉取到本地

2.12 VOLUME（了解）

• 功能
￮ 用于在 image 中创建一个挂载点目录
￮ 通过 VOLUME 指令创建的挂载点，无法指定主机上对应的目录，是自动生成的。

VOLUME <mountpoint>
VOLUME ["<mountpoint>"]

• 参数
￮ mountpoint:挂载点目录
￮ 注意事项
▪ 如果挂载点目录路径下此前有文件存在， docker run 命令会在卷挂载完
成后将此前的所有文件复制到新挂载的卷中
▪ 其实 VOLUME 指令只是起到了声明了容器中的目录作为匿名卷，但是并
没有将匿名卷绑定到宿主机指定目录的功能。
▪ volume 只是指定了一个目录，用以在用户忘记启动时指定-v 参数也可以
保证容器的正常运行。比如 mysql，你不能说用户启动时没有指定-v，然后
删了容器，就把 mysql 的数据文件都删了，那样生产上是会出大事故的，所
以 mysql 的 dockerfile 里面就需要配置 volume，这样即使用户没有指定-v，
容器被删后也不会导致数据文件都不在了。还是可以恢复的。
▪ volume 与-v 指令一样，容器被删除以后映射在主机上的文件不会被删除。
▪ 如果-v 和 volume 指定了同一个位置，会以-v 设定的目录为准，其实
volume 指令的设定的目的就是为了避免用户忘记指定-v 的时候导致的数据丢
失，那么如果用户指定了-v，自然而然就不需要 volume 指定的位置了。

2.13 SHELL（了解）

• 功能
￮ SHELL 指令允许覆盖用于 shell 命令形式的默认 shell。

#Linux 上的默认 shell 是["/bin/sh"， "-c"]
#在 Windows 上是["cmd"， "/S"，"/C"]

￮ SHELL 指令必须以 JSON 格式写入 Dockerfile。

SHELL ["executable", "parameters"]

• 参数
￮ executable： shell 可执行文件的位置
￮ parameters： shell 执行的参数
￮ 注意事项
▪ SHELL 指令可以多次出现。
▪ 每个 SHELL 指令都会覆盖所有先前的 SHELL 指令，并影响所有后续指令。
▪ 该 SHELL 指令在 Windows 上特别有用，因为 windows 行有两种不同的
shell： cmd 和 powershell

2.14 USER (了解)

• 功能
￮ 用于指定运行 image 时的或运行 Dockerfile 中任何 RUN、 CMD 或
ENTRYPOINT 指令定的程序时的用户名或 UID
￮ 默认情况下， container 的运行身份为 root 用户

USER <user>[:<group>]
USER <UID>[:<GID>]

• 参数
￮ user:用户
￮ group：用户组
￮ uid:用户 id
￮ gid:组 id
￮ 注意事项
▪ <UID>可以为任意数字，但实践中其必须为/etc/passwd 中某用户的有效
UID,否则将运行失败

2.15 HEALTHCHECK（了解）

• 功能
￮ HEALTHCHECK 指令告诉 Docker 如何测试容器以检查它是否仍在工作。
￮ 即使服务器进程仍在运行，这也可以检测出陷入无限循环且无法处理新连接
的 Web 服务器等情况

HEALTHCHECK [OPTIONS] CMD command (check container health by
running a command inside the container)
HEALTHCHECK NONE (disable any healthcheck inherited from the base
image)

• 参数
￮ OPTIONS 选项有：
▪ --interval=DURATION (default: 30s)：每隔多长时间探测一次，默认 30
秒 ▪
-- timeout= DURATION (default: 30s)：服务响应超时时长，默认 30 秒
▪ --start-period= DURATION (default: 0s)：服务启动多久后开始探测，默
认 0 秒
▪ --retries=N (default: 3)：认为检测失败几次为宕机，默认 3 次
￮ 返回值
▪ 0：容器成功是健康的，随时可以使用
▪ 1：不健康的容器无法正常工作
▪ 2：保留不使用此退出代码

#样例
HEALTHCHECK --interval=5m --timeout=3s \
CMD curl -f http://localhost/ || exit 1

2.16 ONBUILD

• 功能
￮ 用于在 Dockerfile 中定义一个触发器
￮ 以该 Dockerfile 中的作为基础镜像由 FROM 指令在 build 过程中被执行时，
将会“触发”创建其 base image 的 Dockerfile 文件中的 ONBUILD 指令定义的触
发器

#样例
ONBUILD ADD . /app/src

3 docker build

• 功能

docker build 命令用于使用 Dockerfile 创建镜像。

docker build [OPTIONS] PATH | URL | -

• 关键参数
￮ --build-arg=[] :设置镜像创建时的变量；
￮ -f :指定要使用的 Dockerfile 路径；
￮ --label=[] :设置镜像使用的元数据；
￮ --no-cache :创建镜像的过程不使用缓存；
￮ --pull :尝试去更新镜像的新版本；
￮ --quiet, -q :安静模式，成功后只输出镜像 ID；
￮ --tag, -t: 镜像的名字及标签，通常 name:tag 或者 name 格式；可以在一次构
建中为一个镜像设置多个标签。
￮ --network: 默认 default。在构建期间设置 RUN 指令的网络模式

相关文章：

  • 北京网站建设多少钱？
  • 辽宁网页制作哪家好_网站建设
  • 高端品牌网站建设_汉中网站制作
  • C++之第十二课
  • 华为OD机试 - 二维伞的雨滴效应（Python/JS/C/C++ 2024 E卷 200分）
  • 【新手上路】衡石分析平台使用手册-租户管理
  • 硬件看门狗导致MCU启动时间慢
  • Flask-JWT-Extended登录验证
  • python基础（1）pyenv安装和对Django使用
  • Python 入门教程（4）数据类型 | 4.5、字符串类型
  • Scala尾递归解决爆栈问题
  • Python VS Golng 谁更胜一筹？
  • 智能化技术在灌区管理中的应用前景
  • 开源模型应用落地-qwen模型小试-调用Qwen2-VL-7B-Instruct-更清晰地看世界-集成vLLM（二）
  • AI教你学Python 第12天 ： Lambda 表达式
  • Vue3使用shapefile读取矢量数据，以数组形式返回坐标点
  • [SDX35+WCN6856]SDX35 + WCN6856 WiFi导致系统crash问题分析及解决方案
  • .Net Core 生成管理员权限的应用程序
  • 【comparator, comparable】小总结
  • Android优雅地处理按钮重复点击
  • DOM的那些事
  • JAVA并发编程--1.基础概念
  • JS笔记四：作用域、变量（函数）提升
  • select2 取值 遍历 设置默认值
  • Spring框架之我见（三）——IOC、AOP
  • tensorflow学习笔记3——MNIST应用篇
  • 机器学习中为什么要做归一化normalization
  • 蓝海存储开关机注意事项总结
  • 猫头鹰的深夜翻译：JDK9 NotNullOrElse方法
  • 如何使用Mybatis第三方插件--PageHelper实现分页操作
  • 深入浅出webpack学习(1)--核心概念
  • 详解NodeJs流之一
  • 移动端唤起键盘时取消position:fixed定位
  • 异步
  • 追踪解析 FutureTask 源码
  • Mac 上flink的安装与启动
  • 关于Kubernetes Dashboard漏洞CVE-2018-18264的修复公告
  • ​浅谈 Linux 中的 core dump 分析方法
  • ​十个常见的 Python 脚本 (详细介绍 + 代码举例)
  • # 20155222 2016-2017-2 《Java程序设计》第5周学习总结
  • # centos7下FFmpeg环境部署记录
  • # 手柄编程_北通阿修罗3动手评：一款兼具功能、操控性的电竞手柄
  • #Datawhale AI夏令营第4期#AIGC方向 文生图 Task2
  • #Java第九次作业--输入输出流和文件操作
  • #nginx配置案例
  • $ git push -u origin master 推送到远程库出错
  • (1) caustics\
  • (C++)栈的链式存储结构(出栈、入栈、判空、遍历、销毁)(数据结构与算法)
  • （C语言）fread与fwrite详解
  • （ISPRS，2021）具有遥感知识图谱的鲁棒深度对齐网络用于零样本和广义零样本遥感图像场景分类
  • （PADS学习）第二章：原理图绘制 第一部分
  • （第8天）保姆级 PL/SQL Developer 安装与配置
  • （四）搭建容器云管理平台笔记—安装ETCD(不使用证书)
  • (译) 函数式 JS #1：简介
  • (转)ABI是什么
  • （转）微软牛津计划介绍——屌爆了的自然数据处理解决方案(人脸/语音识别，计算机视觉与语言理解)...
  • ******IT公司面试题汇总+优秀技术博客汇总
  • .dat文件写入byte类型数组_用Python从Abaqus导出txt、dat数据