1. 概述
Docker Compose 是用于编排多容器 Docker 应用的重要工具。在构建 Docker 镜像 时，一个常被使用但容易被忽视的功能就是 context（上下文）。
本文将解释 context 的含义、作用机制以及最佳实践，帮助你更高效地使用 Docker Compose 构建镜像。
2. 理解 Docker Compose 的上下文
在 Docker 中，context 是构建服务镜像时所需文件的根目录。这个目录包含 Dockerfile、应用程序代码、配置文件以及依赖等。
在 docker-compose.yml 文件中，我们通过 build.context 字段来指定上下文路径。该路径可以是相对路径、绝对路径，也可以是一个远程 Git 仓库的 URL。
示例：
version: "3"
services:
app:
build:
context: .
ports:
- "8000:8000"
volumes:
- ./app:/app
command: >
sh -c "python manage.py runserver 0.0.0.0:8000"
上面的例子中，context: . 表示当前目录（即 docker-compose.yml 所在目录）作为上下文。Docker 会在这个目录中查找 Dockerfile 及其他构建所需文件。
3. 上下文的重要性
context 决定了 Docker 在构建镜像时能访问哪些文件。
Docker 在构建时会将整个上下文打包发送给 Docker Daemon。因此，上下文的大小直接影响构建效率。
例如目录结构如下：
my_django_project
├── app
│ ├── Dockerfile
│ ├── manage.py
│ └── myapp
├── docker-compose.yml
└── .git
如果使用 context: .，Docker 会把 .git 目录也打包进去，造成不必要的传输开销。
我们可以优化上下文路径：
version: "3"
services:
app:
build:
context: ./app
ports:
- "8000:8000"
volumes:
- ./app:/app
command: >
sh -c "python manage.py runserver 0.0.0.0:8000"
此时，Docker 仅打包 app/ 目录下的内容，避免了冗余文件，提高了构建速度。
指定 Dockerfile 位置
默认情况下，Docker 会在 context 路径下查找 Dockerfile。若 Dockerfile 不在上下文中，可以使用 dockerfile 字段指定其路径：
services:
app:
build:
context: .
dockerfile: ./app/Dockerfile
ports:
- "8000:8000"
这样，Docker 会使用当前目录作为上下文，但使用 app/Dockerfile 作为构建指令文件。
4. 上下文使用建议
✅ 保持上下文尽可能小
将上下文限制在最小的必要目录，可以显著提升构建速度，减少不必要的文件传输。
✅ 使用 .dockerignore 文件
.dockerignore 的作用类似于 .gitignore，用于排除不需要包含在构建上下文中的文件：
# Version control directory
.git
# Logs files
*.log
# Environment files
.env
.env.local
# Python cache files and compiled bytecode
__pycache__/
*.pyc
# Docker Compose file
docker-compose.yml
⚠️ 如果不加 .dockerignore，很容易把 .env、日志文件等敏感或冗余内容打包进去，影响构建效率甚至暴露敏感信息。
✅ 监控构建输出
运行 docker-compose build 时，注意观察控制台输出，确认哪些文件被上传到了 Docker Daemon，有助于发现潜在问题。
5. 总结
Context 是 Docker 构建流程中的核心概念。它决定了哪些文件会被包含进镜像构建过程中。
通过合理设置上下文路径、使用 .dockerignore、以及监控构建过程，可以有效提升构建效率，避免构建过程中踩坑。
在实际项目中，尤其是大型项目中，良好的上下文管理能显著提升 CI/CD 流程的稳定性和速度。