前言FDE系列内容总纲【大纲】FDE 前沿部署工程师学习系列教程-CSDN博客前置课程列表见文档结尾附录。阶段2·Day 45综合实战 — Docker Nginx Git 完整部署与本周收官FDE 学习系列教程 · 第二阶段 · 第 5 周 · Day 5预计时长3 小时 | 难度★★★☆☆ | 前置知识Day 41-44 全部内容一句话目标走完一次真实的端到端部署流水线Git 管理 → Compose 构建 → 三容器编排 → Nginx 代理 → 全链路验证 → 更新回滚串联本周全部知识点并通过验收。 开场把四天学的零件组装成一台整车前四天你分别认识了零件Day 41 的容器操作、Day 42 的 Dockerfile、Day 43 的 Compose 编排、Day 44 的 Nginx 和 Git。零件单独会用不算本事能组装成一台能跑的整车才是 FDE 的交付能力。今天不引入新概念做一件事从零走一遍完整的项目部署流程就像你到客户现场真正会做的那样拉代码 → 配环境 → 构建镜像 → 一键起整套服务 → 验证 → 更新 → 回滚走完今天你手里会有一个结构规范、可以放进作品集的容器化项目。跟着做别跳步。 一、先看最终成品长什么样浏览器 / curl │ http://localhost80 ▼ ┌─────────────────────┐ │ nginx 容器 │ │ 反向代理唯一入口 │ └──────────┬──────────┘ │ 内部网络服务名 api ┌──────────▼──────────┐ │ api 容器 │ │ FastAPI自己的镜像│ └──────────┬──────────┘ │ 内部网络服务名 db ┌──────────▼──────────┐ │ db 容器 │ │ MySQL 8 数据卷 │ └─────────────────────┘ 代码管理Git本地仓库 可选 GitHub 远程 一键控制docker compose up -d / down / logs标准项目目录结构fde_deploy/ ├── app/ │ ├── main.py # FastAPI 应用 │ └── requirements.txt # Python 依赖 ├── db/ │ └── init.sql # 数据库初始化脚本 ├── nginx/ │ └── nginx.conf # Nginx 反向代理配置 ├── Dockerfile # 构建 api 镜像的配方 ├── .dockerignore # 构建镜像时排除的文件 ├── .gitignore # Git 忽略的文件 ├── .env.example # 环境变量模板真实 .env 不进 Git └── docker-compose.yml # 三容器编排总纲 这种按职责分目录的结构app/db/nginx 各一摊比所有文件堆在根目录清晰是实际项目的常见组织方式。今天就按这个结构搭。️ 二、动手创建全部文件新建项目mkdir -p ~/docker_lab/fde_deploy/{app,db,nginx} cd ~/docker_lab/fde_deploy① app/main.py一个带完整 CRUD 雏形、健康检查、环境变量配置的 FastAPIfrom fastapi import FastAPI, HTTPException from pydantic import BaseModel, Field import os import mysql.connector import uvicorn app FastAPI(titleFDE 设备管理 API, version1.0) # ---------- 数据库连接全部走环境变量---------- def get_db(): return mysql.connector.connect( hostos.getenv(DB_HOST, db), portint(os.getenv(DB_PORT, 3306)), useros.getenv(DB_USER, root), passwordos.getenv(DB_PASSWORD, root123), databaseos.getenv(DB_NAME, fde_db), ) # ---------- 数据模型 ---------- class DeviceIn(BaseModel): name: str Field(..., min_length1, max_length50, description设备名) type: str Field(..., max_length20, description类型) temperature: float Field(0, ge-50, le500, description温度) # ---------- 接口 ---------- app.get(/, tags[系统]) def root(): return {app: FDE 设备管理 API, version: 1.0, docs: /docs} app.get(/health, tags[系统]) def health(): 健康检查API 进程 数据库连通性 try: conn get_db() conn.ping() conn.close() return {status: ok, db: connected} except Exception as e: raise HTTPException(status_code503, detailfDB error: {e}) app.get(/devices, tags[设备]) def list_devices(): conn get_db() cur conn.cursor(dictionaryTrue) cur.execute(SELECT id, name, type, temperature FROM devices ORDER BY id) rows cur.fetchall() conn.close() return {devices: rows, count: len(rows)} app.get(/devices/hot, tags[设备]) def hot_devices(): 温度超过 80 的设备告警用 conn get_db() cur conn.cursor(dictionaryTrue) cur.execute(SELECT name, temperature FROM devices WHERE temperature 80 ORDER BY temperature DESC) rows cur.fetchall() conn.close() return {hot_devices: rows, count: len(rows)} app.post(/devices, status_code201, tags[设备]) def create_device(d: DeviceIn): conn get_db() cur conn.cursor() cur.execute( INSERT INTO devices (name, type, temperature) VALUES (%s, %s, %s), (d.name, d.type, d.temperature), ) conn.commit() new_id cur.lastrowid conn.close() return {id: new_id, name: d.name, type: d.type, temperature: d.temperature} if __name__ __main__: uvicorn.run(app, host0.0.0.0, port8000)② app/requirements.txtfastapi0.115.0 uvicorn0.30.0 mysql-connector-python9.1.0 pydantic2.9.0③ db/init.sqlCREATE TABLE IF NOT EXISTS devices ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, type VARCHAR(20) NOT NULL, temperature DECIMAL(5,1) DEFAULT 0, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); INSERT INTO devices (name, type, temperature) VALUES (注塑机A1, 注塑, 65.0), (注塑机A2, 注塑, 82.0), (注塑机A3, 注塑, 91.0), (冲压机B1, 冲压, 75.0), (冲压机B2, 冲压, 88.0);④ Dockerfile注意代码现在在app/子目录COPY 路径要相应调整。# ---------- FDE API 镜像 ---------- FROM python:3.12-slim WORKDIR /app # 先拷依赖清单利用层缓存 COPY app/requirements.txt . RUN pip install --no-cache-dir -r requirements.txt \ -i https://pypi.tuna.tsinghua.edu.cn/simple # 再拷代码 COPY app/ . EXPOSE 8000 CMD [python, main.py]⑤ nginx/nginx.confupstream fde_backend { server api:8000; } server { listen 80; server_name localhost; # API 请求全部转发 location / { proxy_pass http://fde_backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }⑥ docker-compose.yml总纲services: api: build: context: . # 构建上下文是项目根目录 dockerfile: Dockerfile container_name: fde-api environment: DB_HOST: db DB_PORT: 3306 DB_USER: root DB_PASSWORD: ${DB_PASSWORD:-root123} DB_NAME: ${DB_NAME:-fde_db} depends_on: db: condition: service_healthy restart: unless-stopped # 故意不映射 8000 到宿主机只允许通过 nginx 访问更安全 db: image: mysql:8.0 container_name: fde-mysql environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD:-root123} MYSQL_DATABASE: ${DB_NAME:-fde_db} volumes: - db_data:/var/lib/mysql - ./db/init.sql:/docker-entrypoint-initdb.d/init.sql healthcheck: test: [CMD, mysqladmin, ping, -h, localhost, -p${DB_PASSWORD:-root123}] interval: 5s timeout: 5s retries: 10 restart: unless-stopped nginx: image: nginx:alpine container_name: fde-nginx ports: - 80:80 volumes: - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf depends_on: - api restart: unless-stopped volumes: db_data: 这里用了两个本周学到的专业设计${DB_PASSWORD:-root123}从.env读密码没配就用默认值开发友好condition: service_healthyapi 等 MySQL真正健康才启动解决启动≠就绪问题api 不暴露端口外部只能经 nginx 进入⑦ .dockerignore 和 .gitignore.dockerignore__pycache__/ *.pyc venv/ .venv/ .env .git/ *.log *.md.gitignore__pycache__/ *.pyc venv/ .venv/ .env *.log .vscode/.env.example给同事看的模板不含真实密码# 复制本文件为 .env 并填入真实值 DB_PASSWORDroot123 DB_NAMEfde_db文件全部就位检查一下find . -type f -not -path ./.git/* | sort # ./Dockerfile # ./app/main.py # ./app/requirements.txt # ./db/init.sql # ./docker-compose.yml # ./nginx/nginx.conf # ./.dockerignore # ./.env.example # ./.gitignore️ 三、完整部署流水线Step 1Git 初始化并首次提交git init git add . git commit -m feat: 初始化 FDE 设备管理 APIFastAPIMySQLNginx 容器化 git log --onelineStep 2配置环境变量cp .env.example .env # .env 已被 .gitignore 和 .dockerignore 排除可以放心填真实值 cat .envStep 3一键构建并启动docker compose up -d --build首次构建会拉取 mysql:8.0、nginx:alpine、python:3.12-slim 三个基础镜像耐心等几分钟。观察输出关注三个容器是否都 Started。Step 4确认服务状态docker compose ps # NAME STATUS PORTS # fde-nginx Up X seconds 0.0.0.0:80-80/tcp # fde-api Up X seconds # fde-mysql Up X seconds (healthy)注意 db 的 STATUS 带(healthy)——这是 healthcheck 的功劳api 因为等了它启动时数据库必然已就绪。如有异常看日志定位docker compose logs -f api # 跟 api 日志 docker compose logs -f nginx # 跟 nginx 日志Step 5全链路验证模拟客户验收# ① 首页经 Nginx 80 端口 curl http://localhost/ # {app:FDE 设备管理 API,version:1.0,docs:/docs} # ② 健康检查API DB 都通 curl http://localhost/health # {status:ok,db:connected} # ③ 查全部设备 curl http://localhost/devices # {devices:[...],count:5} # ④ 查高温设备业务接口 curl http://localhost/devices/hot # {hot_devices:[{name:注塑机A3,temperature:91.0},...],count:3} # ⑤ 新增设备 curl -X POST http://localhost/devices \ -H Content-Type: application/json \ -d {name:焊接机C1,type:焊接,temperature:78.5} # {id:6,name:焊接机C1,...} # ⑥ 参数校验Pydantic 自动拦截非法数据 curl -X POST http://localhost/devices \ -H Content-Type: application/json \ -d {name:,type:焊接,temperature:9999} # 返回 422 校验错误 # ⑦ Swagger 文档浏览器打开 # http://localhost/docsStep 6验证外部无法绕过 Nginx 直连 APIcurl http://localhost:8000 # 连接失败/拒绝 —— 因为我们没有给 api 配置 ports 映射 # 所有流量必须从 80 端口的 Nginx 进入这就是容器网络隔离带来的安全姿态唯一入口是 Nginx。️ 四、日常运维场景演练场景 A改了代码如何更新部署这是最高频的操作。走一遍标准流程# ① 改代码给 main.py 加一个接口比如返回设备总数 # app.get(/devices/count) ... # ② Git 提交 git add app/main.py git commit -m feat: 添加设备数量统计接口 # ③ 重新构建并启动只有 api 的镜像会重建db/nginx 不动 docker compose up -d --build # ④ 验证 curl http://localhost/devices/count为什么只重建 api · db 用的是官方镜像没变 → 不动 · nginx 配置没改 → 不动 · api 的 build 上下文变了main.py 改了→ 重新 build 镜像并重建容器 · db_data 数据卷不受任何影响 → 数据安全场景 B查看日志排障docker compose logs --tail50 api # api 最近 50 行 docker compose logs -f nginx # 实时盯 nginx docker compose logs | grep -i error # 所有服务日志里找 error场景 C数据备份与恢复# 备份数据库在容器内用 mysqldump导出到宿主机 docker compose exec db mysqldump -uroot -proot123 fde_db backup_$(date %Y%m%d).sql # 恢复 cat backup_20260920.sql | docker compose exec -T db mysql -uroot -proot123 fde_db 这和第 4 周的备份脚本思想完全一致只是数据源从文件目录变成了容器里的数据库。你完全可以写个 cron 任务每天自动 dump。场景 D回滚到上一个版本# ① 看历史找到上一个好版本的提交 git log --oneline # a1b2c3d feat: 添加设备数量统计接口 ← 新版本有问题 # d4e5f6g feat: 初始化... ← 想回到这个 # ② 代码层面回退未 push 的本地提交 git revert a1b2c3d # 生成一个反向提交安全 # 或临时回到旧代码git checkout d4e5f6g -- app/ # ③ 重新部署旧代码 docker compose up -d --build更专业的镜像级回滚给镜像打版本标签docker build -t fde-api:1.1 . # 新版 docker build -t fde-api:1.0 . # 旧版标签还在 # compose 里镜像写 fde-api:1.0 就能切回或者 up 时指定场景 E彻底清理与重建docker compose down # 删容器网络保留数据 docker compose up -d # 重建数据还在 docker compose down -v # ⚠️ 连数据卷一起删回到全新状态 docker compose up -d --build # 数据库会重新执行 init.sql 五、把项目推上 GitHub可选但推荐# 在 GitHub 新建空仓库 fde-deploy然后 git branch -M main git remote add origin https://github.com/你的用户名/fde-deploy.git git push -u origin main推之前最后检查一遍安全清单# 确认敏感文件没有被 Git 跟踪 git status git ls-files | grep -E \.env$|venv # 应该没有任何输出 交付安全红线.env、密码、密钥、客户数据绝不进 Git、绝不进镜像。用.env.example提供模板真实值通过环境变量在部署机注入。 本周复习知识地图Docker / Nginx / GitDay 41-45 │ ├─ Docker 入门Day 41 │ ├─ 容器 vs 虚拟机共享内核、秒级、MB 级 │ ├─ 镜像只读模板/类vs 容器运行实例/对象 │ ├─ docker pull/run/ps/stop/start/rm │ ├─ docker images/rmi/logs/exec/inspect │ ├─ -p 宿主机:容器端口映射 │ ├─ -v 宿主路径或卷:容器路径数据持久化 │ └─ --restart unless-stopped │ ├─ DockerfileDay 42 │ ├─ FROM/WORKDIR/COPY/RUN/ENV/EXPOSE/CMD │ ├─ RUN 构建时执行 vs CMD 运行时执行 │ ├─ 分层镜像与层缓存某层变其后全失效 │ ├─ 排序系统→依赖→代码依赖层放代码前 │ ├─ .dockerignore排除 venv/.env/.git │ ├─ docker build -t 名:版本 . │ └─ 服务必须监听 0.0.0.0 │ ├─ Docker ComposeDay 43 │ ├─ docker-compose.yml 声明式编排 │ ├─ servicesimage/build/ports/volumes/environment │ ├─ depends_on healthcheck启动顺序 vs 真正就绪 │ ├─ 服务名即主机名内置 DNS容器互访用内部端口 │ ├─ 命名卷持久化initdb.d 自动初始化 │ ├─ env_file / ${VAR:-default} 配置外置 │ └─ up -d --build / down / logs / ps / exec │ ├─ Nginx GitDay 44 │ ├─ 正向 vs 反向代理 │ ├─ listen 80 proxy_pass proxy_set_header │ ├─ upstream 负载均衡轮询/权重/ip_hash │ ├─ 容器内转发用服务名 api:8000 │ ├─ nginx -t 测试后 reload │ ├─ Git 三区工作区/暂存区/版本库 │ ├─ init/status/add/commit/log/diff │ ├─ branch/checkout -b/merge/-d │ ├─ remote/push -u/pull/clone │ └─ revert安全撤销/ reset --hard危险 │ └─ 综合实战Day 45 ├─ 规范目录结构 app/db/nginx ├─ 三容器nginx(80) → api → mysql(数据卷) ├─ 完整流水线提交→配置→构建→启动→验证 ├─ 更新部署只重建变动服务 ├─ 数据备份恢复、版本回滚 └─ 安全.env 不进 Git/镜像、api 不直接暴露 本周验收清单序号验收项达标标准1容器基础能解释容器与虚拟机、镜像与容器的区别2容器生命周期熟练 run/ps/stop/rm/exec/logs3端口与卷能正确使用 -p、-v说清数据为何能持久化4Dockerfile独立写出 FastAPI 的 Dockerfile 并 build 成功5层缓存能解释先拷 requirements的原因并验证缓存6.dockerignore能列出必须排除的文件及原因7Compose 编排能用 yml 一键起 apimysqlnginx8服务发现理解服务名即主机名会配置容器互访9就绪依赖会用 healthcheck condition 解决启动顺序10数据持久化down 后数据不丢能做 mysqldump 备份11Nginx80 端口能转发到 API改配置会 -t reload12安全姿态api 不对外暴露端口.env 不进镜像/Git13Git 基础init/add/commit/log/status 全流程14Git 分支能开 feature 分支开发并合并15Git 远程能 push/pull知道冲突怎么解16更新与回滚改代码后能重新部署也能回退旧版自评方式16 项里能独立做到 13 项以上 扎实通过。卡住的项目回到对应那一天把实操命令亲手再敲一遍——容器化是手上功夫看懂和做通之间隔着至少三遍练习。 本周收官你获得了什么五天前 现在 ────── ──── 部署 在一台机器上手动装环境 部署 一条 docker compose up 在我电脑上能跑 镜像在哪跑都一样 代码靠复制文件夹备份 Git 提交历史 分支 远程 多个服务要分别手动启动 一个 yml 声明整套系统 服务裸奔在各种端口 Nginx 统一门面80 端口进入 改完代码靠口头通知重启一下 up -d --build 标准化更新把本周放进整个第二阶段的版图里看你的技术栈已经相当完整第2周写得出 APIFastAPI 第3周存得下数据SQL / MySQL / pandas 第4周管得住服务器Linux / Shell / 定时/自愈 第5周交付得了环境Docker / Compose / Nginx / Git ┌─────────────────────────────────────────────┐ │ 你已经能独立交付一个容器化的后端服务 │ │ 代码版本化 → 镜像化 → 编排 → 反向代理 → │ │ 数据持久化 → 可更新可回滚 │ └─────────────────────────────────────────────┘这正是初级 FDE / 后端实施工程师的核心交付能力。你在客户现场听到环境部署、容器化改造、服务上线心里已经有完整的操作地图了。 下周预告API 集成与系统对接第二阶段最后一周地基数据、服务器、部署全部打完最后一周回到 FDE 最贴近业务的主题——让你的系统和客户的系统对话RESTful 规范 认证授权JWT、API Key保护你的接口不被乱调对接企业 IM调用飞书/钉钉开放 API获取 token、发消息、读通讯录Webhook 事件回调客户系统有事件发生时主动通知你接收验签幂等处理数据映射在不同系统的字段格式之间做翻译OpenAPI 文档 pytest 测试收官综合项目一个飞书消息 → Webhook → 工单入库 → API 查询的完整联动系统学完下周第二阶段 30 天全部收官你将拥有从写代码、管数据、部署服务到对接外部系统的完整闭环。周末好好休整下周冲刺附录前置课程列表阶段一认知启蒙AI 认知与 FDE 角色AI 认知【FDE系列】阶段1Day 1AI 层级关系 — 四个嵌套的圈-CSDN博客【FDE系列】阶段1Day 2AI 三阶段发展史 — 会认 → 会判断 → 会创造-CSDN博客【FDE系列】阶段1Day 3符号 AI vs 机器学习 — 两条路线的本质区别-CSDN博客【FDE系列】阶段1Day 4Transformer 的历史意义 — 2017 年的分水岭-CSDN博客【FDE系列】阶段1Day 5本周复习与自测 — 检验你的 AI 认知地基-CSDN博客【FDE系列】阶段1Day 6Transformer 架构 — 一张图纸盖出千千万万栋楼-CSDN博客【FDE系列】阶段1Day 7LLM 本质 — 文字接龙机器-CSDN博客【FDE系列】阶段1Day 8Token — 模型眼中的最小单位-CSDN博客【FDE系列】阶段1Day 9AI 幻觉 — 为什么会一本正经地胡说八道-CSDN博客【FDE系列】阶段1Day 10上下文窗口 — 模型的记忆力上限 本周复习-CSDN博客【FDE系列】阶段1Day 11Prompt — 给模型立规矩-CSDN博客【FDE系列】阶段1Day 12Memory — 让模型记住上下文【FDE系列】阶段1Day 13RAG — 给模型配图书管理员-CSDN博客【FDE系列】阶段1Day 14Tool Use — 让模型动手操作-CSDN博客【FDE系列】阶段1Day 15MCP — 统一的工具接口标准 第三周复习-CSDN博客FDE 基础概念【FDE系列】阶段1Day 16什么是 FDE — 把 AI 变成客户结果的人-CSDN博客【FDE系列】阶段1Day 17FDE vs 传统实施 — 三大本质区别-CSDN博客【FDE系列】阶段1Day 18FDE 三重身份 C6 胜任力模型-CSDN博客【FDE系列】阶段1Day 19七阶段行动路径 行业经验的价值-CSDN博客【FDE系列】阶段1Day 20阶段总结与产出物 — 第一阶段收官-CSDN博客阶段二技术地基Python FastAPI SQL Docker API 集成Python基础【FDE系列】阶段2Day 21Python 环境搭建 — 写出你的第一行代码-CSDN博客【FDE系列】阶段2Day 22变量、数据类型、条件判断 — Python 的“记忆“和“判断“-CSDN博客【FDE系列】阶段2Day 23循环与函数 — 让代码跑 100 遍、把逻辑打包复用-CSDN博客【FDE系列】阶段2Day 24数据结构 — 列表、字典、集合、元组-CSDN博客【FDE系列】阶段2Day 25文件读写与 JSON — 让程序连通外部数据第一周收官-CSDN博客【FDE系列】阶段2Day 26模块化编程 — 把代码拆成“抽屉柜“-CSDN博客【FDE系列】阶段2Day 27异常处理与日志 — 让程序“摔不烂、查得到“-CSDN博客FastAPI入门到进阶【FDE系列】阶段2Day 28FastAPI 入门 — 把你的函数变成 API 服务-CSDN博客【FDE系列】阶段2Day 29FastAPI 进阶 — Pydantic 模型与完整 CRUD 实战-CSDN博客【FDE系列】阶段2Day 30生产代码规范 — 测试、类型注解、配置管理第二周收官-CSDN博客SQL基础【FDE系列】阶段2Day 31SQL 基础 — 增删改查一把梭-CSDN博客【FDE系列】阶段2Day 32多表查询 — JOIN 与聚合-CSDN博客【FDE系列】阶段2Day 33进阶查询 — 窗口函数与 CTE-CSDN博客【FDE系列】阶段2Day 34数据清洗 — 把脏数据捋干净-CSDN博客【FDE系列】阶段2Day 35Python SQL — 工单接入 MySQL 本周收官-CSDN博客Linux基础【FDE系列】阶段2Day 36Linux 入门与文件操作 — 扔掉鼠标的第一天-CSDN博客【FDE系列】阶段2Day 37权限、进程与文本三剑客-CSDN博客【FDE系列】阶段2Day 38Shell 脚本 — 把命令串起来自动跑-CSDN博客【FDE系列】阶段2Day 39Linux 综合实战 — 让服务无人值守-CSDN博客【FDE系列】阶段2Day 40Shell 进阶 — 生产级脚本与本周收官-CSDN博客Docker【FDE系列】阶段2Day 41Docker 入门 — 把环境装进盒子-CSDN博客【FDE系列】阶段2Day 41up详细版Docker 入门 — 把环境装进盒子-CSDN博客【FDE系列】阶段2Day 42Dockerfile 实战 — 把你的应用打包成镜像-CSDN博客【FDE系列】阶段2Day 42UP详细版Dockerfile 实战 — 把你的应用打包成镜像-CSDN博客【FDE系列】阶段2Day 43Docker Compose — 多容器一键编排-CSDN博客【FDE系列】阶段2Day 43UP详细版Docker Compose — 多容器一键编排-CSDN博客【FDE系列】阶段2Day 44Nginx 反向代理 Git 版本控制-CSDN博客【FDE系列】阶段2Day 44UP详细版Nginx 反向代理 Git 版本控制-CSDN博客
前言FDE系列内容总纲【大纲】FDE 前沿部署工程师学习系列教程-CSDN博客前置课程列表见文档结尾附录。阶段2·Day 45综合实战 — Docker Nginx Git 完整部署与本周收官FDE 学习系列教程 · 第二阶段 · 第 5 周 · Day 5预计时长3 小时 | 难度★★★☆☆ | 前置知识Day 41-44 全部内容一句话目标走完一次真实的端到端部署流水线Git 管理 → Compose 构建 → 三容器编排 → Nginx 代理 → 全链路验证 → 更新回滚串联本周全部知识点并通过验收。 开场把四天学的零件组装成一台整车前四天你分别认识了零件Day 41 的容器操作、Day 42 的 Dockerfile、Day 43 的 Compose 编排、Day 44 的 Nginx 和 Git。零件单独会用不算本事能组装成一台能跑的整车才是 FDE 的交付能力。今天不引入新概念做一件事从零走一遍完整的项目部署流程就像你到客户现场真正会做的那样拉代码 → 配环境 → 构建镜像 → 一键起整套服务 → 验证 → 更新 → 回滚走完今天你手里会有一个结构规范、可以放进作品集的容器化项目。跟着做别跳步。 一、先看最终成品长什么样浏览器 / curl │ http://localhost80 ▼ ┌─────────────────────┐ │ nginx 容器 │ │ 反向代理唯一入口 │ └──────────┬──────────┘ │ 内部网络服务名 api ┌──────────▼──────────┐ │ api 容器 │ │ FastAPI自己的镜像│ └──────────┬──────────┘ │ 内部网络服务名 db ┌──────────▼──────────┐ │ db 容器 │ │ MySQL 8 数据卷 │ └─────────────────────┘ 代码管理Git本地仓库 可选 GitHub 远程 一键控制docker compose up -d / down / logs标准项目目录结构fde_deploy/ ├── app/ │ ├── main.py # FastAPI 应用 │ └── requirements.txt # Python 依赖 ├── db/ │ └── init.sql # 数据库初始化脚本 ├── nginx/ │ └── nginx.conf # Nginx 反向代理配置 ├── Dockerfile # 构建 api 镜像的配方 ├── .dockerignore # 构建镜像时排除的文件 ├── .gitignore # Git 忽略的文件 ├── .env.example # 环境变量模板真实 .env 不进 Git └── docker-compose.yml # 三容器编排总纲 这种按职责分目录的结构app/db/nginx 各一摊比所有文件堆在根目录清晰是实际项目的常见组织方式。今天就按这个结构搭。️ 二、动手创建全部文件新建项目mkdir -p ~/docker_lab/fde_deploy/{app,db,nginx} cd ~/docker_lab/fde_deploy① app/main.py一个带完整 CRUD 雏形、健康检查、环境变量配置的 FastAPIfrom fastapi import FastAPI, HTTPException from pydantic import BaseModel, Field import os import mysql.connector import uvicorn app FastAPI(titleFDE 设备管理 API, version1.0) # ---------- 数据库连接全部走环境变量---------- def get_db(): return mysql.connector.connect( hostos.getenv(DB_HOST, db), portint(os.getenv(DB_PORT, 3306)), useros.getenv(DB_USER, root), passwordos.getenv(DB_PASSWORD, root123), databaseos.getenv(DB_NAME, fde_db), ) # ---------- 数据模型 ---------- class DeviceIn(BaseModel): name: str Field(..., min_length1, max_length50, description设备名) type: str Field(..., max_length20, description类型) temperature: float Field(0, ge-50, le500, description温度) # ---------- 接口 ---------- app.get(/, tags[系统]) def root(): return {app: FDE 设备管理 API, version: 1.0, docs: /docs} app.get(/health, tags[系统]) def health(): 健康检查API 进程 数据库连通性 try: conn get_db() conn.ping() conn.close() return {status: ok, db: connected} except Exception as e: raise HTTPException(status_code503, detailfDB error: {e}) app.get(/devices, tags[设备]) def list_devices(): conn get_db() cur conn.cursor(dictionaryTrue) cur.execute(SELECT id, name, type, temperature FROM devices ORDER BY id) rows cur.fetchall() conn.close() return {devices: rows, count: len(rows)} app.get(/devices/hot, tags[设备]) def hot_devices(): 温度超过 80 的设备告警用 conn get_db() cur conn.cursor(dictionaryTrue) cur.execute(SELECT name, temperature FROM devices WHERE temperature 80 ORDER BY temperature DESC) rows cur.fetchall() conn.close() return {hot_devices: rows, count: len(rows)} app.post(/devices, status_code201, tags[设备]) def create_device(d: DeviceIn): conn get_db() cur conn.cursor() cur.execute( INSERT INTO devices (name, type, temperature) VALUES (%s, %s, %s), (d.name, d.type, d.temperature), ) conn.commit() new_id cur.lastrowid conn.close() return {id: new_id, name: d.name, type: d.type, temperature: d.temperature} if __name__ __main__: uvicorn.run(app, host0.0.0.0, port8000)② app/requirements.txtfastapi0.115.0 uvicorn0.30.0 mysql-connector-python9.1.0 pydantic2.9.0③ db/init.sqlCREATE TABLE IF NOT EXISTS devices ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, type VARCHAR(20) NOT NULL, temperature DECIMAL(5,1) DEFAULT 0, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); INSERT INTO devices (name, type, temperature) VALUES (注塑机A1, 注塑, 65.0), (注塑机A2, 注塑, 82.0), (注塑机A3, 注塑, 91.0), (冲压机B1, 冲压, 75.0), (冲压机B2, 冲压, 88.0);④ Dockerfile注意代码现在在app/子目录COPY 路径要相应调整。# ---------- FDE API 镜像 ---------- FROM python:3.12-slim WORKDIR /app # 先拷依赖清单利用层缓存 COPY app/requirements.txt . RUN pip install --no-cache-dir -r requirements.txt \ -i https://pypi.tuna.tsinghua.edu.cn/simple # 再拷代码 COPY app/ . EXPOSE 8000 CMD [python, main.py]⑤ nginx/nginx.confupstream fde_backend { server api:8000; } server { listen 80; server_name localhost; # API 请求全部转发 location / { proxy_pass http://fde_backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }⑥ docker-compose.yml总纲services: api: build: context: . # 构建上下文是项目根目录 dockerfile: Dockerfile container_name: fde-api environment: DB_HOST: db DB_PORT: 3306 DB_USER: root DB_PASSWORD: ${DB_PASSWORD:-root123} DB_NAME: ${DB_NAME:-fde_db} depends_on: db: condition: service_healthy restart: unless-stopped # 故意不映射 8000 到宿主机只允许通过 nginx 访问更安全 db: image: mysql:8.0 container_name: fde-mysql environment: MYSQL_ROOT_PASSWORD: ${DB_PASSWORD:-root123} MYSQL_DATABASE: ${DB_NAME:-fde_db} volumes: - db_data:/var/lib/mysql - ./db/init.sql:/docker-entrypoint-initdb.d/init.sql healthcheck: test: [CMD, mysqladmin, ping, -h, localhost, -p${DB_PASSWORD:-root123}] interval: 5s timeout: 5s retries: 10 restart: unless-stopped nginx: image: nginx:alpine container_name: fde-nginx ports: - 80:80 volumes: - ./nginx/nginx.conf:/etc/nginx/conf.d/default.conf depends_on: - api restart: unless-stopped volumes: db_data: 这里用了两个本周学到的专业设计${DB_PASSWORD:-root123}从.env读密码没配就用默认值开发友好condition: service_healthyapi 等 MySQL真正健康才启动解决启动≠就绪问题api 不暴露端口外部只能经 nginx 进入⑦ .dockerignore 和 .gitignore.dockerignore__pycache__/ *.pyc venv/ .venv/ .env .git/ *.log *.md.gitignore__pycache__/ *.pyc venv/ .venv/ .env *.log .vscode/.env.example给同事看的模板不含真实密码# 复制本文件为 .env 并填入真实值 DB_PASSWORDroot123 DB_NAMEfde_db文件全部就位检查一下find . -type f -not -path ./.git/* | sort # ./Dockerfile # ./app/main.py # ./app/requirements.txt # ./db/init.sql # ./docker-compose.yml # ./nginx/nginx.conf # ./.dockerignore # ./.env.example # ./.gitignore️ 三、完整部署流水线Step 1Git 初始化并首次提交git init git add . git commit -m feat: 初始化 FDE 设备管理 APIFastAPIMySQLNginx 容器化 git log --onelineStep 2配置环境变量cp .env.example .env # .env 已被 .gitignore 和 .dockerignore 排除可以放心填真实值 cat .envStep 3一键构建并启动docker compose up -d --build首次构建会拉取 mysql:8.0、nginx:alpine、python:3.12-slim 三个基础镜像耐心等几分钟。观察输出关注三个容器是否都 Started。Step 4确认服务状态docker compose ps # NAME STATUS PORTS # fde-nginx Up X seconds 0.0.0.0:80-80/tcp # fde-api Up X seconds # fde-mysql Up X seconds (healthy)注意 db 的 STATUS 带(healthy)——这是 healthcheck 的功劳api 因为等了它启动时数据库必然已就绪。如有异常看日志定位docker compose logs -f api # 跟 api 日志 docker compose logs -f nginx # 跟 nginx 日志Step 5全链路验证模拟客户验收# ① 首页经 Nginx 80 端口 curl http://localhost/ # {app:FDE 设备管理 API,version:1.0,docs:/docs} # ② 健康检查API DB 都通 curl http://localhost/health # {status:ok,db:connected} # ③ 查全部设备 curl http://localhost/devices # {devices:[...],count:5} # ④ 查高温设备业务接口 curl http://localhost/devices/hot # {hot_devices:[{name:注塑机A3,temperature:91.0},...],count:3} # ⑤ 新增设备 curl -X POST http://localhost/devices \ -H Content-Type: application/json \ -d {name:焊接机C1,type:焊接,temperature:78.5} # {id:6,name:焊接机C1,...} # ⑥ 参数校验Pydantic 自动拦截非法数据 curl -X POST http://localhost/devices \ -H Content-Type: application/json \ -d {name:,type:焊接,temperature:9999} # 返回 422 校验错误 # ⑦ Swagger 文档浏览器打开 # http://localhost/docsStep 6验证外部无法绕过 Nginx 直连 APIcurl http://localhost:8000 # 连接失败/拒绝 —— 因为我们没有给 api 配置 ports 映射 # 所有流量必须从 80 端口的 Nginx 进入这就是容器网络隔离带来的安全姿态唯一入口是 Nginx。️ 四、日常运维场景演练场景 A改了代码如何更新部署这是最高频的操作。走一遍标准流程# ① 改代码给 main.py 加一个接口比如返回设备总数 # app.get(/devices/count) ... # ② Git 提交 git add app/main.py git commit -m feat: 添加设备数量统计接口 # ③ 重新构建并启动只有 api 的镜像会重建db/nginx 不动 docker compose up -d --build # ④ 验证 curl http://localhost/devices/count为什么只重建 api · db 用的是官方镜像没变 → 不动 · nginx 配置没改 → 不动 · api 的 build 上下文变了main.py 改了→ 重新 build 镜像并重建容器 · db_data 数据卷不受任何影响 → 数据安全场景 B查看日志排障docker compose logs --tail50 api # api 最近 50 行 docker compose logs -f nginx # 实时盯 nginx docker compose logs | grep -i error # 所有服务日志里找 error场景 C数据备份与恢复# 备份数据库在容器内用 mysqldump导出到宿主机 docker compose exec db mysqldump -uroot -proot123 fde_db backup_$(date %Y%m%d).sql # 恢复 cat backup_20260920.sql | docker compose exec -T db mysql -uroot -proot123 fde_db 这和第 4 周的备份脚本思想完全一致只是数据源从文件目录变成了容器里的数据库。你完全可以写个 cron 任务每天自动 dump。场景 D回滚到上一个版本# ① 看历史找到上一个好版本的提交 git log --oneline # a1b2c3d feat: 添加设备数量统计接口 ← 新版本有问题 # d4e5f6g feat: 初始化... ← 想回到这个 # ② 代码层面回退未 push 的本地提交 git revert a1b2c3d # 生成一个反向提交安全 # 或临时回到旧代码git checkout d4e5f6g -- app/ # ③ 重新部署旧代码 docker compose up -d --build更专业的镜像级回滚给镜像打版本标签docker build -t fde-api:1.1 . # 新版 docker build -t fde-api:1.0 . # 旧版标签还在 # compose 里镜像写 fde-api:1.0 就能切回或者 up 时指定场景 E彻底清理与重建docker compose down # 删容器网络保留数据 docker compose up -d # 重建数据还在 docker compose down -v # ⚠️ 连数据卷一起删回到全新状态 docker compose up -d --build # 数据库会重新执行 init.sql 五、把项目推上 GitHub可选但推荐# 在 GitHub 新建空仓库 fde-deploy然后 git branch -M main git remote add origin https://github.com/你的用户名/fde-deploy.git git push -u origin main推之前最后检查一遍安全清单# 确认敏感文件没有被 Git 跟踪 git status git ls-files | grep -E \.env$|venv # 应该没有任何输出 交付安全红线.env、密码、密钥、客户数据绝不进 Git、绝不进镜像。用.env.example提供模板真实值通过环境变量在部署机注入。 本周复习知识地图Docker / Nginx / GitDay 41-45 │ ├─ Docker 入门Day 41 │ ├─ 容器 vs 虚拟机共享内核、秒级、MB 级 │ ├─ 镜像只读模板/类vs 容器运行实例/对象 │ ├─ docker pull/run/ps/stop/start/rm │ ├─ docker images/rmi/logs/exec/inspect │ ├─ -p 宿主机:容器端口映射 │ ├─ -v 宿主路径或卷:容器路径数据持久化 │ └─ --restart unless-stopped │ ├─ DockerfileDay 42 │ ├─ FROM/WORKDIR/COPY/RUN/ENV/EXPOSE/CMD │ ├─ RUN 构建时执行 vs CMD 运行时执行 │ ├─ 分层镜像与层缓存某层变其后全失效 │ ├─ 排序系统→依赖→代码依赖层放代码前 │ ├─ .dockerignore排除 venv/.env/.git │ ├─ docker build -t 名:版本 . │ └─ 服务必须监听 0.0.0.0 │ ├─ Docker ComposeDay 43 │ ├─ docker-compose.yml 声明式编排 │ ├─ servicesimage/build/ports/volumes/environment │ ├─ depends_on healthcheck启动顺序 vs 真正就绪 │ ├─ 服务名即主机名内置 DNS容器互访用内部端口 │ ├─ 命名卷持久化initdb.d 自动初始化 │ ├─ env_file / ${VAR:-default} 配置外置 │ └─ up -d --build / down / logs / ps / exec │ ├─ Nginx GitDay 44 │ ├─ 正向 vs 反向代理 │ ├─ listen 80 proxy_pass proxy_set_header │ ├─ upstream 负载均衡轮询/权重/ip_hash │ ├─ 容器内转发用服务名 api:8000 │ ├─ nginx -t 测试后 reload │ ├─ Git 三区工作区/暂存区/版本库 │ ├─ init/status/add/commit/log/diff │ ├─ branch/checkout -b/merge/-d │ ├─ remote/push -u/pull/clone │ └─ revert安全撤销/ reset --hard危险 │ └─ 综合实战Day 45 ├─ 规范目录结构 app/db/nginx ├─ 三容器nginx(80) → api → mysql(数据卷) ├─ 完整流水线提交→配置→构建→启动→验证 ├─ 更新部署只重建变动服务 ├─ 数据备份恢复、版本回滚 └─ 安全.env 不进 Git/镜像、api 不直接暴露 本周验收清单序号验收项达标标准1容器基础能解释容器与虚拟机、镜像与容器的区别2容器生命周期熟练 run/ps/stop/rm/exec/logs3端口与卷能正确使用 -p、-v说清数据为何能持久化4Dockerfile独立写出 FastAPI 的 Dockerfile 并 build 成功5层缓存能解释先拷 requirements的原因并验证缓存6.dockerignore能列出必须排除的文件及原因7Compose 编排能用 yml 一键起 apimysqlnginx8服务发现理解服务名即主机名会配置容器互访9就绪依赖会用 healthcheck condition 解决启动顺序10数据持久化down 后数据不丢能做 mysqldump 备份11Nginx80 端口能转发到 API改配置会 -t reload12安全姿态api 不对外暴露端口.env 不进镜像/Git13Git 基础init/add/commit/log/status 全流程14Git 分支能开 feature 分支开发并合并15Git 远程能 push/pull知道冲突怎么解16更新与回滚改代码后能重新部署也能回退旧版自评方式16 项里能独立做到 13 项以上 扎实通过。卡住的项目回到对应那一天把实操命令亲手再敲一遍——容器化是手上功夫看懂和做通之间隔着至少三遍练习。 本周收官你获得了什么五天前 现在 ────── ──── 部署 在一台机器上手动装环境 部署 一条 docker compose up 在我电脑上能跑 镜像在哪跑都一样 代码靠复制文件夹备份 Git 提交历史 分支 远程 多个服务要分别手动启动 一个 yml 声明整套系统 服务裸奔在各种端口 Nginx 统一门面80 端口进入 改完代码靠口头通知重启一下 up -d --build 标准化更新把本周放进整个第二阶段的版图里看你的技术栈已经相当完整第2周写得出 APIFastAPI 第3周存得下数据SQL / MySQL / pandas 第4周管得住服务器Linux / Shell / 定时/自愈 第5周交付得了环境Docker / Compose / Nginx / Git ┌─────────────────────────────────────────────┐ │ 你已经能独立交付一个容器化的后端服务 │ │ 代码版本化 → 镜像化 → 编排 → 反向代理 → │ │ 数据持久化 → 可更新可回滚 │ └─────────────────────────────────────────────┘这正是初级 FDE / 后端实施工程师的核心交付能力。你在客户现场听到环境部署、容器化改造、服务上线心里已经有完整的操作地图了。 下周预告API 集成与系统对接第二阶段最后一周地基数据、服务器、部署全部打完最后一周回到 FDE 最贴近业务的主题——让你的系统和客户的系统对话RESTful 规范 认证授权JWT、API Key保护你的接口不被乱调对接企业 IM调用飞书/钉钉开放 API获取 token、发消息、读通讯录Webhook 事件回调客户系统有事件发生时主动通知你接收验签幂等处理数据映射在不同系统的字段格式之间做翻译OpenAPI 文档 pytest 测试收官综合项目一个飞书消息 → Webhook → 工单入库 → API 查询的完整联动系统学完下周第二阶段 30 天全部收官你将拥有从写代码、管数据、部署服务到对接外部系统的完整闭环。周末好好休整下周冲刺附录前置课程列表阶段一认知启蒙AI 认知与 FDE 角色AI 认知【FDE系列】阶段1Day 1AI 层级关系 — 四个嵌套的圈-CSDN博客【FDE系列】阶段1Day 2AI 三阶段发展史 — 会认 → 会判断 → 会创造-CSDN博客【FDE系列】阶段1Day 3符号 AI vs 机器学习 — 两条路线的本质区别-CSDN博客【FDE系列】阶段1Day 4Transformer 的历史意义 — 2017 年的分水岭-CSDN博客【FDE系列】阶段1Day 5本周复习与自测 — 检验你的 AI 认知地基-CSDN博客【FDE系列】阶段1Day 6Transformer 架构 — 一张图纸盖出千千万万栋楼-CSDN博客【FDE系列】阶段1Day 7LLM 本质 — 文字接龙机器-CSDN博客【FDE系列】阶段1Day 8Token — 模型眼中的最小单位-CSDN博客【FDE系列】阶段1Day 9AI 幻觉 — 为什么会一本正经地胡说八道-CSDN博客【FDE系列】阶段1Day 10上下文窗口 — 模型的记忆力上限 本周复习-CSDN博客【FDE系列】阶段1Day 11Prompt — 给模型立规矩-CSDN博客【FDE系列】阶段1Day 12Memory — 让模型记住上下文【FDE系列】阶段1Day 13RAG — 给模型配图书管理员-CSDN博客【FDE系列】阶段1Day 14Tool Use — 让模型动手操作-CSDN博客【FDE系列】阶段1Day 15MCP — 统一的工具接口标准 第三周复习-CSDN博客FDE 基础概念【FDE系列】阶段1Day 16什么是 FDE — 把 AI 变成客户结果的人-CSDN博客【FDE系列】阶段1Day 17FDE vs 传统实施 — 三大本质区别-CSDN博客【FDE系列】阶段1Day 18FDE 三重身份 C6 胜任力模型-CSDN博客【FDE系列】阶段1Day 19七阶段行动路径 行业经验的价值-CSDN博客【FDE系列】阶段1Day 20阶段总结与产出物 — 第一阶段收官-CSDN博客阶段二技术地基Python FastAPI SQL Docker API 集成Python基础【FDE系列】阶段2Day 21Python 环境搭建 — 写出你的第一行代码-CSDN博客【FDE系列】阶段2Day 22变量、数据类型、条件判断 — Python 的“记忆“和“判断“-CSDN博客【FDE系列】阶段2Day 23循环与函数 — 让代码跑 100 遍、把逻辑打包复用-CSDN博客【FDE系列】阶段2Day 24数据结构 — 列表、字典、集合、元组-CSDN博客【FDE系列】阶段2Day 25文件读写与 JSON — 让程序连通外部数据第一周收官-CSDN博客【FDE系列】阶段2Day 26模块化编程 — 把代码拆成“抽屉柜“-CSDN博客【FDE系列】阶段2Day 27异常处理与日志 — 让程序“摔不烂、查得到“-CSDN博客FastAPI入门到进阶【FDE系列】阶段2Day 28FastAPI 入门 — 把你的函数变成 API 服务-CSDN博客【FDE系列】阶段2Day 29FastAPI 进阶 — Pydantic 模型与完整 CRUD 实战-CSDN博客【FDE系列】阶段2Day 30生产代码规范 — 测试、类型注解、配置管理第二周收官-CSDN博客SQL基础【FDE系列】阶段2Day 31SQL 基础 — 增删改查一把梭-CSDN博客【FDE系列】阶段2Day 32多表查询 — JOIN 与聚合-CSDN博客【FDE系列】阶段2Day 33进阶查询 — 窗口函数与 CTE-CSDN博客【FDE系列】阶段2Day 34数据清洗 — 把脏数据捋干净-CSDN博客【FDE系列】阶段2Day 35Python SQL — 工单接入 MySQL 本周收官-CSDN博客Linux基础【FDE系列】阶段2Day 36Linux 入门与文件操作 — 扔掉鼠标的第一天-CSDN博客【FDE系列】阶段2Day 37权限、进程与文本三剑客-CSDN博客【FDE系列】阶段2Day 38Shell 脚本 — 把命令串起来自动跑-CSDN博客【FDE系列】阶段2Day 39Linux 综合实战 — 让服务无人值守-CSDN博客【FDE系列】阶段2Day 40Shell 进阶 — 生产级脚本与本周收官-CSDN博客Docker【FDE系列】阶段2Day 41Docker 入门 — 把环境装进盒子-CSDN博客【FDE系列】阶段2Day 41up详细版Docker 入门 — 把环境装进盒子-CSDN博客【FDE系列】阶段2Day 42Dockerfile 实战 — 把你的应用打包成镜像-CSDN博客【FDE系列】阶段2Day 42UP详细版Dockerfile 实战 — 把你的应用打包成镜像-CSDN博客【FDE系列】阶段2Day 43Docker Compose — 多容器一键编排-CSDN博客【FDE系列】阶段2Day 43UP详细版Docker Compose — 多容器一键编排-CSDN博客【FDE系列】阶段2Day 44Nginx 反向代理 Git 版本控制-CSDN博客【FDE系列】阶段2Day 44UP详细版Nginx 反向代理 Git 版本控制-CSDN博客
