Skip to content

第 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 十二项清单 ​

左边是"我这儿能跑",右边是"别人能用"本地:能跑线上:能交付① 进程随终端活着① 进程被守护,崩了自动起② 127.0.0.1 只有自己能连② 域名 + HTTPS,公网可达③ 开了 reload,改就生效③ 生产配置,密钥不进仓库④ SQLite 文件就在本机④ 数据有备份,能演恢复⑤ 端口 8000 直连⑤ 反向代理,只暴露 80/443⑥ 崩了看终端日志⑥ 日志落盘、轮转、可检索⑦ 出问题你知道⑦ 指标与告警,出事有人通知⑧ 手动 git pull 更新⑧ 自动发布,失败能回滚⑨ 重启靠 Ctrl+C⑨ 停机时间可控,有发布顺序⑩ 库表结构随便改⑩ 迁移与代码可兼容、可回退⑪ 没人刷你的接口⑪ 限流与配额,防滥用与烧钱⑫ 不计成本,自己掏⑫ 单位成本可算,知道盈亏十二项里,真正贵的不是机器,而是 ⑦⑧⑩⑪ ——没有它们,第一次出事就是最后一次机会。

清单不用背,它有三个用途:

  1. 排期:一眼看出还差几项,估个工期;
  2. 验收:上线前逐条打勾,缺一项就说明有个坑还没填;
  3. 砍范围:小项目可以先不做 ⑪⑫,但 ⑦⑧⑩ 不能省。

1.3 三笔隐性成本 ​

成本具体是什么常见低估程度
钱服务器、带宽、域名、证书、模型调用、对象存储只算了服务器月租,没算流量与调用
时间部署脚本、排障、证书续期、备份检查、告警响应以为"部署一次就完了"
信任数据泄露、长时间宕机、账单暴涨、被刷接口觉得"我这种小站没人盯"

第三笔最容易忽视,也最贵:一次数据事故的代价,往往超过一年的服务器开销。


1.4 这六件事的顺序 ​

顺序不能反:

  • 先机器后域名:没有机器,解析到哪都无从谈起;
  • 先发布后自动化:手工都跑不通,写自动化脚本只会把错误固化;
  • 先观测后优化:看不见指标时,"优化"全是猜;
  • 备份放在观测之后:因为备份是否有效,要靠监控来验证(备份任务失败而不报警,等于没备)。

1.5 一个真实的时间预算 ​

按个人项目的量级给个参考(不是精确工期,是量级):

阶段一次性投入之后每月维护
机器与安全基线半天偶尔打补丁
域名与证书2 小时(+备案等待)证书自动续,几乎为零
打包发布1 天每次发布 3 分钟
自动发布半天到 1 天几乎为零
观测与告警半天每周扫一眼
备份半天(含恢复演练)每月验证一次
成本核算2 小时每月 30 分钟对账

合计约三到四天的一次性投入。这笔钱花下去之后,你的项目才从"我的一个 demo"变成"一个能给别人用的东西"。


1.6 本课的边界 ​

讲不讲
一台机器、一个域名、一条发布链路多云架构、K8s 集群
单机 Docker + Compose 的运维大规模水平扩展
个人/小团队的预算与流程企业级 SRE 体系
云厂商"该买什么"的判断控制台的点选教程(界面半年一变)

判断标准:这套东西一个人能维护得住。真到需要值班表的时候,那是另一门课。


本章小结 ​

要点说明
本质给本地运行的隐含前提补上显式保障
清单十二项,可排期、可验收、可砍范围
三笔成本钱、时间、信任,信任最贵
顺序机器 → 域名 → 发布 → 观测 → 备份 → 成本
工期一次性三到四天,之后每月几十分钟
边界一个人维护得住

下一章 ​

从一台空机器开始:规格怎么估、系统怎么配、国内服务器绕不开的备案怎么走。

本文阅读--次|全站访问--次|访客--人