现在位置: 首页 > Docker 教程 > 正文

Docker build 命令

 Docker 命令大全Docker 命令大全


docker build 命令用于从 Dockerfile 构建 Docker 镜像。

docker build 命令通过读取 Dockerfile 中定义的指令,逐步构建镜像,并将最终结果保存到本地镜像库中。

语法

docker build [OPTIONS] PATH | URL | -
  • PATH: 包含 Dockerfile 的目录路径或 .(当前目录)。
  • URL: 指向包含 Dockerfile 的远程存储库地址(如 Git 仓库)。
  • -: 从标准输入读取 Dockerfile。

常用选项:

  • -t, --tag: 为构建的镜像指定名称和标签。
  • -f, --file: 指定 Dockerfile 的路径(默认是 PATH 下的 Dockerfile)。
  • --build-arg: 设置构建参数。
  • --no-cache: 不使用缓存层构建镜像。
  • --rm: 构建成功后删除中间容器(默认开启)。
  • --force-rm: 无论构建成功与否,一律删除中间容器。
  • --pull: 始终尝试从注册表拉取最新的基础镜像。

更多选项说明:

  • --build-arg=[]: 设置构建镜像时的变量。
  • --cpu-shares: 设置 CPU 使用权重。
  • --cpu-period: 限制 CPU CFS 周期。
  • --cpu-quota: 限制 CPU CFS 配额。
  • --cpuset-cpus: 指定可使用的 CPU ID。
  • --cpuset-mems: 指定可使用的内存节点 ID。
  • --disable-content-trust: 忽略内容信任验证(默认启用)。
  • -f: 指定 Dockerfile 的路径。
  • --force-rm: 强制在构建过程中删除中间容器。
  • --isolation: 使用指定的容器隔离技术。
  • --label=[]: 设置镜像的元数据。
  • -m: 设置内存的最大值。
  • --memory-swap: 设置交换空间的最大值(内存 + 交换空间),-1 表示不限制交换空间。
  • --no-cache: 构建镜像时不使用缓存。
  • --pull: 尝试拉取基础镜像的最新版本。
  • --quiet, -q: 安静模式,构建成功后只输出镜像 ID。
  • --rm: 构建成功后删除中间容器(默认启用)。
  • --shm-size: 设置 /dev/shm 的大小,默认值为 64M。
  • --ulimit: 设置 Ulimit 配置。
  • --squash: 将 Dockerfile 中所有步骤压缩为一层。
  • --tag, -t: 为镜像指定名称和标签,格式为 name:tagname;可以在一次构建中为一个镜像设置多个标签。
  • --network: 在构建期间设置 RUN 指令的网络模式,默认值为 default

1、构建镜像

docker build -t myimage:latest .

这会从当前目录读取 Dockerfile 并构建一个名为 myimage:latest 的镜像。

2、指定 Dockerfile 路径

docker build -f /path/to/Dockerfile -t myimage:latest .

这会从 /path/to/ 目录读取 Dockerfile 并构建一个名为 myimage:latest 的镜像。

3、设置构建参数

docker build --build-arg HTTP_PROXY=http://proxy.example.com -t myimage:latest .

这会在构建过程中使用 HTTP_PROXY 环境变量。

4、不使用缓存层构建镜像

docker build --no-cache -t myimage:latest .

这会在构建镜像时忽略所有缓存层,确保每一步都重新执行。

实例 - 使用 Dockerfile 构建镜像

1、创建 Dockerfile,内容如下:

# Dockerfile 示例
FROM ubuntu:20.04
LABEL maintainer="yourname@example.com"
RUN apt-get update && apt-get install -y nginx
COPY index.html /var/www/html/index.html
CMD ["nginx", "-g", "daemon off;"]

2、构建镜像

docker build -t mynginx:latest .

输出示例:

Sending build context to Docker daemon  3.072kB
Step 1/5 : FROM ubuntu:20.04
20.04: Pulling from library/ubuntu
...
Step 2/5 : LABEL maintainer="yourname@example.com"
...
Step 3/5 : RUN apt-get update && apt-get install -y nginx
...
Step 4/5 : COPY index.html /var/www/html/index.html
...
Step 5/5 : CMD ["nginx", "-g", "daemon off;"]
...
Successfully built 123456789abc
Successfully tagged mynginx:latest

3、验证镜像

docker images

输出示例:

注意事项

REPOSITORY   TAG       IMAGE ID       CREATED          SIZE
mynginx      latest    123456789abc   10 minutes ago   200MB
  • 确保 Dockerfile 语法正确,并按照顺序执行每一步。
  • 使用 .dockerignore 文件排除不需要的文件和目录,以减少构建上下文的大小。
  • 在生产环境中,尽量使用精简的基础镜像以减小镜像体积和提高安全性。
  • 避免在 Dockerfile 中暴露敏感信息(如密码、密钥)。

docker build 命令是构建 Docker 镜像的核心工具,通过定义清晰的 Dockerfile,可以自动化地构建应用程序的运行环境和依赖。在使用时,确保合理设置选项和优化 Dockerfile,以提高构建效率和镜像质量。


 Docker 命令大全Docker 命令大全