第 1 章:上线清单:从"能跑"到"能交付"
在自己电脑上
uvicorn main:app跑通,和"别人打开网址就能用",中间隔着十二件事。先把清单摆出来,你就知道钱和时间该花在哪。
学习目标
- 说出本地能跑 ≠ 线上可用的六个差别
- 拿到一张十二项的上线清单,能对照自己的项目逐条打勾
- 知道上线真正贵在哪:不是服务器,是三笔隐性成本
- 建立本课的推进顺序:机器 → 域名 → 发布 → 观测 → 备份 → 成本
1.1 本地的"能跑"意味着什么
bash
uvicorn main:app --reload
# INFO: Uvicorn running on http://127.0.0.1:8000它成立的前提有一整套,只是你平时没注意:
| 隐含前提 | 线上是否还成立 |
|---|---|
| 服务只跑一次,不会崩 | 不成立——它会崩,还要自己起来 |
| 只有一个用户(你) | 不成立——并发、扫描器、爬虫都会来 |
| 数据库就是本机那个文件 | 不成立——数据要备份、要能恢复 |
--reload 改了代码就生效 | 不成立——线上不能开 reload |
| 端口 8000 直连 | 不成立——要走 443,要有域名和证书 |
| 端口只在本机监听 | 不成立——暴露到公网就等于开门 |
上线的本质,是给这些"隐含前提"逐条补上显式保障。
1.2 十二项清单
清单不用背,它有三个用途:
- 排期:一眼看出还差几项,估个工期;
- 验收:上线前逐条打勾,缺一项就说明有个坑还没填;
- 砍范围:小项目可以先不做 ⑪⑫,但 ⑦⑧⑩ 不能省。
1.3 三笔隐性成本
| 成本 | 具体是什么 | 常见低估程度 |
|---|---|---|
| 钱 | 服务器、带宽、域名、证书、模型调用、对象存储 | 只算了服务器月租,没算流量与调用 |
| 时间 | 部署脚本、排障、证书续期、备份检查、告警响应 | 以为"部署一次就完了" |
| 信任 | 数据泄露、长时间宕机、账单暴涨、被刷接口 | 觉得"我这种小站没人盯" |
第三笔最容易忽视,也最贵:一次数据事故的代价,往往超过一年的服务器开销。
1.4 这六件事的顺序
顺序不能反:
- 先机器后域名:没有机器,解析到哪都无从谈起;
- 先发布后自动化:手工都跑不通,写自动化脚本只会把错误固化;
- 先观测后优化:看不见指标时,"优化"全是猜;
- 备份放在观测之后:因为备份是否有效,要靠监控来验证(备份任务失败而不报警,等于没备)。
1.5 一个真实的时间预算
按个人项目的量级给个参考(不是精确工期,是量级):
| 阶段 | 一次性投入 | 之后每月维护 |
|---|---|---|
| 机器与安全基线 | 半天 | 偶尔打补丁 |
| 域名与证书 | 2 小时(+备案等待) | 证书自动续,几乎为零 |
| 打包发布 | 1 天 | 每次发布 3 分钟 |
| 自动发布 | 半天到 1 天 | 几乎为零 |
| 观测与告警 | 半天 | 每周扫一眼 |
| 备份 | 半天(含恢复演练) | 每月验证一次 |
| 成本核算 | 2 小时 | 每月 30 分钟对账 |
合计约三到四天的一次性投入。这笔钱花下去之后,你的项目才从"我的一个 demo"变成"一个能给别人用的东西"。
1.6 本课的边界
| 讲 | 不讲 |
|---|---|
| 一台机器、一个域名、一条发布链路 | 多云架构、K8s 集群 |
| 单机 Docker + Compose 的运维 | 大规模水平扩展 |
| 个人/小团队的预算与流程 | 企业级 SRE 体系 |
| 云厂商"该买什么"的判断 | 控制台的点选教程(界面半年一变) |
判断标准:这套东西一个人能维护得住。真到需要值班表的时候,那是另一门课。
本章小结
| 要点 | 说明 |
|---|---|
| 本质 | 给本地运行的隐含前提补上显式保障 |
| 清单 | 十二项,可排期、可验收、可砍范围 |
| 三笔成本 | 钱、时间、信任,信任最贵 |
| 顺序 | 机器 → 域名 → 发布 → 观测 → 备份 → 成本 |
| 工期 | 一次性三到四天,之后每月几十分钟 |
| 边界 | 一个人维护得住 |
下一章
从一台空机器开始:规格怎么估、系统怎么配、国内服务器绕不开的备案怎么走。