首页/云/Docker 容器速查/image 与 build 字段的配合
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

image 与 build 字段的配合

image 指定镜像名(拉取或命名构建产物),build 指定构建上下文;两者共存时构建出的镜像以 image 命名,方便直接 push。

Docker 容器速查云更新于 2026-10-12
image镜像名与标签
buildcontext / dockerfile / args / target
共存构建结果按 image 命名

示例

示例
services:
  api:
    build:
      context: ./api
      dockerfile: Dockerfile
      args:
        VERSION: "1.4.2"
    image: registry.example.com/team/app/api:1.4.2
多阶段构建可用 target 指定构建阶段;args 里的值不要放密钥,构建参数会进镜像元数据。

易错点

  • 只写 image 时 compose 直接拉取,想让本地改动生效必须 rebuild 或加 build
  • build.context 写错目录会构建出与预期不符的镜像,构建日志里核对上下文文件列表

数据来源与参考

  • Docker 官方文档:Compose build 参考(docs.docker.com/reference/compose-file/build)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌