console-ui 部署：宣告值只解讀一次，並補上線上實況驗證（WIP）
同源於 2026-08-08 的 apiBase 事故：部署腳本把 apiBase/profile 印在 終端機上，卻沒有寫進推上去的產物 ⇒ 印對的、推錯的。 根因比想像深：deploy.targets.json 原本靠 build.mjs 在 build 期把 profile/apiBase 烤進產物，但 t160（e744ad1）清世代債時把 build.mjs 整支刪掉改成直接託管 public/，沒有人接手「把宣告值寫進產物」這件事 ⇒ 前兩次事故的解等於被還原，只剩下「印出來給人看」。 本次落地： - targets.mjs：宣告值的唯一讀取點，把「一個目標展開成期望的產物長相」 定死成函式，供部署／驗證共用同一個答案，杜絕三邊各自解讀而漂移。 缺 apiBase／accountId／verifyUrls／未定義的 profile 一律拒絕部署。 - verify-live.mjs：獨立可跑，驗「線上網址真的在用的組態」＝「宣告值」。 - deploy.targets.json：補 _profiles（profile → views/home）與 verifyUrls。 WIP：deploy.mjs 尚未改接 targets.mjs，public/config.js 尚未退役。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
uncle6me-web
@@ -1,22 +1,53 @@
|
||||
{
|
||||
"_readme": [
|
||||
"部署目標定義檔（leo 2026-07-22 立）。一個目標＝一組『帳號＋profile＋apiBase＋專案名』。",
|
||||
"部署目標定義檔（leo 2026-07-22 立）。一個目標＝一組『帳號＋profile＋apiBase＋專案名＋對外網址』。",
|
||||
"",
|
||||
"為什麼要這個檔：5a16484 把 UI 搬 CF Pages 後，這些值從 worker 環境變數變成 build 期參數。",
|
||||
"誰部署誰要記得帶 → 帶漏了就退回預設，而預設值對兩邊都不對。今天實際踩到的：",
|
||||
"為什麼要這個檔：5a16484 把 UI 搬 CF Pages 後，這些值從 worker 環境變數變成部署期參數。",
|
||||
"誰部署誰要記得帶 → 帶漏了就退回預設，而預設值對兩邊都不對。實際踩過的：",
|
||||
" · demo 站漏 CONSOLE_PROFILE=rag → 顯示個人版 7 頁駕駛艙（leo 看到『Mira 介面』的真因）",
|
||||
" · 兩站都漏 ARCRUN_API_BASE → apiBase 空字串 → 前端打自己回 405 → 登不進去",
|
||||
" · 兩個帳號有同名 arcrun-console-ui 專案，wrangler 又登入在 uncle6",
|
||||
" → 不指定帳號直接 deploy 會部到 demo 站上（差點蓋掉）",
|
||||
"",
|
||||
"🔴 第四次（2026-08-08 發現，同一種病換了形式）：",
|
||||
" 上面三次的『解』是 deploy.targets.json ＋ build.mjs 在 build 時把 profile/apiBase",
|
||||
" 烤進產物。但 t160（e744ad1）為了清世代債把 build.mjs 整支刪掉、改成直接託管 public/，",
|
||||
" **沒有人把『把宣告值寫進產物』這件事接手過去** ⇒ deploy.mjs 照樣在終端機印",
|
||||
" 『profile：full / apiBase：…leo21c…』，推上去的卻是 public/config.js 裡凍住的",
|
||||
" cypher.arcrun.dev ＋ 凍在 4 頁的 VIEWS。也就是說：",
|
||||
" **`npm run deploy:personal` 會把個人站的 API 打到企業 demo 的後端、頁面砍成 4 頁**，",
|
||||
" 而終端機從頭到尾顯示『成功』。（第三次的 accountId 是靠 env 傳的，倖存；前兩次的解等於被還原。）",
|
||||
"",
|
||||
" → 現在的規矩：**產物由 deploy.mjs 依本檔即時產生（staging 目錄），",
|
||||
" 推之前驗產物、推之後驗線上網址**。public/ 裡不再放任何跟目標有關的值。",
|
||||
" · public/config.js 已刪除——它是產物不是原始碼（自架站的 /config.js 由",
|
||||
" arcrun-rag 的 build-ui-bundle 動態產生，不吃這個檔）",
|
||||
" · public/console/index.html 的 VIEWS/HOME 只是本機 preview 的預設值，",
|
||||
" 部署時一律被 _profiles 覆寫，覆寫沒命中就中止部署",
|
||||
"",
|
||||
"版本差異（leo 2026-07-22 定調）：頁面都存在，由 profile 決定顯示哪些。",
|
||||
" personal(full) 個人版：7 頁全開，落地駕駛艙",
|
||||
" enterprise(rag) 企業版：只留 搜尋/工作流/設定/card，落地搜尋頁",
|
||||
" 未來擴充：個人版新用戶上限 1、知識庫權限不可用 → 加在對應目標的欄位裡，別再散進部署指令。",
|
||||
"",
|
||||
"用法：npm run deploy:personal / npm run deploy:enterprise"
|
||||
"用法：npm run deploy:personal / npm run deploy:enterprise",
|
||||
" npm run deploy:personal -- --dry-run （只產出並驗產物，不推）",
|
||||
" npm run verify （不部署，只驗線上各站現況＝宣告值）"
|
||||
],
|
||||
|
||||
"_profiles": {
|
||||
"full": {
|
||||
"description": "個人版：7 頁全開，落地駕駛艙",
|
||||
"views": ["cockpit", "search", "card", "workflows", "creds", "inbox", "settings"],
|
||||
"home": "cockpit"
|
||||
},
|
||||
"rag": {
|
||||
"description": "企業版：搜尋/card/工作流/設定，落地搜尋頁",
|
||||
"views": ["search", "card", "workflows", "settings"],
|
||||
"home": "search"
|
||||
}
|
||||
},
|
||||
|
||||
"personal": {
|
||||
"description": "leo 私人實例（原 Mira）。入口 mira.uncle6.me → leo21c worker。",
|
||||
"accountId": "51a01bfa2665bd7bc3fd080dc40cf3e1",
|
||||
@@ -24,6 +55,7 @@
|
||||
"profile": "full",
|
||||
"brand": "Arcrun",
|
||||
"apiBase": "https://arcrun-cypher-executor.leo21c.workers.dev",
|
||||
"verifyUrls": ["https://mira.uncle6.me", "https://arcrun-console-ui.pages.dev"],
|
||||
"limits": {
|
||||
"maxUsers": 1,
|
||||
"libraryPermissions": false
|
||||
@@ -37,6 +69,7 @@
|
||||
"profile": "rag",
|
||||
"brand": "Arcrun",
|
||||
"apiBase": "https://cypher.arcrun.dev",
|
||||
"verifyUrls": ["https://rag-demo.arcrun.dev"],
|
||||
"limits": {
|
||||
"maxUsers": null,
|
||||
"libraryPermissions": true
|
||||
|
||||
@@ -0,0 +1,68 @@
|
||||
/**
|
||||
* targets.mjs — 部署目標的唯一讀取點（deploy.mjs 與 verify-live.mjs 共用）。
|
||||
*
|
||||
* 存在的理由：宣告值（deploy.targets.json）只准被解讀一次。
|
||||
* 「部署時印在終端機的值」「寫進產物的值」「事後驗線上的值」若各自去讀、各自算，
|
||||
* 三者就會漂移——2026-08-08 那場事故的形狀正是「印的是 A、推的是 B」。
|
||||
* 這支把「一個目標展開成期望的產物長相」定死成一個函式，三邊共用同一個答案。
|
||||
*/
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { dirname, join } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
export const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
|
||||
|
||||
export function loadTargets() {
|
||||
const raw = JSON.parse(readFileSync(join(ROOT, 'deploy.targets.json'), 'utf8'));
|
||||
const profiles = raw._profiles;
|
||||
if (!profiles) throw new Error('deploy.targets.json 缺 _profiles（profile → views/home 對照）');
|
||||
const names = Object.keys(raw).filter((k) => !k.startsWith('_'));
|
||||
return { raw, profiles, names };
|
||||
}
|
||||
|
||||
export function resolveTarget(name) {
|
||||
const { raw, profiles, names } = loadTargets();
|
||||
const t = raw[name];
|
||||
if (!t) {
|
||||
const err = new Error(`未知的部署目標："${name}"。可用：${names.join(' / ')}`);
|
||||
err.usage = true;
|
||||
throw err;
|
||||
}
|
||||
const p = profiles[t.profile];
|
||||
if (!p) {
|
||||
throw new Error(
|
||||
`目標 ${name} 的 profile="${t.profile}" 在 _profiles 裡沒有定義（可用：${Object.keys(profiles).join(' / ')}）。` +
|
||||
'\n宣告了一個沒人知道怎麼落地的 profile ⇒ 拒絕部署，不要猜。',
|
||||
);
|
||||
}
|
||||
if (!t.apiBase) throw new Error(`目標 ${name} 沒有 apiBase——空值會讓前端安靜地連不上，拒絕部署。`);
|
||||
if (!t.accountId) throw new Error(`目標 ${name} 沒有 accountId——不指定帳號可能部到別人的站上，拒絕部署。`);
|
||||
if (!Array.isArray(t.verifyUrls) || t.verifyUrls.length === 0) {
|
||||
throw new Error(`目標 ${name} 沒有 verifyUrls——沒有對外網址就無法驗「站上跑的＝宣告的」，拒絕部署。`);
|
||||
}
|
||||
return { name, ...t, views: p.views, home: p.home };
|
||||
}
|
||||
|
||||
/** 這個目標「應該長成什麼樣」——產物閘與線上閘都比對這一份。 */
|
||||
export function expected(t) {
|
||||
return {
|
||||
configJs: configJsFor(t),
|
||||
apiBase: t.apiBase,
|
||||
viewsLine: ` var VIEWS = ${JSON.stringify(t.views)};`,
|
||||
homeLine: ` var HOME = ${JSON.stringify(t.home)};`,
|
||||
};
|
||||
}
|
||||
|
||||
export function configJsFor(t) {
|
||||
return (
|
||||
'// 由 console-ui/scripts/deploy.mjs 於部署時依 deploy.targets.json 產生——請勿手改，也不進 git。\n' +
|
||||
`// 目標：${t.name}（${t.description}）\n` +
|
||||
`window.ARCRUN_CONFIG = { apiBase: ${JSON.stringify(t.apiBase)} };\n`
|
||||
);
|
||||
}
|
||||
|
||||
/** 從 config.js 的文字裡取出 apiBase（線上/產物共用同一個解析法）。 */
|
||||
export function parseApiBase(text) {
|
||||
const m = text.match(/apiBase\s*:\s*"([^"]*)"/);
|
||||
return m ? m[1] : null;
|
||||
}
|
||||
@@ -0,0 +1,111 @@
|
||||
/**
|
||||
* verify-live.mjs — 驗「線上網址現在真的在用的組態」＝「deploy.targets.json 宣告的目標」。
|
||||
*
|
||||
* 用法：
|
||||
* node scripts/verify-live.mjs 驗全部目標的全部對外網址
|
||||
* node scripts/verify-live.mjs personal 只驗某個目標
|
||||
* node scripts/verify-live.mjs --wait 容忍 CF Pages 生效延遲（重試）
|
||||
* npm run verify
|
||||
*
|
||||
* 為什麼要這支（2026-08-08）：部署腳本印出來的值，過去只是「它打算做什麼」，
|
||||
* 沒有任何一步回頭確認「站上真的變成那樣」。deploy.mjs 推完會自動叫它；
|
||||
* 它也可以獨立跑，用來回答「現在哪一台躺在錯的狀態」。
|
||||
*
|
||||
* 🔴 一律帶 no-cache（快取害人誤判過）。curl|grep 不算驗前端，但 config.js 是
|
||||
* 純文字資產、VIEWS/HOME 是 HTML 內嵌常數，抓原始碼比對是「這一項」的正確驗法；
|
||||
* 「頁面真的能用」另外走瀏覽器實載。
|
||||
*/
|
||||
import { loadTargets, resolveTarget, parseApiBase } from './targets.mjs';
|
||||
|
||||
const NOCACHE = { 'Cache-Control': 'no-cache', Pragma: 'no-cache' };
|
||||
|
||||
async function get(url) {
|
||||
const res = await fetch(`${url}${url.includes('?') ? '&' : '?'}_nc=${Date.now()}`, {
|
||||
headers: NOCACHE,
|
||||
cache: 'no-store',
|
||||
redirect: 'follow',
|
||||
});
|
||||
return { status: res.status, text: await res.text() };
|
||||
}
|
||||
|
||||
/** 驗一個網址。回傳 { url, ok, checks:[{name, ok, want, got}] } */
|
||||
export async function verifyUrl(t, url) {
|
||||
const checks = [];
|
||||
try {
|
||||
const cfg = await get(`${url}/config.js`);
|
||||
const got = cfg.status === 200 ? parseApiBase(cfg.text) : `HTTP ${cfg.status}`;
|
||||
checks.push({ name: 'apiBase', ok: got === t.apiBase, want: t.apiBase, got: got ?? '(config.js 裡找不到 apiBase)' });
|
||||
} catch (e) {
|
||||
checks.push({ name: 'apiBase', ok: false, want: t.apiBase, got: `連線失敗：${e.message}` });
|
||||
}
|
||||
|
||||
try {
|
||||
const con = await get(`${url}/console/`);
|
||||
const views = con.text.match(/var VIEWS = (\[[^\]]*\]);/);
|
||||
const home = con.text.match(/var HOME = "([^"]*)";/);
|
||||
const gotViews = con.status === 200 ? (views ? views[1] : '(找不到 VIEWS)') : `HTTP ${con.status}`;
|
||||
const gotHome = con.status === 200 ? (home ? home[1] : '(找不到 HOME)') : `HTTP ${con.status}`;
|
||||
checks.push({
|
||||
name: `profile(${t.profile}).views`,
|
||||
ok: gotViews === JSON.stringify(t.views),
|
||||
want: JSON.stringify(t.views),
|
||||
got: gotViews,
|
||||
});
|
||||
checks.push({ name: `profile(${t.profile}).home`, ok: gotHome === t.home, want: t.home, got: gotHome });
|
||||
} catch (e) {
|
||||
checks.push({ name: `profile(${t.profile})`, ok: false, want: t.profile, got: `連線失敗：${e.message}` });
|
||||
}
|
||||
|
||||
return { url, ok: checks.every((c) => c.ok), checks };
|
||||
}
|
||||
|
||||
export async function verifyTarget(name, { wait = false } = {}) {
|
||||
const t = resolveTarget(name);
|
||||
const attempts = wait ? 8 : 1;
|
||||
let results = [];
|
||||
for (let i = 1; i <= attempts; i++) {
|
||||
results = [];
|
||||
for (const url of t.verifyUrls) results.push(await verifyUrl(t, url));
|
||||
if (results.every((r) => r.ok) || i === attempts) break;
|
||||
process.stdout.write(` … 尚未生效，${5}s 後重試（${i}/${attempts - 1}）\n`);
|
||||
await new Promise((r) => setTimeout(r, 5000));
|
||||
}
|
||||
return { name, target: t, ok: results.every((r) => r.ok), results };
|
||||
}
|
||||
|
||||
export function printReport(reports) {
|
||||
for (const r of reports) {
|
||||
console.log(`\n【${r.name}】${r.target.description}`);
|
||||
console.log(` 宣告：profile=${r.target.profile} apiBase=${r.target.apiBase}`);
|
||||
for (const u of r.results) {
|
||||
console.log(` ${u.ok ? '✅' : '❌'} ${u.url}`);
|
||||
for (const c of u.checks) {
|
||||
if (c.ok) console.log(` ✓ ${c.name} = ${c.got}`);
|
||||
else console.log(` ✗ ${c.name}\n 宣告：${c.want}\n 線上：${c.got}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export async function verifyAll(names, opts) {
|
||||
const reports = [];
|
||||
for (const n of names) reports.push(await verifyTarget(n, opts));
|
||||
return reports;
|
||||
}
|
||||
|
||||
const isCli = process.argv[1] && import.meta.url === `file://${process.argv[1]}`;
|
||||
if (isCli) {
|
||||
const args = process.argv.slice(2);
|
||||
const wait = args.includes('--wait');
|
||||
const picked = args.filter((a) => !a.startsWith('--'));
|
||||
const names = picked.length ? picked : loadTargets().names;
|
||||
const reports = await verifyAll(names, { wait });
|
||||
printReport(reports);
|
||||
const bad = reports.filter((r) => !r.ok);
|
||||
if (bad.length) {
|
||||
console.error(`\n❌ ${bad.length} 個目標的線上組態與宣告不符：${bad.map((b) => b.name).join('、')}`);
|
||||
console.error(' （站上實際在用的值 ≠ deploy.targets.json 宣告的值——這正是要被擋掉的那個病）');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('\n✅ 所有目標：線上組態＝宣告值。');
|
||||
}
|
||||
Reference in New Issue
Block a user