容器与云原生 / 系统课时
image 和 build 应该怎么选
image 和 build 应该怎么选
同一个 Compose 服务既可以直接引用现成镜像,也可以从项目源码构建镜像。选择的关键不是“哪种写法更高级”,而是镜像由谁生产:已有可复用制品用 image,需要根据当前源码生成制品用 build。
学习目标
- 能根据镜像来源在
image与build之间做选择 - 能写出可验证的远程镜像与本地构建配置
- 能理解同时出现
image和build时需要额外关注的行为
先判断镜像由谁生产
image 指向一个已经存在或可以从镜像仓库获取的镜像,例如 Nginx、Redis,或者团队 CI 已经发布的业务镜像。Compose 负责使用这个镜像创建容器,而不是根据当前源码重新制作它。
build 则告诉 Compose:先把某个目录作为构建上下文,按照 Dockerfile 生成镜像,再基于构建结果创建容器。它适合本地开发、需要把当前源码打进镜像,或者还没有预先发布镜像的服务。
| 场景 | 更合适的配置 | 原因 |
|---|---|---|
| 使用 Nginx、Redis 等现成镜像 | image |
不需要维护本地 Dockerfile |
| 使用 CI 已发布的业务镜像 | image |
部署直接消费已构建制品 |
| 根据当前仓库源码制作镜像 | build |
需要执行 Dockerfile 构建步骤 |
| 本地频繁修改 Dockerfile | build |
可以直接验证构建结果 |
直接使用 image
下面的 compose.yaml 让 Compose 使用现成的 Nginx 镜像。镜像本地不存在时,后续启动或拉取流程可以从镜像仓库获取它。
services:
web:
image: nginx:alpine先只验证 Compose 配置是否能被解析,不启动容器:
docker compose config -q && printf 'compose config ok\n'预期输出
compose config okconfig -q 成功时不输出配置内容并返回成功状态;这里额外用 printf 给出可观察的验证结果。生产环境通常还会把镜像标签固定到明确版本,甚至使用 digest,避免可变标签在不同时间解析到不同镜像。
使用 build
假设当前目录有一个 Dockerfile,需要把自定义首页写入 Nginx 镜像:
FROM nginx:alpine
RUN printf 'built by compose\n' > /usr/share/nginx/html/index.html对应的 compose.yaml 指定当前目录为构建上下文:
services:
web:
build:
context: .
dockerfile: Dockerfile执行构建并在成功后打印确认信息:
docker compose build --quiet web >/dev/null && printf 'build ok\n'预期输出
build okcontext 决定 Docker 构建时能看到哪些文件,也是缓存计算和发送构建上下文的边界。不要为了“省事”把上下文扩大到无关目录;应配合 .dockerignore 排除依赖缓存、构建产物和敏感文件。
同时写 image 和 build 时
两者可以同时出现,例如需要从源码构建,同时给结果一个可推送的镜像名。下面是片段示例,依赖当前目录存在可用的 Dockerfile:
services:
web:
image: registry.example.com/team/web:dev
build:
context: .此时不要把它理解成“永远只构建、不拉取”。Compose 会结合 pull_policy 决定拉取与构建策略;如果没有配置 pull_policy,Compose 会先尝试拉取 image,镜像不可获取时再根据 build 从源码构建。需要稳定发布流程时,应显式设计构建、打标签、推送和部署各自发生在哪个阶段。
用部署边界做最终选择
本地开发中,业务服务常用 build 直接消费当前源码,而数据库、缓存等基础服务直接写 image。进入测试或生产环境后,更常见的做法是由 CI 统一构建并发布业务镜像,Compose 只通过 image 使用确定的版本。
因此,build 解决的是“怎样从源码得到镜像”,image 解决的是“要运行哪个镜像”。先确定镜像生产责任,再写 Compose,配置会比单纯记语法更稳定。