worker: 修掉两个会让 Worker 部署直接失败的配置错误
- wrangler.toml 用 JSDoc 的 /** */ 注释,TOML 解析器把 '*' 当未知字符 (wrangler 报 Unknown character 47),deploy/secret put/dev 在读取配置阶段 就失败,根本走不到你的 secret。全部展开成 '#' 行。 - npm test 写成 node --test test/,Node 22.23 会把 test/ 当模块路径去 require,报 MODULE_NOT_FOUND。改成 node --test(无参数自动发现 test/), 仍为 32 个用例全通过(backends 6 / health 4 / index 12 / lb 10)。 wrangler deploy --dry-run 现通过(wrangler 3.114.17,上传 31.48 KiB)。
This commit is contained in:
parent
baff2dde8d
commit
826b41e781
|
|
@ -5,7 +5,7 @@
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"description": "MessageWeave Cloudflare Worker: 统一 HTTPS 入口 + 多后端 origin 故障转移(透传模型,SAF-LB-PASSTHRU)。零运行时依赖(仅 ES2022 + Fetch API),可直接 node --test。",
|
"description": "MessageWeave Cloudflare Worker: 统一 HTTPS 入口 + 多后端 origin 故障转移(透传模型,SAF-LB-PASSTHRU)。零运行时依赖(仅 ES2022 + Fetch API),可直接 node --test。",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"test": "node --test test/",
|
"test": "node --test",
|
||||||
"check": "node --check src/*.js && node --check test/*.test.js && wrangler deploy --dry-run --outdir=.build-check",
|
"check": "node --check src/*.js && node --check test/*.test.js && wrangler deploy --dry-run --outdir=.build-check",
|
||||||
"deploy": "wrangler deploy",
|
"deploy": "wrangler deploy",
|
||||||
"dev": "wrangler dev --local"
|
"dev": "wrangler dev --local"
|
||||||
|
|
|
||||||
|
|
@ -1,28 +1,34 @@
|
||||||
/**
|
# Wrangler 配置 — MessageWeave 多实例 LB/HA(ARCH-LB-WORKER / deployment.md §10)。
|
||||||
* Wrangler 示例配置 — MessageWeave 多实例 LB/HA(ARCH-LB-WORKER / deployment.md §10)。
|
#
|
||||||
*
|
# 注意:TOML 只支持 '#' 注释。这里曾经用 JSDoc 的 /** */ 块,Cloudflare 的 TOML
|
||||||
* 安全约束(docs/charter.md §3/§5,稳定 ID 注册表 §8):
|
# 解析器会把 '*' 当成未知字符(wrangler 报 Unknown character "47"),deploy /
|
||||||
* - 后端 origin 仅允许 https(C-HTTPS-INBOUND / C-HTTPS-URL);env 校验时拒绝
|
# secret put / dev 在读取配置文件时就失败——所以全部展开成 '#' 行。
|
||||||
* http/非 https/内嵌凭据。
|
#
|
||||||
* - 不代理 Redis/JMAP(C-NO-DB / C-REDIS-ONLY-STATE):Worker 只做请求转发,后端连自己的 Redis。
|
# 安全约束(docs/charter.md §3/§5,稳定 ID 注册表 §8):
|
||||||
* - 不使用 WebSocket/SSE/长轮询(C-NO-LONG-CONN):纯请求-响应转发。
|
# - 后端 origin 仅允许 https(C-HTTPS-INBOUND / C-HTTPS-URL);env 校验时拒绝
|
||||||
* - 后端 secret 走 `wrangler secret`(见 README),不进代码/日志(SAF-LOG-PURITY / C-NO-SECRET-IN-IMAGE;
|
# http/非 https/内嵌凭据。
|
||||||
* C-LB-SHARED-SECRETS:所有后端实例共享同一组 secret)。
|
# - 不代理 Redis/JMAP(C-NO-DB / C-REDIS-ONLY-STATE):Worker 只做请求转发,后端连自己的 Redis。
|
||||||
* - 日志无密钥(SAF-LOG-PURITY):只打「方法/路径/origin/失败类别」,origin 清单走 secret。
|
# - 不使用 WebSocket/SSE/长轮询(C-NO-LONG-CONN):纯请求-响应转发。
|
||||||
* - 仅允许转发 safelist 路由(C-LB-SINGLE-REG-URL);未知路径 404。
|
# - 后端 secret 走 `wrangler secret`(见 README),不进代码/日志(SAF-LOG-PURITY / C-NO-SECRET-IN-IMAGE;
|
||||||
*
|
# C-LB-SHARED-SECRETS:所有后端实例共享同一组 secret)。
|
||||||
* 部署:
|
# - 日志无密钥(SAF-LOG-PURITY):只打「方法/路径/origin/失败类别」,origin 清单走 secret。
|
||||||
* cd cloudflare-worker
|
# - 仅允许转发 safelist 路由(C-LB-SINGLE-REG-URL);未知路径 404。
|
||||||
* npx wrangler secret put BACKEND_ORIGINS_JSON # 见下方示例格式
|
#
|
||||||
* npx wrangler deploy
|
# 部署:
|
||||||
*/
|
# cd cloudflare-worker
|
||||||
|
# npx wrangler secret put BACKEND_ORIGINS_JSON # 见下方示例格式
|
||||||
|
# npx wrangler deploy
|
||||||
|
|
||||||
name = "messageweave-lb"
|
name = "messageweave-lb"
|
||||||
main = "src/index.js"
|
main = "src/index.js"
|
||||||
compatibility_date = "2025-01-01"
|
compatibility_date = "2025-01-01"
|
||||||
compatibility_flags = ["nodejs_compat_v2"]
|
compatibility_flags = ["nodejs_compat_v2"]
|
||||||
|
|
||||||
# 统一 HTTPS 入站(C-HTTPS-URL;平台代 TLS,Worker 内为短请求模型)。
|
# 统一 HTTPS 入站(C-HTTPS-URL;平台代 TLS,Worker 内为短请求模型)。
|
||||||
# 后端 origin 为 secret(不经明文 env 流转):
|
# 后端 origin 为 secret(不经明文 env 流转)。BACKEND_ORIGINS_JSON 只接受
|
||||||
|
# 「字符串数组」——每项是一个 https origin;不支持 {"url":…, "weight":…} 这种
|
||||||
|
# 对象形式(parseBackendOrigin 只认字符串,对象项会让整份配置解析失败,
|
||||||
|
# 而配置是**每个请求**重新解析的,所以会表现为**每个请求都 503**,不是启动即失败):
|
||||||
# BACKEND_ORIGINS_JSON 形如 ["https://a.platform1.example","https://b.platform2.example"]
|
# BACKEND_ORIGINS_JSON 形如 ["https://a.platform1.example","https://b.platform2.example"]
|
||||||
# LB_HEALTH_TTL_MS 可选,健康缓存 TTL(默认 30000)
|
# LB_HEALTH_TTL_MS 可选,健康缓存 TTL(默认 30000)
|
||||||
# LB_REQUEST_TIMEOUT_MS 可选,单 origin 超时(默认 10000,建议 > 最坏 cold start)
|
# LB_REQUEST_TIMEOUT_MS 可选,单 origin 超时(默认 10000,建议 > 最坏 cold start)
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue