Docker Build语法用法示例详解

1. 由来

Docker Build是Docker提供的一个命令，用于根据Dockerfile构建自定义的镜像。通过Docker Build，可以将应用程序、环境和依赖项打包到一个可移植的容器中，使得应用在不同环境下都能以相同的方式运行。

2. 语法

docker build [OPTIONS] PATH | URL | -

docker build [OPTIONS] PATH | URL | - 是 docker build 命令的语法说明。下面解释每个部分的含义：

• docker build 是 Docker 命令，用于构建镜像。
• [OPTIONS] 是可选的命令参数，可以用来自定义构建过程的行为。
• PATH 表示要构建镜像的上下文路径，通常是包含 Dockerfile 的目录。
• URL 是一个远程 Git 仓库的 URL，可以直接从远程仓库构建镜像。
• - 表示从标准输入流中读取 Dockerfile 的内容进行构建。

在使用这个命令时，您需要选择其中一种方式来指定要构建的镜像：通过本地的路径、远程的 URL 或者从标准输入流中读取 Dockerfile 的内容。

同时，您可以使用不同的选项来自定义构建过程的行为，例如设置 Dockerfile 的名称、传递构建参数、设定网络模式、控制缓存策略等。

请根据实际需求和情况，在命令中选择合适的方式和选项来构建所需的镜像。

3. 选项

选项	描述
-f, --file string	Dockerfile的名称（默认为’路径/Dockerfile’）
–build-arg list	设置构建时的变量
–cache-from strings	将镜像视为缓存源
–disable-content-trust	跳过镜像验证（默认为true）
-t, --tag list	镜像的名称和标签，格式为’name:tag’（默认为[]）
–target string	设置目标构建阶段
-m, --memory string	内存限制
–network string	设置构建过程中的网络模式（默认为"default"）
–no-cache	在构建过程中不使用缓存
–pull	总是尝试拉取基础镜像的新版本
–quiet	隐藏构建输出，在成功后只打印镜像ID
–rm	在成功构建后删除中间容器（默认为true）
–shm-size string	/dev/shm 的大小，默认值为64MB
–squash	将新构建的层压缩成单个新层
–ulimit ulimit	Ulimit选项（默认为[]）
–compress	使用gzip压缩构建上下文

4. 十种主要用法及其示例

以下是Docker Build的十种主要用法及其示例：

a. 构建镜像并指定标签

docker build -t my-image:tag .

该命令会使用当前目录下的Dockerfile构建一个名为my-image的镜像，并指定tag为tag。

b. 在构建过程中传递构建参数

docker build --build-arg ARG_NAME=value -t my-image:tag .

这个命令允许您在构建过程中传递构建参数，ARG_NAME为参数名称，value为参数值。

c. 从远程Git仓库构建镜像

docker build -t my-image:tag https://github.com/username/repo.git

该命令允许您从远程的Git仓库中直接构建镜像。

d. 多阶段构建

# 第一阶段：构建应用
FROM maven:3.8.1-openjdk-11-slim AS builder
WORKDIR /app
COPY . .
RUN mvn clean install

# 第二阶段：运行应用
FROM openjdk:11-jre-slim
WORKDIR /app
COPY --from=builder /app/target/my-app.jar .
CMD ["java", "-jar", "my-app.jar"]

这个例子展示了多阶段构建，首先在一个镜像中构建应用程序，然后将构建好的结果复制到另一个镜像中并运行应用程序。

e. 使用Docker Compose构建

version: '3'
services:
  my-service:
    build:
      context: .
      dockerfile: Dockerfile
      args:
        ARG_NAME: value
    image: my-image:tag

通过Docker Compose文件进行构建，可以指定构建上下文、Dockerfile路径以及传递构建参数。

f. 使用缓存策略

# 使用缓存
RUN apt-get update && apt-get install -y \
    package1 \
    package2

# 不使用缓存
RUN apt-get update && apt-get install -y --no-cache \
    package3 \
    package4

这个示例展示了如何使用或不使用缓存来安装软件包。

g. 构建并推送镜像到Docker仓库

docker build -t my-image:tag .
docker push my-image:tag

这个命令会构建一个名为my-image的镜像，并将其推送到Docker仓库中。

h. 通过Dockerfile目录构建镜像

docker build -t my-image:tag /path/to/dockerfile/dir

该命令允许您指定Dockerfile所在的目录路径进行构建。

i. 设置构建进度输出模式

docker build --progress=plain -t my-image:tag .

通过设置构建进度输出模式，可以选择以不同的方式显示构建过程的输出。

j. 构建无需Dockerfile的上下文镜像

docker build -t my-image:tag -

这个命令允许您从标准输入流中读取Dockerfile内容，并构建镜像。

5.其他常用命令

除了上述示例之外，还有一些其他常用的Docker Build命令，包括：

• --no-cache：构建过程中不使用缓存。
• -f, --file：指定使用的Dockerfile路径。
• --target：指定多阶段构建中的目标构建阶段。
• --progress：设置构建进度输出模式（auto, plain, tty）。

6. 详细区别

Docker Build是用于根据Dockerfile构建镜像的命令，它根据Dockerfile中的指令和构建上下文来生成镜像。与Docker Run命令不同，Docker Build只是构建镜像而不运行容器。它可以根据Dockerfile的定义自动化地执行一系列步骤，例如安装软件、配置环境等。

7. 官方链接

了解更多关于Docker Build的信息，请参考官方文档：

e中的指令和构建上下文来生成镜像。与Docker Run命令不同，Docker Build只是构建镜像而不运行容器。它可以根据Dockerfile的定义自动化地执行一系列步骤，例如安装软件、配置环境等。

7. 官方链接

了解更多关于Docker Build的信息，请参考官方文档：

• Docker Build官方文档