這系列在做什麼(白話)
2026-11-15 出 1.32.0/Agent 1.7.10,主系統按了 8 次、Agent 2 次,從下午拖到晚上九點半才發完,期間沒有一件是產品程式的錯,全是出版流程與環境的問題,而且大部分開跑前花幾分鐘唯讀檢查就看得到。這系列把今天撞過的每一類問題,改成「開跑前就擋下」或「紅了不用從頭重跑」。
為什麼要做
- 最嚴重的一件:這版換簽章鑰匙(Vault → KMS),但現場舊版只認舊章,用新章發出去客戶收不到。讀程式十幾分鐘就查得到,沒在開跑前查。
- 主機狀態:188、190 裝了新核心沒重開,installer 預檢擋升級,各撞一次;Agent 測試跟主系統編譯在同一台同時跑,測試被鎖紅掉。
- 演練腳本與名單是舊的:第一次拿 1.30.0 以後的機器當演練來源,讀加密鑰兩處舊寫法、允許變多的表名單漏 4 張,各撞一次,每次都要等編譯+打包 30 分鐘才看到。
- 正式線才跑的檢查:預檢網址打錯一層(bats 假 curl 不看網址沒抓到)、套件弱點白名單只複查了一層。
- 更新中心訊息誤導:驗章不過、下載被擋都顯示「連不到原廠更新站」,排查方向全錯。
怎麼拆
- 批 1(5 張,互不衝突,今晚跑):出版前檢查腳本、更新中心錯誤訊息分開、Agent 測試開庫一致、bats 斷言網址形狀、version-bump skill 補教訓。
- 批 2(暫緩,決策者看過批 1 再放):SQL 提前到 verify 套 STG 資料並比筆數、CI 守衛前同步 188 venv(兩張改的檔不重疊)。
- 批 3(暫緩):允許變多名單改從 migration 推(跟批 2 SQL 提前同改 deploy_rehearse.sh,要等它合回)、Agent 的 UPDATE_CENTER_REF 改成 pipeline 參數(BE 已有 uc_ref)。
不在這系列(要先設計或要人手)
- 下載網址改用自己的固定網域/更新站依客戶版本給不同的桶:桶在公司 Cloudflare、網域在個人帳號,自訂網域要同帳號,架構先定。
- 紅了只重跑後段、編譯快取不被版號打掉;build 機與 STG 分開、一次只跑一個 job:動 pipeline 結構與機器。
- 下一版改 KMS 簽(拿掉 SIGN_BACKEND/MANIFEST_SIGN_URL):等現場 Agent 都升到 1.7.10。舊安裝包章私鑰匯入 KMS、Vault 與 189 退役、更新站切回新桶:人手。
共同紀律
- 全部子卡只改程式與測試,不碰任何環境(STG/POC/190/雲端版/GCP/更新站/Vault),不跑正式 pipeline。
相關座標
- FR-197.1 交接紀錄:docs/features/FR-197-2611-gcp-handover-infra/handoff/FR-197.1-LOG.md 第 5 棒三個 block(教訓 ⑬~⑳)與 STATE「出版棒現況」。