容器与云原生 / 系统课时

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 镜像。镜像本地不存在时,后续启动或拉取流程可以从镜像仓库获取它。

yaml
services:
  web:
    image: nginx:alpine

先只验证 Compose 配置是否能被解析,不启动容器:

bash
docker compose config -q && printf 'compose config ok\n'

预期输出

text
compose config ok

config -q 成功时不输出配置内容并返回成功状态;这里额外用 printf 给出可观察的验证结果。生产环境通常还会把镜像标签固定到明确版本,甚至使用 digest,避免可变标签在不同时间解析到不同镜像。

使用 build

假设当前目录有一个 Dockerfile,需要把自定义首页写入 Nginx 镜像:

dockerfile
FROM nginx:alpine

RUN printf 'built by compose\n' > /usr/share/nginx/html/index.html

对应的 compose.yaml 指定当前目录为构建上下文:

yaml
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile

执行构建并在成功后打印确认信息:

bash
docker compose build --quiet web >/dev/null && printf 'build ok\n'

预期输出

text
build ok

context 决定 Docker 构建时能看到哪些文件,也是缓存计算和发送构建上下文的边界。不要为了“省事”把上下文扩大到无关目录;应配合 .dockerignore 排除依赖缓存、构建产物和敏感文件。

同时写 image 和 build 时

两者可以同时出现,例如需要从源码构建,同时给结果一个可推送的镜像名。下面是片段示例,依赖当前目录存在可用的 Dockerfile:

yaml
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,配置会比单纯记语法更稳定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

image 和 build 应该怎么选

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通