【产出】 > 写出一个规范的 Dockerfile(小镜像、能利用缓存、不用 root 运行),再用 Docker Compose 把应用和数据库一起编排起来,数据库就绪后应用才启动,数据也不会随容器删除而丢失。
【版本】 > 按 Docker 官方文档《Building best practices》和 Compose 文件参考编写,适用于 Docker Engine 24+ 与 Docker Compose v2(
docker compose命令)。
一、一个规范的 Dockerfile
以一个 Python Web 应用为例:
# ---------- 构建阶段 ----------
FROM python:3.12-slim AS build
WORKDIR /app
RUN apt-get update && apt-get install -y --no-install-recommends \
build-essential \
&& rm -rf /var/lib/apt/lists/*
COPY requirements.txt .
RUN pip install --prefix=/install --no-cache-dir -r requirements.txt
# ---------- 运行阶段 ----------
FROM python:3.12-slim
WORKDIR /app
COPY --from=build /install /usr/local
COPY . .
RUN useradd --system --uid 10001 app
USER app
EXPOSE 8000
CMD ["python", "-m", "gunicorn", "-b", "0.0.0.0:8000", "app:app"]
逐条对应 Docker 官方的最佳实践:
| 写法 | 官方依据 |
|---|---|
两个 FROM(多阶段构建) | 多阶段构建可以减小最终镜像体积:编译工具只留在构建阶段,最终镜像只带运行时文件 |
python:3.12-slim | 基础镜像要来自可信来源,并且尽量小。优先选官方镜像(Docker Official Images) |
apt-get update && apt-get install 写在同一个 RUN | 官方要求两者必须写在同一条 RUN 里,否则缓存会导致装到过期的包 |
--no-install-recommends 与 rm -rf /var/lib/apt/lists/* | 不装推荐包,并删除软件包索引,减小镜像体积 |
USER app | 服务不需要特权时,用 USER 切换到非 root 用户。官方建议给用户指定明确的 UID |
CMD ["…", "…"] | CMD 几乎总是应该使用 exec 形式(JSON 数组) |
先 COPY requirements.txt、再 COPY 源码:这样只改代码、不改依赖时,pip install 那一层可以直接用缓存,重新构建只要几秒。这是 Docker 层缓存机制带来的常用写法。
二、.dockerignore
官方建议用 .dockerignore 排除和构建无关的文件,写法和 .gitignore 类似:
.git
.venv
__pycache__/
*.pyc
.env
node_modules
【注意】 > 一定要排除
.env和密钥文件。COPY . .会把构建目录里的所有东西打进镜像,镜像一旦推送到仓库,里面的密钥就泄露了。
三、锁定基础镜像版本
官方提供了按摘要(digest)锁定的写法:
FROM python:3.12-slim@sha256:<摘要>
这样每次构建用的都是完全相同的基础镜像。官方同时提醒:锁定摘要后,基础镜像的安全更新也不会自动带进来,建议配合 Dependabot 之类的工具定期更新。
四、用 Compose 编排应用和数据库
官方推荐的文件名是 compose.yaml(docker-compose.yml 也能识别)。
services:
db:
image: postgres:16
environment:
POSTGRES_DB: app
POSTGRES_USER: app
POSTGRES_PASSWORD: ${DB_PASSWORD}
volumes:
- db-data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U app -d app"]
interval: 10s
timeout: 5s
retries: 5
start_period: 20s
web:
build: .
env_file: .env
ports:
- "8000:8000"
depends_on:
db:
condition: service_healthy
volumes:
db-data:
五、depends_on:只写服务名不会等数据库就绪
官方文档说明:短写法 depends_on: [db] 只控制创建和删除的顺序,Compose **不会等依赖服务"健康"**再启动当前服务。数据库容器刚启动时还不能接受连接,应用一启动就连库,就会报错退出。
要等数据库真正可用,用长写法加条件:
| condition | 含义 |
|---|---|
service_started | 等同于短写法,只保证先启动 |
service_healthy | 等依赖服务的 healthcheck 通过 |
service_completed_successfully | 等依赖服务运行完毕并成功退出,适合数据库迁移这类一次性任务 |
service_healthy 依赖对方定义了 healthcheck。test 写成列表时,第一项必须是 NONE、CMD 或 CMD-SHELL。
六、环境变量
environment:直接写在 compose 文件里,env_file:从文件读取。- 两者同时设置了同一个变量时,
environment的值优先。 env_file的相对路径相对于 compose 文件所在目录;文件里每行一个变量=值。- 布尔类的值(true、false、yes、no)要加引号,否则 YAML 会把它们转成布尔类型。
- 上例中的
${DB_PASSWORD}会从项目目录下的.env文件或当前 shell 环境里取值,密码不要直接写死在 compose 文件里。
七、数据持久化
上例中 db-data 是一个命名卷。docker compose down 删除容器后,命名卷里的数据库数据仍然保留,下次 up 会继续使用。
【注意】 >
docker compose down -v会连同卷一起删除,数据库数据随之丢失。只有确实要清空数据时才加-v。
八、常用命令
| 操作 | 命令 |
|---|---|
| 构建并后台启动 | docker compose up -d --build |
| 查看状态 | docker compose ps |
| 查看日志(持续输出) | docker compose logs -f web |
| 进入容器 | docker compose exec web sh |
| 停止并删除容器(保留卷) | docker compose down |
端口映射 "8000:8000" 的格式是 "主机端口:容器端口"。
参考资料
- Docker 构建最佳实践:https://docs.docker.com/build/building/best-practices/
- Compose 应用模型:https://docs.docker.com/compose/intro/compose-application-model/
- Compose services 参考:https://docs.docker.com/reference/compose-file/services/
评价 (0)