Docker / Compose 基础

课程目标

1. Dockerfile：多阶段构建、非 root、.dockerignore、镜像瘦身。
2. Compose：API + DB + Redis + 向量库依赖与健康检查。
3. 排障：端口、DNS、卷、权限、资源限制；可写 checklist。

认知地图

Dockerfile → image → container（进程+网络+存储）
Compose → 多容器编排 + 网络别名 + volume + env 文件

10 天学习路径

Day1：镜像与分层

• 任务：docker history 看分层；解释 cache 失效原因。
• 验收：改一行依赖时，哪些层会重建。

Day2：Python/FastAPI 镜像

• 任务：多阶段：builder 安装依赖，runtime 只拷贝 venv/site-packages。
• 验收：对比镜像大小（记录数字）。

Day3：安全基线

• 任务：非 root USER、只读根文件系统（如适用）、HEALTHCHECK。
• 验收：容器内 whoami 与 health 状态。

Day4：Compose 骨架

• 任务：api、postgres、redis 三服务；depends_on + condition: service_healthy。
• 验收：docker compose up -d 一次成功。

Day5：向量库或搜索侧车（可选）

• 任务：按资源选 Milvus Lite / Chroma 容器 / 仅外部云；写清你机器能跑的方案。
• 验收：从 API 容器能解析服务名访问依赖。

Day6：开发与调试

• 任务：bind mount 源码；对比性能损耗。
• 验收：docker compose logs -f 过滤错误。

Day7：数据持久化

• 任务：named volume vs bind mount；备份 Postgres 一条命令。
• 验收：down 删容器后数据仍在。

Day8：配置与密钥

• 任务：.env 不进镜像；Compose env_file；生产用 secret 的思路。
• 验收：docker inspect 确认无硬编码密钥层（概念上）。

Day9：发布流

• 任务：镜像 tag 规范 registry/app:gitsha；回滚策略。
• 验收：一页 release.md。

Day10：面试

• 任务：5 分钟：从本地到预发布环境差异（网络、卷、资源、观测）。

Compose 片段示例（思路级）

• 为 Postgres 声明 healthcheck: pg_isready
• API 依赖健康后再启动，避免启动风暴重试

常见陷阱

• 把 node_modules 或 .venv 打进上下文，构建极慢。
• 容器内连 localhost 误以为是别的容器。
• 无资源上限，本地 OOM 拖死整机。

实操验收

• 一键 docker compose up -d 起全套（按你实际栈裁剪也可）
• 重启后数据不丢
• docker-ops-checklist.md：排障步骤 + 常用命令

最新资料（2026-05 校验）

• Docker 官方文档
• Docker Compose 规范
• Best practices for writing Dockerfiles