docker compose build

描述

• 构建 (或重新构建) Compose 项目中定义的服务对应的镜像。

• 服务构建完成后，会为镜像打标签 (tag)。默认标签是 项目名_服务名 (例如 myproject_web)。

• 如果 Compose 文件里对服务定义了 image: 名称，那么构建出来的镜像会使用该名称进行标记，并替换其中任何变量 (如环境变量插值)。

• 当服务对应的 Dockerfile 或其构建上下文 (build context) 的内容有改动时，执行 docker compose build 可以重新构建新的镜像。

选项

选项	描述
--build-arg key=val	为构建过程传递构建参数 (build-arg)，这些参数会传到 Dockerfile 的 ARG。
--builder	指定要使用的构建器 (builder)。
-m, --memory MEM	为构建容器设置内存限制 (Memory 限额)。注意：某些构建器（如 BuildKit）可能不支持这个限制。
--no-cache	构建时不使用缓存 (cache)，强制每层都重新构建。
--pull	总是尝试拉取 (pull) 对应基础镜像的最新版本，然后再构建。
--push	构建完成后将镜像推送 (push) 到镜像仓库。
--ssh	在构建过程中使用 SSH 身份 (例如当 Dockerfile 里有 RUN --mount=type=ssh 需要访问私有 Git 仓库时)。
--with-dependencies	同时构建当前服务以及其所有依赖服务。
-q, --quiet	静默模式：构建时不输出详细日志 (标准输出不显示太多内容)。