console-ui：把「線上跑的是不是當代的」變成機械判準，並接進部署鏈
leo 2026-08-08：「已經發生過一次這個錯誤，把舊版界面上到 prod， 你要確定不可再犯。」 實測（repo 對線上，純文字資產比對）： repo portal/index.html 343,969 bytes 線上 mira.uncle6.me 82,911 bytes（Songti 12 處，舊金色 serif 品牌） 線上 pages.dev 82,911 bytes（同上） 而e730b3f那版 verify-live 對這兩站**三項檢查全過**——因為它驗的是 組態（apiBase、profile 的 views/home），不是世代。 ⇒ 一個網址可以組態完全正確、卻對外展示一套早就被淘汰的介面， 而所有機械檢查都說它是綠的。這就是要消滅的狀態。 本次落地： 一、世代指紋（targets.mjs） 逐一取線上／產物的資產（index / portal / console / favicon.svg）， 遮掉本來就該隨部署目標不同的那兩行（VIEWS/HOME），其餘按位元組比對。 刻意不用關鍵字清單——清單要人維護，而舊世代能無聲上線正是因為沒人記得維護它。 誠實 trade-off 寫在檔內：repo 改了沒部署就會判紅，那是正確的（那時線上確實不當代）。 二、宣告值真的寫進產物（收掉e730b3f標的 WIP） deploy.mjs 改為由 targets.mjs 產出 .staging/<目標> 再推： config.js 由宣告值即時產生、console 的 VIEWS/HOME 依 profile 覆寫， **覆寫沒命中就中止部署**；推之前回頭讀磁碟上那份驗一次（不看腳本印了什麼）。 public/config.js 刪除——它是產物不是原始碼。 三、修好一道從 08-03 起就在誤判的閘 t160 的世代閘比對 portal 全文含「登記新庫」即拒部，而 66f1b59（08-03） 加了一則**說明「已經把它拿掉了」的 HTML 註解** ⇒ 該閘自那天起每次誤判， npm run deploy:personal 連續五天推不出去。改成剝掉註解後只看可見內容， 並降級為輔助（主判準是指紋）。這正是「手工關鍵字閘會腐爛」的實例。 四、讓它在該跑的時候真的被跑到（不再生出沒人記得執行的腳本） · deploy.mjs 推完自動回頭驗線上，不過就算本次部署失敗 · .deploy-state.json 只在線上實測通過後才寫，且不進版控 （新 checkout 沒紀錄＝狀態未知＝該被提醒，而不是繼承別人的綠燈） · Stop hook 每回合離線比對「手上這一代 vs 最後一次驗過的部署」， 在要說「做完了」的那一刻出聲（實測 0.096s，不連網） 五、uncle6 邊界寫進工具本身（leo 08-08：「要看範例只在 youlin 網站，不要去碰 uncle6」） deploy.targets.json 的 enterprise 標 frozen：deploy 拒絕部署、verify 連抓都不抓。 目標本身保留不刪——刪掉就變成下一個 AI 眼中「從來沒有過這個站」的失憶。 同源清掉兩處還活著的舊記錄：README 的線上 demo 連結、public/index.html 的註解。 驗收證據見 commit 後的實測輸出（舊世代樣本取自 git 歷史 ad367e4，本機起站餵判準， 未碰任何線上資源）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
uncle6me-web
@@ -1,60 +1,108 @@
|
||||
/**
|
||||
* deploy.mjs — 依具名目標部署 console-ui 到 Cloudflare Pages
|
||||
*
|
||||
* 用法：npm run deploy:personal / npm run deploy:enterprise
|
||||
* 用法：npm run deploy:personal
|
||||
* npm run deploy:personal -- --dry-run （只產出並驗產物，不推）
|
||||
*
|
||||
* 為什麼不直接用 `wrangler pages deploy`（2026-07-22 leo 立，實際踩到才補）：
|
||||
* **兩個帳號都有名為 arcrun-console-ui 的 Pages 專案**
|
||||
* · leo21c → arcrun-console-ui.pages.dev（個人版 console）
|
||||
* · uncle6 → 綁 rag-demo.arcrun.dev（企業版 demo 站）
|
||||
* wrangler 若 OAuth 登入在 uncle6，`--project-name arcrun-console-ui` 會部到 demo 站上。
|
||||
* wrangler 若 OAuth 登入在別的帳號，`--project-name arcrun-console-ui` 會部到別人的站上。
|
||||
* 本腳本強制帶目標的 accountId，並在部署前印出目標，避免部錯帳號。
|
||||
*
|
||||
* 同時把 profile/apiBase 綁進目標（deploy.targets.json），不再靠部署者記得帶環境變數——
|
||||
* 帶漏過三次：demo 站漏 profile=rag 顯示成個人版、兩站漏 apiBase 導致登入 405。
|
||||
* 帶漏過三次：漏 profile 顯示成錯的版本、漏 apiBase 導致登入 405。
|
||||
*
|
||||
* 🔴 三道閘，全部**讀磁碟上真的要被推的那份**，不看本腳本自己印了什麼
|
||||
* （2026-08-08 事故的形狀正是「印的是 A、推的是 B」）：
|
||||
* ① 產物閘 ：宣告值有沒有真的寫進產物（apiBase / VIEWS / HOME）
|
||||
* ② 世代閘 ：產物是不是當代（指紋＋t160 的文字指紋）
|
||||
* ③ 線上閘 ：推完回頭抓線上，組態＋世代都要對上，否則本次部署算失敗
|
||||
* 三閘都過才寫 .deploy-state.json（那份紀錄是「經過線上實測」的意思，不是「我跑過指令」）。
|
||||
*/
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { join } from 'node:path';
|
||||
import { ROOT, assertArtifact, buildArtifact, loadTargets, resolveTarget, writeState } from './targets.mjs';
|
||||
import { printReport, verifyTarget } from './verify-live.mjs';
|
||||
|
||||
const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
|
||||
const targets = JSON.parse(readFileSync(join(ROOT, 'deploy.targets.json'), 'utf8'));
|
||||
const names = Object.keys(targets).filter((k) => !k.startsWith('_'));
|
||||
const args = process.argv.slice(2);
|
||||
const dryRun = args.includes('--dry-run');
|
||||
const name = args.find((a) => !a.startsWith('--'));
|
||||
|
||||
const name = process.argv[2];
|
||||
if (!name || !targets[name]) {
|
||||
console.error(`用法：npm run deploy:<target>\n可用目標：${names.join(' / ')}`);
|
||||
if (name) console.error(`（收到未知目標："${name}"）`);
|
||||
let t;
|
||||
try {
|
||||
if (!name) throw Object.assign(new Error('沒有指定部署目標'), { usage: true });
|
||||
t = resolveTarget(name);
|
||||
} catch (e) {
|
||||
console.error(`✘ ${e.message}`);
|
||||
if (e.usage) console.error(`用法：npm run deploy:<target>\n可用目標：${loadTargets().active.join(' / ')}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
if (t.frozen) {
|
||||
console.error(`✘ 目標 ${name} 已凍結，拒絕部署。\n ${t.frozen}`);
|
||||
console.error(' （要解凍是人的決定：改 deploy.targets.json 拿掉 frozen 欄位，並說明理由。）');
|
||||
process.exit(1);
|
||||
}
|
||||
const t = targets[name];
|
||||
|
||||
console.log(`\n部署目標：${name}`);
|
||||
console.log(` 說明 ：${t.description}`);
|
||||
console.log(` 帳號 ：${t.accountId}`);
|
||||
console.log(` 專案 ：${t.projectName}`);
|
||||
console.log(` profile ：${t.profile}`);
|
||||
console.log(` apiBase ：${t.apiBase}\n`);
|
||||
console.log(` apiBase ：${t.apiBase}`);
|
||||
|
||||
const env = { ...process.env, DEPLOY_TARGET: name, CLOUDFLARE_ACCOUNT_ID: t.accountId };
|
||||
|
||||
// t160（leo 07-31：「如果你會搞不清楚，就把錯的東西刪掉」）：build 步驟已隨舊世代
|
||||
// src/ 一起 git rm——public/ 是唯一世代真身（手改演進），deploy＝直接託管它。
|
||||
// 病史：src/（舊代 renderer 快照）與 public/（新代真身）並存，deploy 自動跑 build
|
||||
// 從舊 src 重產 public ⇒ 任何一次部署都可能把 UI 打回舊世代（07-27 記帳、07-31 引爆：
|
||||
// t159 重打包用了舊 public 的分支副本，leo 刷新看到被淘汰的「登記新庫」表單）。
|
||||
// 世代閘：部署前驗 public 指紋，舊世代（缺新文案／含人工建庫表單）直接拒部。
|
||||
const portalHtml = readFileSync(join(ROOT, 'public', 'portal', 'index.html'), 'utf8');
|
||||
if (!portalHtml.includes('不需要人工新增') || portalHtml.includes('登記新庫')) {
|
||||
console.error('✘ 世代閘：public/portal/index.html 不是現行世代（缺「不需要人工新增」或含「登記新庫」）——拒絕部署舊 UI。');
|
||||
// ── ①② 產出 + 驗產物 ────────────────────────────────────────────────
|
||||
const outDir = join(ROOT, '.staging', name);
|
||||
try {
|
||||
buildArtifact(t, outDir);
|
||||
} catch (e) {
|
||||
console.error(`\n✘ 產出失敗：${e.message}`);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const gate = assertArtifact(t, outDir);
|
||||
console.log(`\n產物：${outDir}`);
|
||||
console.log(` 世代指紋：${gate.generation.slice(0, 12)}`);
|
||||
if (!gate.ok) {
|
||||
console.error('\n✘ 產物閘不通過——推上去的會跟宣告的不一樣，拒絕部署：');
|
||||
for (const p of gate.problems) console.error(` · ${p}`);
|
||||
process.exit(1);
|
||||
}
|
||||
console.log(' ✅ 產物閘：宣告值確實寫進產物，且是當代。');
|
||||
|
||||
if (dryRun) {
|
||||
console.log('\n（--dry-run：到此為止，沒有推任何東西。）');
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
// ── 推 ───────────────────────────────────────────────────────────────
|
||||
const env = { ...process.env, DEPLOY_TARGET: name, CLOUDFLARE_ACCOUNT_ID: t.accountId };
|
||||
// --commit-dirty：本地部署常有未提交變更，不因此中斷
|
||||
const deploy = spawnSync(
|
||||
'npx',
|
||||
['wrangler', 'pages', 'deploy', 'public', '--project-name', t.projectName, '--commit-dirty=true'],
|
||||
['wrangler', 'pages', 'deploy', outDir, '--project-name', t.projectName, '--commit-dirty=true'],
|
||||
{ stdio: 'inherit', cwd: ROOT, env },
|
||||
);
|
||||
process.exit(deploy.status ?? 1);
|
||||
if (deploy.status !== 0) {
|
||||
console.error('\n✘ wrangler 部署失敗。');
|
||||
process.exit(deploy.status ?? 1);
|
||||
}
|
||||
|
||||
// ── ③ 線上閘 ─────────────────────────────────────────────────────────
|
||||
console.log('\n── 回頭驗線上（組態＋世代）──');
|
||||
const report = await verifyTarget(name, { wait: true });
|
||||
printReport([report]);
|
||||
if (!report.ok) {
|
||||
console.error('\n✘ 推上去了，但線上跑的 ≠ 我們手上這一份。**本次部署視為失敗**。');
|
||||
console.error(' （wrangler 說成功不代表對外網址就對——這正是要被擋掉的那個病。）');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
writeState(name, {
|
||||
generation: gate.generation,
|
||||
apiBase: t.apiBase,
|
||||
profile: t.profile,
|
||||
urls: t.verifyUrls,
|
||||
verifiedAt: new Date().toISOString(),
|
||||
});
|
||||
console.log('\n✅ 部署完成，且線上實測＝宣告值＋當代世代。已記入 .deploy-state.json。');
|
||||
|
||||
Reference in New Issue
Block a user