Lesson 08 · 发版

发布链路：两种任务，一道闸门

这是副作用最重的一条链。写正文之前必须先有一个可以安全操作的环境。

为什么排在这个位置

发版是这个岗位最不能出错的一件事 —— 它同时动本地磁盘、远端仓库和构建服务器，而且没有回滚按钮。

排在最后第二位，是因为它需要前面所有课的基础：进程边界（子进程干活）、请求链路（Jenkins API）、凭据（课 07）、状态（任务队列）。

前置

• 课 07 —— 没有凭据，这一课的所有操作都是空的
• 架构图 FIG.05 —— 分叉结构已经画好了
• 以及：一个明确的「可以安全操作」答复。在此之前只读代码不动手

会讲什么

1. 发布页的卡片是怎么来的。src/api/task/index.ts 的 DevCardList() / ResCardList() / ProdCardList() / AlphaCardList()，每张卡片带 type（SVN 还是 Jenkins）
2. 全局闸门。views/Option/index.vue:89-111 —— 任何构建在跑，所有卡片都点不动，包括纯本地的 SVN 提交
3. SVN 支路。complieproject_svn() 列改动 → FileRestoreDialog.vue 逐个勾选 → svnCommit()。这条有确认步骤，相对安全
4. Jenkins 支路。startBuild() 触发 → taskStore 记一笔 → checkstartBuild() 轮询。没有确认步骤，点了就走
5. Jenkins 封装的四块。utils/extend/jenkins/ 的 client / build / monitor / config —— 这是项目里分层最整齐的一处，值得当范本
6. job 名是怎么算出来的。JOB_TYPES 里的默认名 → initEnv() 的渠道替换 → getJobOptions() 的覆盖
7. 失败怎么停。stopBuild(jobName, buildNumber)、重新登录重置 taskStore、以及「Jenkins 那边已经结束但客户端还在转」的处理顺序
8. 三档评级。jenkins 模块的分层（✅）、全局闸门（⚠️ 粒度太粗但可理解）、裸 setInterval 无超时上限（❌）、Jenkins 型无二次确认（❌）

学完之后你应该能

• 能独立走完一次发版，并说清每一步动了什么、失败了怎么停
• 拿到「发布卡住了」的报障，能按固定顺序排查而不是瞎猜
• 能判断一个发布需求该加成 SVN 型还是 Jenkins 型
• 知道哪些操作是不可逆的，动手前该跟谁确认

在正文出来之前，你可以先做这些

• 只读，不点。打开 /expert/release，把页面上的卡片和 src/api/task/index.ts 里的定义一一对上
• 把 views/Option/index.vue 的 compileProject() 读完（大约 45 行），画出它的分支
• 读 src/utils/extend/jenkins/ 四个文件 —— 加起来不长，是好代码的样本
• 把「发布失败后的停止、重试、回滚流程」问出去。这是流程知识，代码里没有答案