罗罗编程学习记录
本页内容 展开查看

08.1.1.2 Dockerfile 指令与 ENTRYPOINT/CMD

所属:全栈开发面试题库 / 08 云原生与 DevOps / 08.1 容器化 / 08.1.1 Docker 镜像与构建

08.1.1.2-001 FROM 指令起什么作用?

一句话结论

FROM 指定镜像的基础镜像,是 Dockerfile 的第一条有效指令,决定底层层、包管理体系与运行环境。

概念解释

  • 基础镜像可以是公开镜像、私有仓库镜像或前序构建阶段。
  • 建议固定版本标签,避免浮动 tag 导致不可复现。
  • FROM scratch 表示从空根文件系统开始构建。

原理流程

  1. 解析基础镜像并拉取本地缺失层。
  2. 在其之上叠加后续层。
  3. 基础镜像配置(环境变量、默认启动命令)作为初始配置继承。

代码 / 示例

FROM eclipse-temurin:21-jre

常见误区

  • 误区:FROM 只是写个名字;正解:它决定底层 OS、运行时与已安装工具,是镜像兼容性的根基。
  • 误区:基础镜像可以随时换;正解:更换基础镜像可能改变系统库与行为,需要回归验证。

追问

  • Q:同一 Dockerfile 可以有多个 FROM 吗? A:可以,多个 FROM 即多阶段构建,每个 FROM 开启一个新阶段。
  • Q:基础镜像版本怎么锁? A:使用具体版本标签,必要时按 digest 锁定。

08.1.1.2-002 WORKDIR 的作用是什么?

一句话结论

WORKDIR 设置后续指令的工作目录,目录不存在时自动创建;它同时影响容器启动后的默认工作目录。

概念解释

  • 后续 RUN、CMD、ENTRYPOINT、COPY 等相对路径都基于该目录解析。
  • 多次 WORKDIR 可切换目录,相对路径可叠加。
  • 避免依赖容器内当前目录不确定导致的路径错误。

原理流程

  1. 构建到 WORKDIR 指令时创建/切换目录。
  2. 后续指令在该目录执行。
  3. 镜像配置记录默认工作目录,容器启动后进入该目录。

代码 / 示例

WORKDIR /app
COPY jar/app.jar /app/app.jar
# 等价于 COPY jar/app.jar ./app.jar

常见误区

  • 误区:不写 WORKDIR 也能用相对路径;正解:默认目录不确定,相对路径容易解析到错误位置。
  • 误区:WORKDIR 只是构建期概念;正解:它也写入镜像配置,决定容器内默认工作目录。

追问

  • Q:WORKDIR 与 cd 有什么区别? A:RUN cd /x && ... 只在该条命令内生效;WORKDIR 对后续所有指令持续生效。
  • Q:路径不存在会自动创建吗? A:会,WORKDIR 会按需创建目录。

08.1.1.2-003 ENV 和 ARG 有什么区别?

一句话结论

ARG 是构建期变量,只在构建过程中可用,不进入运行时环境;ENV 写入镜像配置,容器运行时仍然存在。

概念解释

  • ARG:通过 --build-arg 传入,作用域限于构建阶段。
  • ENV:持久化到镜像,容器内进程可读。
  • ARG 可以被同名 ENV 在构建期固化下来。

原理流程

  1. 构建器读取 ARG 默认值或命令行传入值。
  2. 构建指令引用 ARG 完成编译/下载等动作。
  3. ENV 写入镜像配置,运行时注入容器环境。

代码 / 示例

ARG JAR_VERSION=1.4.0
ENV APP_HOME=/app
COPY target/app-${JAR_VERSION}.jar ${APP_HOME}/app.jar

常见误区

  • 误区:ARG 会留在容器环境变量里;正解:ARG 不进入运行时,需要留存应显式写 ENV。
  • 误区:ENV 改了不用重建镜像;正解:ENV 是镜像配置,变更需要重新构建。

追问

  • Q:敏感信息适合用 ARG 传吗? A:不适合直接传密钥,构建历史可能留存;应使用构建 secret 机制或运行时注入。
  • Q:ARG 默认值在哪里定义? A:在 Dockerfile 中 ARG 名=默认值,命令行 --build-arg 名=值 覆盖。

08.1.1.2-004 RUN、CMD、ENTRYPOINT 三者有什么区别?

一句话结论

RUN 在构建期执行命令并提交层;CMD 提供容器默认启动命令或参数;ENTRYPOINT 固定容器主程序,三者执行时机与可覆盖性不同。

概念解释

  • RUN:构建时执行,装依赖、产文件。
  • CMD:容器启动时默认运行,可被 docker run 参数覆盖。
  • ENTRYPOINT:容器启动的固定入口,CMD 通常作为其默认参数。

原理流程

  1. 构建阶段:逐条执行 RUN 提交层。
  2. 启动阶段:运行时组合 ENTRYPOINT 与 CMD 得到主进程命令行。
  3. docker run 末尾参数可覆盖 CMD,配合 --entrypoint 可覆盖入口。

代码 / 对照

指令 时机 作用 可覆盖性
RUN 构建期 产生镜像层 不可在运行时改
CMD 运行期 默认命令/参数 易被 run 参数覆盖
ENTRYPOINT 运行期 固定主程序 需 --entrypoint 覆盖

常见误区

  • 误区:CMD 是构建时执行的命令;正解:CMD 只在容器启动时运行。
  • 误区:ENTRYPOINT 和 CMD 二选一即可;正解:固定程序用 ENTRYPOINT、可变参数用 CMD 是常见组合。

追问

  • Q:一个 Dockerfile 能写多个 CMD 吗? A:可以写多条,但只有最后一条生效;ENTRYPOINT 同理。
  • Q:RUN 安装的软件在容器里还在吗? A:在,RUN 产物已提交进镜像层。

08.1.1.2-005 shell 形式和 exec 形式有什么区别?

一句话结论

exec 形式是 JSON 数组 ["程序","参数"],直接以该程序为 PID 1;shell 形式写成字符串,会包一层 /bin/sh -c 执行,信号转发与进程身份不同。

概念解释

  • exec 形式:["java","-jar","app.jar"],无中间 shell。
  • shell 形式:java -jar app.jar,由 shell 解释执行。
  • 形式选择直接影响信号处理(详见 08.1.2.6)。

原理流程

  1. exec 形式:运行时直接启动数组第一个程序。
  2. shell 形式:启动 /bin/sh -c "命令",shell 再派生子进程。
  3. shell 作为 PID 1 时通常不转发信号给子进程。

代码 / 示例

# exec 形式(推荐用于主程序)
ENTRYPOINT ["java", "-jar", "/app/app.jar"]
# shell 形式(会包一层 shell)
ENTRYPOINT java -jar /app/app.jar

常见误区

  • 误区:两种形式效果完全一样;正解:进程树、信号转发、退出码语义都不同。
  • 误区:JSON 数组里可以写 shell 变量展开;正解:exec 形式不经过 shell,变量展开需在程序内或改用 shell 形式。

追问

  • Q:exec 形式为什么推荐用于服务镜像? A:主程序直接成为 PID 1,能收到停止信号并做优雅退出。
  • Q:shell 形式下变量怎么展开? A:由 /bin/sh -c 解析,环境变量在 shell 层展开。

08.1.1.2-006 ENTRYPOINT 与 CMD 如何组合?

一句话结论

ENTRYPOINT 定义固定主程序,CMD 提供默认参数;docker run 末尾追加的参数会覆盖 CMD 并传给 ENTRYPOINT。

概念解释

  • 组合后实际命令行 = ENTRYPOINT 数组 + CMD 数组 + run 追加参数。
  • 固定程序、可变参数是服务镜像的常见写法。
  • 只有 CMD 时,run 参数直接整体覆盖 CMD。

原理流程

  1. 镜像配置记录 ENTRYPOINT 与 CMD。
  2. 启动时拼接二者。
  3. 命令行参数替换 CMD 部分。

代码 / 示例

ENTRYPOINT ["nginx"]
CMD ["-g", "daemon off;"]
# 启动等价:nginx -g "daemon off;"
# docker run img -v  等价:nginx -v

常见误区

  • 误区:run 追加参数会替换 ENTRYPOINT;正解:默认只覆盖 CMD,ENTRYPOINT 保持不变。
  • 误区:CMD 里写的是完整启动命令;正解:与 ENTRYPOINT 搭配时 CMD 通常只放参数。

追问

  • Q:如何临时覆盖入口程序? A:docker run --entrypoint <程序> <镜像> [参数]。
  • Q:CMD 写成数组和字符串在组合时有何不同? A:字符串形式经 shell 解析,数组形式按参数原样传递。

08.1.1.2-007 CMD 在哪些场景会被覆盖?

一句话结论

docker run <镜像> <命令> 末尾给出命令参数时,镜像默认 CMD 被覆盖;使用 Compose 或 K8s 时,对应 command/args 字段同样覆盖镜像 CMD。

概念解释

  • 覆盖发生在启动配置层,不改镜像本身。
  • ENTRYPOINT 未被覆盖时,覆盖内容作为其参数。
  • 编排平台字段与 Docker 命令参数存在对应关系。

原理流程

  1. 读取镜像默认 ENTRYPOINT/CMD。
  2. 启动配置中的命令/参数覆盖 CMD。
  3. 拼接后启动容器进程。

代码 / 示例

# Kubernetes 中 command 对应 ENTRYPOINT,args 对应 CMD
command: ["java"]
args: ["-jar", "/app/app.jar"]

常见误区

  • 误区:覆盖 CMD 会修改镜像;正解:只改本次启动的容器配置。
  • 误区:Compose 的 command 覆盖 ENTRYPOINT;正解:它对应覆盖 CMD,覆盖入口需用 entrypoint 字段。

追问

  • Q:镜像 CMD 为空会怎样? A:依赖 ENTRYPOINT 或外部传入参数启动,否则容器可能因缺少启动命令而退出。
  • Q:如何验证最终启动命令? A:docker inspect 查看配置中的 Entrypoint 与 Cmd 字段。

08.1.1.2-008 LABEL 指令有什么用?

一句话结论

LABEL 以键值对形式向镜像附加元数据(维护者、版本、制品信息等),可被工具检索与筛选。

概念解释

  • LABEL 写入镜像配置,不产生文件系统层。
  • 可用于标注构建来源、责任团队、许可证等。
  • 与容器上的标签(label selector)概念不同,勿混淆。

原理流程

  1. 在 Dockerfile 中声明键值对。
  2. 构建时合并进镜像配置。
  3. 用 inspect 或标签查询工具读取。

代码 / 示例

LABEL org.opencontainers.image.title="order-service" \
      org.opencontainers.image.version="1.4.0"

常见误区

  • 误区:LABEL 替代 MAINTAINER;正解:历史上的 MAINTAINER 已废弃,维护者信息用 LABEL 表达。
  • 误区:LABEL 能参与镜像分层复用;正解:它是元数据,不形成文件层。

追问

  • Q:OCI 预定义标签有哪些? A:如 title、version、description、source、revision 等,具体键名见 OCI image-spec 注解约定。
  • Q:标签信息放镜像还是仓库元数据? A:制品库保留构建溯源信息,镜像 LABEL 承载随镜像流转的基础元数据。

08.1.1.2-009 USER 指令解决什么问题?

一句话结论

USER 设置镜像运行时的用户(或 UID),让容器主进程不以 root 身份运行,是容器最小权限的基础手段之一。

概念解释

  • 未设置 USER 时,容器内默认用户取决于基础镜像配置。
  • 用户需在镜像内提前创建,或使用已知 UID。
  • 文件属主与权限要与该用户匹配,避免启动后无权读写。

原理流程

  1. 在 Dockerfile 中创建用户/组。
  2. 切换文件属主到该用户。
  3. USER 指令设置后续 RUN 与运行时用户。

代码 / 示例

RUN useradd -r -u 10001 appuser
COPY --chown=appuser:appuser app /app
USER appuser

常见误区

  • 误区:加了 USER 就等于容器安全;正解:非 root 只是基础措施,还需 capabilities、seccomp、只读文件系统等配合。
  • 误区:用户已在宿主创建即可;正解:容器有独立用户视图,需在镜像内创建或使用显式 UID。

追问

  • Q:以非 root 运行后端口绑定受限吗? A:非特权进程不能绑定 1024 以下端口(未授予相应 capabilities 时),业务端口应使用高位端口。
  • Q:K8s 中如何再指定运行用户? A:Pod securityContext 的 runAsUser/runAsNonRoot 字段可覆盖镜像 USER。

08.1.1.2-010 EXPOSE 指令是真正开放端口吗?

一句话结论

EXPOSE 只是文档性声明,记录镜像预期使用的端口与协议,不会自动发布端口;对外发布需要 -p、Compose 端口映射或编排平台的暴露配置。

概念解释

  • EXPOSE 写入镜像元数据,供人阅读与工具识别。
  • 实际网络可达性由端口映射与网络策略决定。
  • 不写 EXPOSE 不影响进程监听端口。

原理流程

  1. Dockerfile 声明端口。
  2. 镜像配置记录暴露端口列表。
  3. 启动时显式映射才把容器端口接到宿主或负载均衡。

代码 / 示例

EXPOSE 8080
docker run -p 8080:8080 app

常见误区

  • 误区:写了 EXPOSE 宿主就能访问;正解:它不做任何端口转发。
  • 误区:EXPOSE 必须与实际监听端口一致;正解:不一致通常不报错,但会造成运维误导。

追问

  • Q:K8s 中端口信息在哪里声明? A:ContainerPort 字段同样偏声明性质,真正访问路径由 Service/Ingress 等对象决定。
  • Q:UDP 端口怎么声明? A:EXPOSE 53/udp,协议显式标注。

08.1.1.2-011 VOLUME 指令有什么副作用?

一句话结论

VOLUME 声明容器内匿名卷挂载点,容器在该路径的数据不写入可写层,由卷存储;它会影响镜像构建期对该路径的提交行为。

概念解释

  • 匿名卷在容器创建时自动分配。
  • 构建期 VOLUME 之后对该路径的修改不会保留到镜像层。
  • 推荐在编排平台用显式卷声明,而不是依赖 Dockerfile VOLUME。

原理流程

  1. 解析 VOLUME 路径。
  2. 容器启动时在该路径挂匿名卷。
  3. 写入进入卷而非可写层。

代码 / 示例

VOLUME ["/data"]

常见误区

  • 误区:VOLUME 会把宿主目录固定挂进来;正解:它声明的是卷挂载点,具体后端由运行时/编排决定。
  • 误区:构建时往 VOLUME 路径拷文件能进镜像;正解:该路径上的层提交行为受限,预置数据应放在其他路径再由入口脚本复制。

追问

  • Q:为什么不推荐在 Dockerfile 里写 VOLUME? A:它创建匿名卷且隐式改变存储行为,显式卷声明放在部署清单中更清晰可控。
  • Q:匿名卷和命名卷区别? A:匿名卷无显式名称、生命周期跟随引用;命名卷由名称管理,便于复用与备份。

08.1.1.2-012 HEALTHCHECK 指令做什么?

一句话结论

HEALTHCHECK 定义容器内健康检查命令,运行时定期执行并据此标记 healthy/unhealthy 状态;K8s 中对应能力由探针对象承担。

概念解释

  • 支持检查命令、间隔、超时、失败阈值、启动宽限等参数。
  • 退出码语义:0 健康,1 不健康,2 保留(以官方文档为准)。
  • 只改变容器健康状态标记,不自动重启;自动重启需配合编排健康策略。

原理流程

  1. 运行时按周期在容器内执行检查命令。
  2. 根据退出码更新健康状态。
  3. 连续失败达到阈值标记不健康。

代码 / 示例

HEALTHCHECK --interval=30s --timeout=3s --retries=3 \
  CMD curl -fs http://localhost:8080/health || exit 1

常见误区

  • 误区:HEALTHCHECK 失败会自动重启容器;正解:它只上报状态,重启由外部策略决定。
  • 误区:基础镜像的健康检查可以被忽略;正解:可在 Dockerfile 中用 HEALTHCHECK NONE 禁用继承项。

追问

  • Q:检查命令需要在镜像内有对应工具吗? A:需要,curl/wget/进程检查工具必须存在于镜像中。
  • Q:Docker 健康检查与 K8s 探针是什么关系? A:两者各自独立,K8s 以 Pod 探针为准,Dockerfile 健康检查主要作用于 Docker 原生运行场景。

08.1.1.2-013 为什么 RUN 里读不到刚设置的 ENV?

一句话结论

同一 Dockerfile 中 ENV 在其指令之后才生效;若在更早的 RUN 中引用该变量,会得到空值或旧值。ENV 对后续 RUN 与运行时持续有效。

概念解释

  • ENV 写入镜像配置,按指令顺序生效。
  • 一条 RUN 内的 shell 变量赋值需要用 shell 语法显式导出。
  • 构建期 ARG 与运行期 ENV 不要混用。

原理流程

  1. 按 Dockerfile 顺序执行。
  2. ENV 指令之后的 RUN 才能看到该变量。
  3. RUN 内部 VAR=x cmd 只在该命令进程内有效。

代码 / 示例

# 错误:RUN 在 ENV 之前
RUN echo $APP_HOME
ENV APP_HOME=/app
# 正确:ENV 在前
ENV APP_HOME=/app
RUN echo $APP_HOME

常见误区

  • 误区:ENV 对所有历史指令回溯生效;正解:ENV 只影响其后的指令与运行时。
  • 误区:RUN 内 export 的变量留在镜像里;正解:只在该 RUN 进程内有效,留存要用 ENV。

追问

  • Q:RUN 内临时变量怎么写? A:RUN VAR=value command 或在同一条 shell 中 export VAR=value && command。
  • Q:运行时环境变量覆盖 ENV 可行吗? A:可以,docker run -e 或编排环境变量覆盖镜像 ENV。

08.1.1.2-014 为什么清理缓存要和安装写在同一个 RUN?

一句话结论

分层不可变:前一层安装留下的缓存,在后一层删除只会生成 whiteout,底层体积仍在;清理必须与安装合并在同一层完成。

概念解释

  • 每层独立提交,跨层删除不能回收底层文件。
  • 包管理器缓存、编译中间产物应在安装后同层清除。
  • 同层合并还减少层数。

原理流程

  1. 同一条 RUN 内更新包索引、安装软件。
  2. 紧接着删除缓存与列表文件。
  3. 该层提交时已不含残留缓存。

代码 / 示例

RUN apt-get update \
    && apt-get install -y --no-install-recommends curl \
    && rm -rf /var/lib/apt/lists/*

常见误区

  • 误区:第二条 RUN 里 rm -rf 能把前一层缓存删掉;正解:底层文件仍在,只在新层遮蔽。
  • 误区:不清理缓存不影响体积;正解:包索引与下载缓存会残留在镜像中放大体积。

追问

  • Q:npm/pip 缓存同理吗? A:同理,安装后应在同一层清理缓存目录,或在安装参数中关闭缓存。
  • Q:为什么用 --no-install-recommends? A:减少非必要推荐包进入镜像,缩小体积与攻击面。

08.1.1.2-015 镜像标签命名有什么规范建议?

一句话结论

标签应可追溯环境、版本与构建来源,避免长期依赖 latest;生产镜像使用不可变版本号或 digest 引用。

概念解释

  • 常见结构:仓库名/应用名:版本-构建号。
  • 环境区分通过仓库命名或附加后缀,而不是浮动 tag。
  • 标签在制品库中可配合签名与扫描门禁。

原理流程

  1. CI 构建产出带版本标识的镜像。
  2. 推送到制品库并记录 digest。
  3. 部署清单按版本/digest 引用。

代码 / 示例

registry.example/order-service:1.4.0-20261118.abc1234

常见误区

  • 误区:latest 就是最新稳定版;正解:latest 只是一个可被覆盖的浮动标签,不代表质量。
  • 误区:标签里写 commit 哈希没必要;正解:哈希/构建号是回滚与溯源的关键信息。

追问

  • Q:同一镜像多个 tag 怎么管理? A:同一 digest 可打多个语义化标签,避免重复存储与不一致。
  • Q:私有仓库路径怎么组织? A:按团队/环境/应用分层,具体规范随制品库约定。

08.1.1.2-016 启动参数如何在镜像与运行时之间分工?

一句话结论

镜像固化主程序与默认参数,环境相关配置通过环境变量、挂载卷或命令行参数在运行时注入,避免为每个环境构建不同镜像。

概念解释

  • 镜像一次构建、多环境部署是云原生基本实践。
  • 可变项:地址、端口、开关、外部依赖;不变项:程序与依赖。
  • 参数优先级:命令行 > 环境变量 > 镜像默认值(以应用实现为准)。

原理流程

  1. Dockerfile 用 ENTRYPOINT 固定程序,CMD 给默认参数。
  2. 运行时通过 -e、编排 env 或挂载配置覆盖可变项。
  3. 程序启动时读取配置并校验。

代码 / 示例

ENV SPRING_PROFILES_ACTIVE=dev
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

常见误区

  • 误区:每个环境单独构建镜像;正解:应通过运行时配置区分环境,镜像保持不可变。
  • 误区:把环境地址硬编码进镜像;正解:地址等环境相关项运行时注入。

追问

  • Q:敏感配置怎么注入? A:通过 Secret/外部密钥管理挂载或环境注入,不写入镜像层。
  • Q:参数覆盖顺序冲突怎么办? A:在应用配置层明确优先级并做启动校验,避免默认值意外生效。

08.1.1.2-017 相对路径在 Dockerfile 中如何解析?

一句话结论

COPY/ADD 源路径相对构建上下文解析,目标路径与后续指令相对 WORKDIR 解析;两类相对路径基准不同,混用容易出错。

概念解释

  • 源:相对上下文根。
  • 目标与工作目录:相对当前 WORKDIR。
  • 路径中避免歧义,优先使用绝对目标路径。

原理流程

  1. 确定上下文根与当前 WORKDIR。
  2. COPY 源按上下文定位文件。
  3. 目标按 WORKDIR 拼接绝对路径。

代码 / 示例

WORKDIR /app
COPY dist/app.jar ./app.jar   # 目标 /app/app.jar

常见误区

  • 误区:COPY 源路径相对 WORKDIR;正解:源路径始终相对构建上下文。
  • 误区:目标路径写相对路径会基于上下文;正解:目标基于 WORKDIR。

追问

  • Q:复制整个目录时路径末尾斜杠有何影响? A:目录拷贝行为与末尾斜杠相关,建议按官方示例确认目录/文件语义。
  • Q:路径含空格怎么处理? A:在 Dockerfile 中按指令语法加引号,避免被拆成多个参数。

08.1.1.2-018 一份生产级 Dockerfile 应遵守哪些实践?

一句话结论

固定基础镜像版本、稳定层前置、依赖与源码分层、同层清理残留、非 root 运行、只带运行所需内容,并配套 .dockerignore 与健康检查。

概念解释

  • 可复现:基础镜像与依赖版本锁定。
  • 构建快:缓存友好的层顺序。
  • 镜像小:多阶段与清理残留。
  • 安全:非 root、最小内容、不写密钥。

原理流程

  1. 选基础镜像并锁版本。
  2. 先装系统依赖与语言依赖,再拷源码。
  3. 同层清理缓存,切换非 root 用户。
  4. 声明暴露端口与健康检查,固定入口。

代码 / 示例

FROM eclipse-temurin:21-jre AS runtime
WORKDIR /app
RUN useradd -r -u 10001 appuser
COPY --from=build /app/target/app.jar /app/app.jar
RUN chown appuser:appuser /app/app.jar
USER appuser
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "/app/app.jar"]

常见误区

  • 误区:把构建工具、源码、文档都留在运行镜像里;正解:运行镜像只保留启动所需。
  • 误区:Dockerfile 能替代部署清单;正解:镜像定义运行内容,资源、网络、配置由编排对象声明。

追问

  • Q:如何评审一份 Dockerfile? A:按基础镜像、层顺序、残留清理、运行用户、入口形式、敏感信息、健康检查逐项核对。
  • Q:镜像内需要调试工具吗? A:运行镜像默认不带;排障用临时调试容器或专用调试镜像,避免扩大攻击面。