第10章 部署上线

第10章 部署上线

章节摘要：部署是项目生命周期的分水岭：开发环境的便利配置在此全部翻转为生产姿态——密钥进环境变量、调试关闭、静态文件收集、应用服务器与反向代理分工。本章讲生产配置清单、Gunicorn 与 Nginx 的协作拓扑、以及可重复可回滚的发布流程。

学习目标

1. 完成生产配置清单的逐项切换
2. 解释 Gunicorn 与 Nginx 的分工与协作拓扑
3. 组织可重复的发布流程：拉代码、迁移、收集静态、重启
4. 为回滚与首发验证做好准备

核心概念速览

开发服务器是给你看的，生产栈是给用户扛的——两层翻译缺一不可。

项目当前状态

测试全绿。本章执行墨迹博客的首发：一台 Linux 服务器，PostgreSQL 数据库，Gunicorn 加 Nginx。

首次部署在项目生命周期里是个仪式感很强的节点——从这一刻起，你的代码不再只属于自己：真实用户开始访问，错误开始产生真实代价，配置的每一处随意都可能变成凌晨的告警。本章会给你一份生产配置的对照清单，把开发期为了方便而敞开的大门逐一关上。请放慢速度逐项核对，首次部署多花一小时，换来的是上线后少熬几个通宵。

子章节导航

10.1 生产环境与服务器配置

配置切换清单、数据库更换、Gunicorn 与 Nginx 的配置与分工。

10.2 部署流程与最佳实践

发布四步曲、环境变量管理、回滚预案、发布验证清单。

子章节之间的逻辑关系

生产姿态就绪（10.1 配置与拓扑）
        |
        v
发布形成流程（10.2 四步曲与回滚）──> 第11章 上线后的性能维护
​

前置知识与后续延伸

• 前置：第 1 章配置文件结构、第 2 章迁移、第 5 章静态文件。
• 为后续铺垫：发布流程是第 11、12 章持续维护与再发布的载体。

部署完成后项目并未"完结"，恰恰相反——本章建立的发布四步曲会在此后每次迭代中反复执行，它的顺滑程度直接决定团队后续一两年的迭代节奏，值得一次做到位。