docker命令 - 技术栈

docker build 是用于从 Dockerfile 构建 Docker 镜像的核心命令，通过读取 Dockerfile 中的指令，逐步构建出可运行的镜像。以下是其详细用法、参数说明及示例：

bash 复制代码

docker build [OPTIONS] PATH | URL | -

参数	作用说明
`-t, --tag`	为镜像指定名称和标签（格式：`名称:标签`，标签默认 `latest`）
`-f, --file`	指定非默认名称的 Dockerfile（默认找当前目录的 `Dockerfile` 文件）
`--build-arg`	传递构建时变量（配合 Dockerfile 中的 `ARG` 指令使用）
`--no-cache`	构建时不使用缓存（强制重新执行所有步骤，解决缓存导致的依赖更新问题）
`--pull`	总是尝试拉取基础镜像的最新版本（避免使用本地旧版本基础镜像）
`-q, --quiet`	静默模式，只输出最终的镜像 ID，不显示构建过程

假设当前目录有 Dockerfile，构建并命名为 myapp:v1：

bash 复制代码

# 格式：docker build -t 镜像名:标签 目录路径（. 表示当前目录）
docker build -t myapp:v1 .

若 Dockerfile 名为 Dockerfile.prod（非默认 Dockerfile）：

bash 复制代码

# -f 指定 Dockerfile 路径
docker build -t myapp:prod -f Dockerfile.prod .

配合 Dockerfile 中的 ARG 指令使用，动态传入参数（如版本号）：

Dockerfile 中定义 ARG：

dockerfile 复制代码

ARG APP_VERSION=1.0  # 定义变量，默认值 1.0
FROM openjdk:8-jdk-alpine
COPY app-${APP_VERSION}.jar app.jar  # 使用变量

构建时传递变量：

bash 复制代码

# --build-arg 覆盖默认的 APP_VERSION
docker build -t myapp:v2 --build-arg APP_VERSION=2.0 .

当 Dockerfile 或依赖文件更新后，缓存可能导致构建结果不符合预期，需强制重新构建：

bash 复制代码

docker build -t myapp:v3 --no-cache .

直接从 GitHub/GitLab 仓库构建（Docker 会自动克隆仓库并找根目录的 Dockerfile）：

bash 复制代码

# 从 GitHub 仓库构建
docker build -t github-app:latest https://github.com/example/springboot-demo.git

只输出最终的镜像 ID，适合脚本中获取镜像标识：

bash 复制代码

# 构建并获取镜像 ID
IMAGE_ID=$(docker build -q -t myapp:v4 .)
echo "构建完成，镜像 ID：$IMAGE_ID"

docker build 后面的 PATH（如 .）称为构建上下文，表示 Docker 引擎可访问的文件范围：

unauthorized: authentication required

需登录 Docker 仓库（如 Docker Hub）：docker login
no such file or directory

检查 Dockerfile 中的 COPY/ADD 路径是否正确，确保文件在构建上下文内。
缓存导致依赖未更新

使用 --no-cache 强制重新构建，或修改 Dockerfile 中对应步骤的指令（如添加注释）使缓存失效。

docker build 是构建镜像的核心命令，常用场景：