首页 文章 精选 留言 我的

精选列表

搜索[AI],共10000篇文章
优秀的个人博客,低调大师

AI时代的Docker教程36招-第7招-Dockerfile到底怎么写才算正确?

# Dockerfile 指令实战:Gateway 与 User Service 如何写出可上生产的镜像 > 镜像能跑起来不算过关,跑得干净才算数 ```text [读者] 正在把数字人平台容器化的后端与运维同学 [痛点] Dockerfile 能跑,但构建慢、镜像大、root 启动、凭据疑似残留 [现在读] Gateway 与 User Service 的镜像定义要定稿,并且要能复制到后续服务 [读完] 能按指令语义写 Dockerfile 与 .dockerignore,并说清每个取舍 ``` ```text [旧方案] FROM → COPY . . → RUN 装依赖 → CMD 起进程 | v [新需求] 多服务、多环境、多构建机,镜像要过扫描、要非 root、要能复用缓存 | v [冲突] 指令写的是“怎么装”,构建器读的是“镜像是什么”,两套语义没有对齐 | v [后果] 缓存次次失效、凭据进入历史层、容器以 root 运行、上生产前被安全卡住 ``` 我是老李,带企业数字人平台的工程组。平台从第 3 记定下的那条主线一路长出来:先是一个最小后端服务,再长出 Gateway、User Service、ASR、TTS、LLM Gateway、RAG、Avatar Inference,外围还有 PostgreSQL、Redis、对象存储和 Nginx。到这一记,仓库里已经不是一个服务,而是七八个要被构建、要被发布、要被扫描的镜像。 概念我早就理过了,Image、Layer、Tag、Digest、OCI 之间的关系能讲一遍。但理清概念不等于写对文件。真正落到 services/gateway/Dockerfile 这种文件上,多数人的写法还是从“能跑”出发:一个基础镜像,一次 COPY,一串 RUN,最后 CMD 起进程。它在本地 docker run 得起来,评审也能过,因为没人拿它去过扫描器。 到了多服务阶段,Dockerfile 就不再是个人脚本,而是团队的交付契约。同一个仓库里,Gateway 和 User Service 要共用一套写法约定;构建机要能复用缓存;安全组要拿 Scout 和 SBOM 交差;K8s 那边要求容器默认非 root。这时候,每一条指令的语义都会变成硬约束。 同一个 Dockerfile,为什么在开发机上秒过,到了构建机上却次次全量重建? 为什么把密码写进 RUN 又立刻删掉,扫描器依然能把它翻出来? 为什么镜像“看起来没问题”,一上生产就被人要求补 USER 和 HEALTHCHECK? # 01、故事 周二上午九点半,构建流水线第 14 次跑。services/gateway 和 services/user-service 同时构建,日志滚了十几分钟才走到 push 那一步。 运维往群里贴了两份东西。一份是镜像扫描结果,high 若干;另一份是 `docker inspect` 出来的 `Config.User`,空的。 现场是这样:Web、Admin、Open API 的请求先进 Nginx 和 Gateway,再分发给后面的 User Service、ASR、TTS、LLM Gateway。七八个服务,七八个镜像,之前各写各的 Dockerfile,能跑就行。现在不行了,构建机要统一起缓存策略,安全组要统一交 SBOM,K8s 要求容器默认非 root。 任务是:不改业务代码,把 Gateway 和 User Service 的 Dockerfile 与 .dockerignore 重写一遍,让构建可缓存、运行非 root、镜像里不留凭据,而且这套写法要能直接复用到后面的 ASR、TTS 服务。 我把两份 Dockerfile 并排打开,它们长得几乎一样: ```dockerfile FROM python:3.12-slim WORKDIR /app COPY . . RUN pip install --no-cache-dir -r requirements.txt EXPOSE 8000 CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"] ``` 看着挺完整:工作目录有了,依赖装了,端口声明了,启动命令也给了,本地跑当然没问题。 但放到构建机和扫描器面前,三件事同时出问题:构建机说这一层没命中缓存;扫描器说镜像里有个 .env;K8s 说容器以 root 启动。 写这份文件的人以为自己写的是“怎么把环境装好”,读这份文件的人——构建器、扫描器、运行时——读到的却是“这个镜像是什么、里面装了什么、以什么身份启动”。同一份文件,两套解读。 > 同一纸文件 > 两套解读法 > 写者讲安装 > 读者问身份 # 02、问题 旧方案就是“一份 Dockerfile 走天下”:不管什么服务,`FROM` 打底,`COPY . .` 全量搬进去,`RUN` 装依赖,`CMD` 起进程。 它在本地失效得并不明显,所以一路活到了多服务阶段。真正暴露的是四件事,每一件都能对应到具体指令的语义上。 缓存失效。改一行 README,`COPY . .` 这一层的输入就变了,它后面的 `RUN pip install` 全部重跑。服务越多,重复劳动的绝对值越大。 构建上下文失控。`.git`、`.env`、测试数据、本地虚拟环境目录,全被塞进上下文送给构建器。构建慢只是一半,另一半是这些文件可能出现在镜像里。 凭据进入镜像。为了从私有源装包,把 token 写进 `RUN` 的命令行,事后再 `rm`。看起来干净了,其实没有。 身份与探活缺失。没有 `USER`,容器默认以 root 启动;没有 `HEALTHCHECK`,编排层只能看进程在不在,看不出服务是不是真的能干活。 业务上的影响很直接:发布窗口被构建时间拖长,安全评审卡在镜像那一关,容器以 root 跑在生产机上意味着逃逸后的影响面更大。 那这一篇怎么算做完?我给自己定了五条能验证的标准: 1. 只改业务源码、不改依赖清单时,构建能命中依赖安装那一层; 2. `.dockerignore` 生效后,构建上下文里不再出现 `.git`、`.env`、测试产物; 3. 镜像里不存在任何以明文形式残留的凭据; 4. `docker inspect` 看到的 `Config.User` 非空且不是 root; 5. 镜像自带 `HEALTHCHECK`,`docker inspect` 能看到。 > 五条可验证 > 一条不能少 > 先写标准 > 再改文件 # 03、原理 这一篇只讲后面用得到的原理,其余的留给后面几记。先从最容易搞反的说起。 **反直觉判断:Dockerfile 不是安装脚本,是镜像的声明。** `RUN` 不是“执行一条命令”,而是“生成一个层”。一旦把它当安装脚本读,你就会自然地在里面做临时操作——下载、解压、删除、清理;一旦把它当镜像声明读,你就会问:这一层留在镜像里的是什么? **反直觉判断:构建器看到的不是你的项目目录,是构建上下文。** `docker build` 时,客户端会把上下文目录打包送给构建器。`COPY` 的源路径永远相对于上下文根,`COPY ../shared ./shared` 这种写法不成立,因为父目录根本不在上下文里。`.dockerignore` 改的不是镜像里的内容,而是送进构建器的输入——这是它最容易被误解的地方。 然后是层与缓存。BuildKit 用“指令 + 输入摘要”作为缓存键。对 `COPY` 来说,输入摘要来自被复制文件的内容。这意味着:只要 `COPY` 覆盖到的文件里有一个字节变了,这一层就失效,它之后的所有层跟着重算。所以缓存命中率不是由 `RUN` 决定的,是由 `COPY` 的位置决定的。 再区分两组经常被混用的东西。 `ARG` 和 `ENV`。`ARG` 是构建期变量,由 `--build-arg` 传入,默认不会留到运行时的镜像配置里;`ENV` 是运行期变量,会写进镜像配置,容器启动后进程能读到。但两者都不适合放密钥:构建参数会随构建命令进入构建历史与元数据,`ENV` 会直接写进镜像配置,任何能拉取镜像的人都能读到。 `COPY` 和 `ADD`。`ADD` 比 `COPY` 多两个能力:能从远程 URL 拉取,能自动解压本地 tar。能力多意味着语义多,评审时你得解释“这里为什么非 ADD 不可”。官方最佳实践的建议是优先 `COPY`,需要解压就显式解压。 最后是入口。`ENTRYPOINT` 定义“这个镜像是什么程序”,`CMD` 定义“默认参数”。单独写 `CMD` 时,`docker run` 后面的参数会整体替换它;写了 `ENTRYPOINT` 之后,`CMD` 就变成默认参数,运行时追加的参数会接在 ENTRYPOINT 后面。两者都推荐用 exec 形式(JSON 数组),因为 shell 形式会被包一层 `/bin/sh -c`,PID 1 是 shell 而不是你的进程,信号传递会出问题。 顺带一个容易踩的细节:exec 形式不做变量替换。写了 `ENV APP_PORT=8000`,`CMD ["--port", "$APP_PORT"]` 里的 `$APP_PORT` 不会被展开。想让环境变量生效,要么改用 shell 形式,要么在应用侧读取。 `USER` 指令改变的是它之后所有 `RUN`、`CMD`、`ENTRYPOINT` 的执行身份,它不是收尾动作,是入口的一部分。镜像默认是 root,K8s 的 `runAsNonRoot` 校验会在启动时直接拒绝 root 镜像。切非 root 要连带处理文件属主,`COPY --chown` 就是干这个的。 `HEALTHCHECK` 定义在镜像里,支持 `--interval`、`--timeout`、`--start-period`、`--retries`。它和编排系统的探针不是一回事:K8s 不读取镜像里的 HEALTHCHECK,它用自己的 liveness 与 readiness 探针。这一条决定了你写完 HEALTHCHECK 之后,还得在部署侧再配一遍。 > 层是历史账 > 删了也在账 > 缓存看输入 > 身份看入口 # 04、架构 ```text [输入] services/gateway 源码 + requirements.txt + 构建参数 | v [模块] .dockerignore 过滤 → BuildKit 构建器 → 多阶段构建 | v [数据/状态] 构建上下文快照 + 按层索引的构建缓存 + 只读 Secret 挂载 | v [处理] FROM 定基座 → COPY 依赖清单 → RUN 装依赖 → COPY 源码 → USER 切非 root → ENTRYPOINT/CMD 定入口 → HEALTHCHECK 定探活 | v [输出] 带 Tag 与 Digest 的镜像 → Registry → Compose / K8s 运行时 ``` 边界在哪:Dockerfile 管的是“镜像里有什么、以什么身份启动”。它管不了运行时给多少 CPU、内存和 GPU,管不了容器之间怎么组网,管不了 Secret 在运行时怎么注入到容器里。把 Dockerfile 当成“掌控一切”的文件来写,只会写出一堆构建期的无用逻辑。 收益是什么:镜像从“某台机器上构建出来的产物”变成“一份可评审、可复现的声明”。任何人在任何构建机上跑同样的命令,拿到的层结构一致、摘要一致。 代价是什么:为了缓存,`COPY` 的粒度要拆细,目录结构要为此调整;为了非 root,得在镜像里建用户、改属主;为了多阶段,得多维护一段构建阶段的定义。文件会变长,第一次读的人会觉得啰嗦。 适用条件:服务数量大于一个、或者镜像需要过安全扫描时,这套写法才开始回本。如果只是本地跑个一次性脚本,全套非 root 加多阶段就是过度设计。 > 输入先过滤 > 处理按层走 > 输出可复现 > 边界要划清 # 05、实战一次 先声明环境。下面的构建基于 Docker Desktop 或 Linux 上的 Docker Engine,构建器使用 BuildKit;BuildKit 是否为当前版本的默认构建器,以及 `# syntax=docker/dockerfile:1` 的具体标签版本,需按当前官方文档核验。 目录结构先定下来: ```bash services/gateway/Dockerfile services/gateway/.dockerignore services/gateway/requirements.txt services/gateway/app/main.py ``` 依赖清单: ```text fastapi==0.115.0 uvicorn[standard]==0.30.6 ``` 入口文件够用就行: ```python from fastapi import FastAPI app = FastAPI() @app.get("/healthz") def healthz(): return {"status": "ok"} @app.get("/v1/ping") def ping(): return {"service": "gateway", "version": "0.1.0"} ``` 依赖清单这里用了 text 代码块只是排版需要,它是纯文本内容,不构成字符图。 V1 的 Dockerfile,先求跑通: ```dockerfile FROM python:3.12-slim WORKDIR /app COPY . . RUN pip install --no-cache-dir -r requirements.txt EXPOSE 8000 CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"] ``` V1 的 .dockerignore 先只挡一个: ```text .git ``` 构建: ```bash docker build -t digital-human/gateway:0.1.0 services/gateway ``` 启动: ```bash docker run --rm -p 8000:8000 digital-human/gateway:0.1.0 ``` 请求: ```bash curl -s http://127.0.0.1:8000/v1/ping ``` 示例输出: ```json {"service":"gateway","version":"0.1.0"} ``` 到这里 V1 是通的,同时留下了三个问题:构建机的缓存、镜像里的 .env、空的 Config.User。下面逐条查。 未在当前环境实测,以上为按官方文档与指令语义推导的预期结果。 > 先跑通一遍 > 再回头挑刺 > 规范来自缺陷 > 不是来自想象 # 06、排查 第一条链:缓存次次全量。 现象:构建日志里,`COPY . .` 之后的所有步骤都没有命中缓存,构建机每次跑满。 怀疑:BuildKit 缓存没开?构建机没有挂缓存卷? 检查:用 `--progress=plain` 把每一步的摘要打出来看。 ```bash docker build --progress=plain -t digital-human/gateway:0.1.0 services/gateway ``` 证据:只改了 README.md 里的一行,`COPY . .` 这一步的摘要就变了,后面的 `RUN pip install` 跟着重跑。 根因:`COPY` 的缓存键取决于被复制内容的内容摘要。`COPY . .` 覆盖了源码目录里的所有文件,任何一个文件的任何变化都会让这层失效。依赖安装被排在它后面,于是每次都被源码变更牵连。 修复方向:把依赖清单和业务源码分开 COPY,让依赖安装这层只依赖 requirements.txt。 第二条链:镜像里的凭据。 现象:扫描报告指出镜像内某路径存在疑似凭据。 怀疑:源码里带了 .env 没被排除? 检查:先看构建历史,再把镜像导出成 tar 逐层查看。 ```bash docker history --no-trunc digital-human/gateway:0.1.0 docker save digital-human/gateway:0.1.0 -o gateway.tar ``` 证据:`docker history` 里能看到构建时执行过带凭据的 pip 命令;导出层里能定位到 .env 文件。 根因:`RUN` 里用到的凭据会留在这一层的记录里;.env 被 `COPY . .` 送进镜像之后,即使后面 rm 掉,前一层仍然完整保留着它。 **错误尝试:** 我一开始的修复方案,是在同一个 `RUN` 里收尾时 `rm -f .env`,并且在拉包命令后面追加 `&& unset TOKEN`,以为“同一条命令里删掉就等于没发生”。 为什么这个思路是错的:`RUN` 内做的删除,改变的是“最终文件系统的视图”,不是“层本身”。镜像由层叠加而成,包含 .env 的那一层依然存在于镜像中,任何能拿到镜像的人 `docker save` 出来就能解出原始内容。清理动作只是让最终视图看起来干净,历史层没有任何变化。同理,一行命令里的变量赋值也会留在构建历史里。 第三条链:root 启动。 现象:部署到 K8s 时被 `runAsNonRoot` 拒绝。 怀疑:USER 写在 ENTRYPOINT 后面所以没生效? 检查: ```bash docker inspect --format '{{.Config.User}}' digital-human/gateway:0.1.0 ``` 证据:输出为空,说明镜像没有指定用户,默认就是 root。 根因:V1 根本没有 `USER` 指令,容器以 root 身份启动。修复方向是在镜像里建一个系统用户,在启动阶段前切换,并把应用目录的属主一起处理掉。 > 现象引怀疑 > 证据定根因 > 错误也要留 > 后来少踩坑 # 07、优化 针对三条根因做 V2。 根因一:COPY 粒度太粗。改法:依赖清单单独 COPY,先装依赖,再 COPY 源码。 根因二:构建期凭据进入了层。改法:用 BuildKit 的 secret mount,把凭据挂成只读文件而不写进命令。 根因三:没有用户。改法:多阶段构建,运行阶段建系统用户,`COPY --chown` 指定属主,`USER` 切换。 V2 的 Dockerfile: ```dockerfile # syntax=docker/dockerfile:1 # ---------- 构建阶段 ---------- FROM python:3.12-slim AS builder WORKDIR /build COPY requirements.txt ./ RUN --mount=type=cache,target=/root/.cache/pip \ --mount=type=secret,id=pip_conf,target=/etc/pip.conf \ pip install --prefix=/install -r requirements.txt # ---------- 运行阶段 ---------- FROM python:3.12-slim AS runtime ENV PYTHONUNBUFFERED=1 \ PYTHONDONTWRITEBYTECODE=1 WORKDIR /app RUN groupadd --system --gid 10001 app \ && useradd --system --uid 10001 --gid app --home /app --shell /usr/sbin/nologin app COPY --from=builder /install /usr/local COPY --chown=10001:10001 app ./app USER 10001:10001 EXPOSE 8000 HEALTHCHECK --interval=15s --timeout=3s --start-period=10s --retries=3 \ CMD ["python", "-c", "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8000/healthz', timeout=2).status == 200 else 1)"] ENTRYPOINT ["uvicorn"] CMD ["app.main:app", "--host", "0.0.0.0", "--port", "8000"] ``` 改完之后的新行为: `COPY requirements.txt ./` 和 `COPY --chown=... app ./app` 分开之后,只有 requirements.txt 变了才会触发重新装包,改业务代码只影响最后那层 COPY。 `--mount=type=secret` 让凭据以文件形式在构建时短暂可读,不进镜像层,也不出现在构建历史里。 `USER 10001:10001` 之后,CMD 和 ENTRYPOINT 都以这个用户执行;`COPY --chown` 保证了应用目录归属正确。 `ENTRYPOINT` 与 `CMD` 拆开之后,Gateway 的默认启动命令不变,但运维可以在 `docker run` 时追加参数覆盖端口,而不用重打镜像。代价是入口程序的参数顺序变成了契约,改动要同步通知使用方。 构建命令也变了: ```bash docker build \ --secret id=pip_conf,src=./ci/pip.conf \ -t registry.example.com/digital-human/gateway:0.1.0 \ services/gateway ``` 配套的 .dockerignore: ```text .git .gitignore .env .env.* __pycache__/ *.py[cod] .pytest_cache/ .mypy_cache/ .venv/ venv/ *.log tests/ docs/ README.md docker-compose*.yml ``` 验证,三条都检查一遍: ```bash docker inspect --format '{{.Config.User}}' registry.example.com/digital-human/gateway:0.1.0 docker history --no-trunc registry.example.com/digital-human/gateway:0.1.0 docker inspect --format '{{json .Config.Healthcheck}}' registry.example.com/digital-human/gateway:0.1.0 ``` 示例输出: ```console 10001:10001 ``` 镜像体积的变化没有在当前环境实测,需要的话用 `docker image ls` 自己对比。 再补一个改源码、观察缓存的检查: ```bash docker build --progress=plain -t digital-human/gateway:0.1.1 services/gateway ``` 在构建日志里应该能看到依赖安装那一步保持 CACHED,只有最后的 COPY 和镜像导出重新执行。 > 分层定缓存 > 挂载藏凭据 > 换身份启动 > 探活写进镜像 # 08、演进 ```text [同一份 services/gateway 源码] | +--[V1] COPY . . 全量进入;root 启动;依赖与源码同层 | 代价:缓存次次失效;凭据可能留在历史层;K8s 拒绝启动 | +--[V2] 依赖与源码分层 COPY;多阶段构建;非 root USER; | secret mount 代替明文凭据;镜像内自带 HEALTHCHECK | 代价:Dockerfile 变长;需要配套 ci/pip.conf;入口参数顺序成为契约 | [Trade-off] 得到:可复现的层结构、可跳过的依赖重装、可用于扫描与审计的干净镜像 失去:文件更啰嗦、目录结构被构建顺序约束、多了一份 secret 源文件的管理成本 边界:服务数量少、镜像不需要扫描时,V1 反而更省事 ``` 正确性方面:V1 和 V2 都能把服务跑起来,区别在 V2 多了几条能被自动检查的约束——非 root、无明文凭据、自带探活。这些是能进 CI 做门槛的。 稳定性方面:V1 的构建时间随源码规模线性增长;V2 把构建时间从“改一次代码重装一次依赖”变成了“只有依赖清单变化时才重装”。 复杂度方面:V2 的 Dockerfile 多了构建阶段、用户创建和 secret 挂载三处,新人第一次读要花点时间。这部分复杂度换来的是可审计性,它是有价值的复杂度。 成本方面:多阶段构建会让构建阶段产生临时层,但这些层最终不会随运行镜像发布。secret 源文件需要在构建机上管理,这本身就是需要治理的东西。 适用范围:这套写法适合所有需要进入 Registry 并被运行时拉起的服务。对一次性的本地脚本镜像,直接 V1 就行。 遗留问题:运行时的资源限制、容器之间的网络通信、运行时的 Secret 注入方式,V2 都没有处理。 > 两版同一题 > 取舍各不同 > 得到即失去 > 边界最诚实 # 09、洞见 ## 9.1 缓存不是优化,是接口设计 依赖安装和业务源码本来就是两件变化频率差一个数量级的事情,而 `COPY . .` 把它们压成了一层。缓存失效只是表象,真正的错误是没有把“变化频率”当作分层依据。 推论:写 Dockerfile 的时候,先给文件按变化频率排序,再决定 COPY 的次序。依赖清单和基础配置放前面,业务代码放后面,文档和测试排除出去。 ## 9.2 层是历史,不是状态 反直觉判断:镜像不是“最终文件系统的快照”,而是一串不可变的层。你在 `RUN` 里删除一个文件,只是在后面加了一层“白障”,包含该文件的那一层依然完整存在。 推论:任何“先写进去再删掉”的做法,在镜像里都不成立。凭据、证书、临时下载的包,都不能靠事后删除来处理。要么不让它进去(`.dockerignore`),要么不落盘(secret mount)。 ## 9.3 Dockerfile 是契约,不是脚本 反直觉判断:一份 Dockerfile 里最贵的往往不是 RUN 写了多少行,而是 COPY 出现在了什么地方。 RUN 影响的是构建时间,COPY 影响的是缓存命中率、上下文体积,以及有多少不该进镜像的东西混了进来。评审 Dockerfile 时先看 COPY 的位置和 .dockerignore,再看 RUN。 ## 9.4 非 root 是入口设计,不是收尾动作 补一个 USER 就以为解决了 root 问题,常常会在下一步撞到权限墙:目录不可写、日志写不出去、临时文件建不了。真正需要处理的是:哪些目录在构建期就要 `--chown` 给运行用户,哪些目录在运行时才需要写权限。 推论:非 root 的改造要放在镜像定义里做,而不是交给编排层用 securityContext 去补救。K8s 的 `runAsNonRoot` 只是最后一道守门人,它会在启动前校验。 > 变化定分层 > 历史不可删 > 契约看拷贝 > 身份在入口 # 10、系统落地 原来有什么:第 6 记之后,我们知道镜像是层加摘要;第 5 记之后,我们知道容器怎么起来。但镜像本身怎么定义,仓库里还只是几份“能跑就行”的 Dockerfile。 本篇新增了什么:一套能复用到后续服务的 Dockerfile 写法,以及配套的 .dockerignore。具体包括按变化频率分层的 COPY 顺序、多阶段构建、镜像内建非 root 用户、以 secret mount 替代明文凭据、ENTRYPOINT 与 CMD 的职责分离、镜像内自带 HEALTHCHECK。 现在能做什么:Gateway 和 User Service 可以在任意构建机上得到层结构一致、可扫描、默认非 root 的镜像,并且可以随源码变化单独触发对应层的重建。 还缺什么:镜像里跑起来之后,容器之间怎么互相找到,属于 Docker 网络;配置和 Secret 在运行时怎么注入,属于配置管理;日志怎么收集、SIGTERM 怎么优雅处理,属于进程信号。这些在这一篇里都只点到为止。 下一步怎么演进:等 ASR、TTS、LLM Gateway 这些服务也陆续容器化之后,同一个仓库里会出现七八份结构相似的 Dockerfile。到那时候,重复的部分该怎么收敛,就是下一步要解决的问题。 > 原来只知道 > 本篇能定义 > 现在可复现 > 下一步收敛 # 11、小结 ```text Q1 → 开发机秒过、构建机全量重建,根因是 COPY 粒度过粗, 依赖安装和业务源码被压在同一层里,缓存键被源码变更带走了 Q2 → 密码写进 RUN 又删掉仍能被找到,因为删除只改变最终视图, 包含凭据的那一层始终留在镜像中 Q3 → 镜像上生产被要求补 USER 和 HEALTHCHECK,是因为镜像定义 默认以 root 运行,也没有把探活方式声明出来 状态 → Gateway 与 User Service 具备了一套可复现、可扫描、 默认非 root 的镜像定义,且能直接复用到后续服务 ``` > 一图定分层 > 一查见残层 > 一改切身份 > 一镜可上生产 # 12、作业 ## 12.1 理解题:ARG 与 ENV 都能在构建时被读取,为什么密钥不能放在其中任何一个里? 参考答案:ARG 是构建期变量,ENV 是运行期变量,两者的生命周期不同——ARG 默认不会写进运行时的镜像配置,ENV 会。但它们都出现在构建的上下文里:构建参数会随构建命令进入构建历史与元数据,ENV 会直接写进镜像配置,任何能拉取镜像的人都能读到。密钥应该走 BuildKit 的 secret mount,只在需要它的那一步、以文件形式短暂可读,不进入层,也不进入历史。 ## 12.2 实战题:把 V2 的 Dockerfile 套用到 services/user-service 上,改完之后检查三件事:Config.User 是否非 root、依赖安装那层在只改业务代码时是否命中缓存、镜像里能不能找到 .env。 参考答案:三步。第一,`docker inspect --format '{{.Config.User}}' ` 应该输出 10001:10001 这样的值。第二,构建时加 `--progress=plain`,改一行业务代码后重新构建,pip install 那一步应显示 CACHED。第三,用 `docker save` 导出镜像并逐层检查,或者直接跑一次 `docker history --no-trunc`,应该看不到明文凭据或 .env 路径;同时确认 .dockerignore 里确实排除了 .env 和 .env.*。 ## 12.3 排障题:服务在本地 docker run 能起来,部署到 K8s 后 Pod 一直 CrashLoopBackOff,日志里报 permission denied,应该从哪个方向排查? 参考答案:先确认镜像的 Config.User,再确认应用运行时需要写的目录。最常见的原因是非 root 用户对工作目录、日志目录或临时目录没有写权限——构建期的 `COPY --chown` 只覆盖了被 COPY 进来的文件,`RUN` 阶段创建的目录还是归 root。排查顺序是:先看 USER 是什么,再看报错路径属于哪个用户和哪个组,然后在构建阶段用 chown 或 chmod 把权限补上,而不是用“改成 root”来解决。 ## 12.4 架构判断题:团队里有人提出,把 HEALTHCHECK 写进 Dockerfile 之后,K8s 那边就不需要再配探针了。这个判断对不对? 参考答案:不对。HEALTHCHECK 是镜像层面的声明,Docker 引擎和 Compose 会用它;K8s 有自己的 liveness、readiness 和 startup 探针机制,不读取镜像里的 HEALTHCHECK。两者要分别维护,语义也不同——readiness 控制的是要不要接流量,liveness 控制的是要不要重启。在镜像里写 HEALTHCHECK 的价值在于:docker run 和 Compose 场景下有一个统一的探活定义,并且这个定义随镜像走。 > 一问辨语义 > 二做验结果 > 三查定身份 > 四判划边界 # 13、思考 这一篇的冲突其实只有一句话:写 Dockerfile 的人以为自己在描述“怎么把环境装好”,而读 Dockerfile 的人读的是“这个镜像是什么”。 只要这个认知差还在,`COPY . .` 就会一直被写下去,rm 就会被当成清理手段,USER 就会被留到最后补。把指令当成声明读,问题会自己浮出来——COPY 的位置暴露的是分层依据,RUN 的历史暴露的是残留风险,USER 的位置暴露的是身份设计。 镜像不是构建的副产品,镜像是交付物本身。 > 指令即声明 > 层里留历史 > 入口定身份 > 镜像即交付

资源下载

更多资源
Mario

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长,特征是大鼻子、头戴帽子、身穿背带裤,还留着胡子。与他的双胞胎兄弟路易基一起,长年担任任天堂的招牌角色。

Nacos

Nacos

Nacos /nɑ:kəʊs/ 是 Dynamic Naming and Configuration Service 的首字母简称,一个易于构建 AI Agent 应用的动态服务发现、配置管理和AI智能体管理平台。Nacos 致力于帮助您发现、配置和管理微服务及AI智能体应用。Nacos 提供了一组简单易用的特性集,帮助您快速实现动态服务发现、服务配置、服务元数据、流量管理。Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。

Spring

Spring

Spring框架(Spring Framework)是由Rod Johnson于2002年提出的开源Java企业级应用框架,旨在通过使用JavaBean替代传统EJB实现方式降低企业级编程开发的复杂性。该框架基于简单性、可测试性和松耦合性设计理念,提供核心容器、应用上下文、数据访问集成等模块,支持整合Hibernate、Struts等第三方框架,其适用范围不仅限于服务器端开发,绝大多数Java应用均可从中受益。

Sublime Text

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能,例如代码缩略图,Python的插件,代码段等。还可自定义键绑定,菜单和工具栏。Sublime Text 的主要功能包括:拼写检查,书签,完整的 Python API , Goto 功能,即时项目切换,多选择,多窗口等等。Sublime Text 是一个跨平台的编辑器,同时支持Windows、Linux、Mac OS X等操作系统。

用户登录
用户注册
修改密码
忘记密码