问题：`docker build --progress=plain` 的作用是什么？

Question

**问题：** 在使用 `docker build` 命令构建镜像时，添加 `--progress=plain` 参数的作用是什么？它与默认的进度输出方式有何不同？为什么在某些 CI/CD 环境中推荐使用该选项？

Answer 1

一、`docker build --progress=plain` 的基本作用

在使用 docker build 构建镜像时，默认情况下，Docker 会以一种“交互式”的方式显示构建进度。这种进度信息通常包括当前步骤、当前状态、下载或构建进度条等，适用于终端用户在本地查看。

而添加 --progress=plain 参数后，Docker 将以“纯文本”形式输出构建日志，不再显示进度条和动画效果。这种输出方式更适合自动化脚本、CI/CD 环境中日志记录与分析。

• --progress=plain：输出简洁的文本信息，适合日志记录
• --progress=auto（默认）：自动选择输出方式，通常是终端友好的进度条
• --progress=quiet：仅输出最终结果，不显示中间日志

二、`--progress=plain` 与默认输出方式的对比

输出模式	显示方式	适用场景
--progress=auto	带进度条、动画、实时更新的终端输出	本地开发调试、人工查看构建过程
--progress=plain	纯文本输出，无动画，每行显示构建步骤	CI/CD 环境、日志分析、自动化监控
--progress=quiet	仅输出最终构建结果	仅需确认构建是否成功

例如，默认输出可能会显示如下内容：

[+] Building 5.0s (9/9) FINISHED
 => [internal] load build definition from Dockerfile
 => [internal] load .dockerignore
 => [internal] load metadata for docker.io/library/ubuntu:20.04
 => [1/5] FROM docker.io/library/ubuntu:20.04
 => [2/5] RUN apt-get update
 => [3/5] RUN apt-get install -y nginx
 => [4/5] COPY index.html /usr/share/nginx/html/
 => [5/5] CMD ["nginx", "-g", "daemon off;"]
 => exporting to image
 => writing image sha256:1234567890abcdef

而使用 --progress=plain 后，输出将变成类似如下：

STEP 1/5: FROM ubuntu:20.04
STEP 2/5: RUN apt-get update
STEP 3/5: RUN apt-get install -y nginx
STEP 4/5: COPY index.html /usr/share/nginx/html/
STEP 5/5: CMD ["nginx", "-g", "daemon off;"]

三、为何在 CI/CD 中推荐使用 `--progress=plain`？

CI/CD 环境（如 Jenkins、GitLab CI、GitHub Actions）通常需要将构建日志记录、分析、甚至触发后续动作。默认的进度输出方式由于包含大量 ANSI 控制字符（如进度条、颜色、光标移动等），会导致以下问题：

1. 日志中出现乱码或不可读内容
2. 日志解析工具无法正确识别构建步骤和状态
3. 构建失败时定位问题困难
4. 日志体积大、冗余信息多，影响存储和检索效率

因此，在 CI/CD 中使用 --progress=plain 可以带来以下优势：

• 输出格式统一，便于日志分析工具（如 ELK、Prometheus、Grafana）识别
• 减少日志中的无用字符，提升可读性和检索效率
• 便于集成自动化监控与告警机制

四、使用建议与最佳实践

以下是一些推荐的使用策略：

docker build --progress=plain -t my-app:latest .

在 CI/CD 配置文件中，例如 GitHub Actions 的 .github/workflows/build.yml 中：

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2
      - name: Build Docker Image
        run: docker build --progress=plain -t myorg/myapp:latest .

或者在 GitLab CI 的 .gitlab-ci.yml 中：

build:
  image: docker:latest
  services:
    - docker:dind
  script:
    - docker build --progress=plain -t registry.example.com/app:latest .

此外，可以结合日志分析工具自动识别构建步骤，提升 CI/CD 流水线的可观测性。

五、流程图：构建输出方式选择逻辑

            graph TD
                A[开始构建镜像] --> B{是否为 CI/CD 环境?}
                B -->|是| C[使用 --progress=plain]
                B -->|否| D[使用默认 --progress=auto]
                C --> E[输出纯文本日志，便于分析]
                D --> F[输出进度条，便于人工查看]