admin
146c3d25ef
覆盖网络线累积产物（此前只在工作区、未入版本库）：
- 新增 relay 子系统 src/net/relay/**（wire/duplex/server/client/dialer/switcher/directory/identity/keys/placement/network/addr-override/main/index）
- 新增 src/worker/relay-tunnel.ts、src/web/routes/overlay.ts
- 新增观测/演练脚本 overlay-probe、overlay-failover-drill、overlay-keyring、overlay-holepunch、overlay-jitter、overlay-wan、overlay-relaykey-add、relay-mem-calibrate
- 新增测试 12 个（relay / relay-failover / remote-spawner / instance-port / overlay-{network,auth,bootstrap,identity} / remote-user-fs 等）
验收基线：npm test = 162 pass / 0 fail / 1 skip；--scene all = 12 PASS / 0 SKIP / 0 FAIL；overlay-probe = 12/12
95 lines
3.8 KiB
JavaScript
95 lines
3.8 KiB
JavaScript
/**
|
||
* Manager 侧 `RemoteSpawner.endpointFor` 的**端点翻译接线**单测（覆盖网络 R4）。
|
||
*
|
||
* ## 为什么单独立一个文件（2026-09-16 实测代价）
|
||
* `translateEndpoint` 是 R4 的**唯一**翻译点：`via='relay'` 的 host，其实例在 Worker 上监听
|
||
* `127.0.0.1:<实例端口>`，而 Manager 必须拨 relay 为那个端口开的**动态回环口号**。
|
||
*
|
||
* 首版实现里 `RemoteSpawner` 的构造函数**漏了 `this.translateEndpoint = options.translateEndpoint`**
|
||
* —— 于是整个翻译**静默失效**：`endpointFor` 原样返回 Worker 侧口号 ⇒ Manager 往**自己本机**
|
||
* 拨 `127.0.0.1:21000` ⇒ 连接被拒两次 ⇒ 代理 `reply.raw.destroy()`。
|
||
* 现场表现只有两条：浏览器/curl 看到 **`Empty reply from server`**；平台日志**一行错误都没有**。
|
||
* （定位靠"在 47 上临时监听 21000，请求被这个探针接走"——即**用判别器测，而不是读代码猜**。）
|
||
*
|
||
* ⇒ 本文件把"翻译必须真的生效"钉成断言：**构造时就验**，不依赖集群环境、不依赖 relay 在跑。
|
||
*
|
||
* 运行：`node --test test/remote-spawner.test.mjs`（已登记进 `npm test` / `npm run verify`）。
|
||
*
|
||
* @module test/remote-spawner
|
||
*/
|
||
|
||
import assert from 'node:assert/strict'
|
||
import { test } from 'node:test'
|
||
import { RemoteSpawner } from '../lib/supervisor/remote-spawner.js'
|
||
|
||
/* ─────────── 小工具 ─────────── */
|
||
|
||
/** Worker 侧 agent 的回包（`GET /endpoint/:userId` 的形状）。 */
|
||
function fakeFetch(payload) {
|
||
const calls = []
|
||
const impl = async (url, init) => {
|
||
calls.push(`${init?.method ?? 'GET'} ${url}`)
|
||
return { ok: true, status: 200, json: async () => payload, text: async () => JSON.stringify(payload) }
|
||
}
|
||
impl.calls = calls
|
||
return impl
|
||
}
|
||
|
||
/** `via='relay'` 的一台 worker：agent 口号 19000，relay 已把它映射到本机 38253。 */
|
||
const W106 = {
|
||
hostId: 'w-106',
|
||
agentUrl: 'http://127.0.0.1:19000',
|
||
reachability: { hostId: 'w-106', via: 'relay', address: '127.0.0.1:38253', scheme: 'http' },
|
||
token: 'tok-106',
|
||
}
|
||
|
||
function make(opts = {}) {
|
||
return new RemoteSpawner({
|
||
agentUrl: 'http://127.0.0.1:19100',
|
||
token: 'tok-local',
|
||
defaultHostId: 'w-47',
|
||
hostIdFor: async () => 'w-106',
|
||
hostsProvider: async () => [W106],
|
||
fetchImpl: fakeFetch({ running: true, host: '127.0.0.1', port: 21000 }),
|
||
...opts,
|
||
})
|
||
}
|
||
|
||
/* ─────────── T1–T4 ─────────── */
|
||
|
||
test('T1 翻译器被真的接上：传入的 hostId/endpoint 与返回值都要生效', async () => {
|
||
const seen = []
|
||
const s = make({
|
||
translateEndpoint: (hostId, ep) => {
|
||
seen.push([hostId, ep])
|
||
return { host: '127.0.0.1', port: 34241 }
|
||
},
|
||
})
|
||
assert.deepEqual(await s.endpointFor('u1'), { host: '127.0.0.1', port: 34241 })
|
||
// ★ 这一条就是首版漏赋值时唯一会红的断言：漏了 ⇒ seen 为空、返回 {21000}
|
||
assert.deepEqual(seen, [['w-106', { host: '127.0.0.1', port: 21000 }]])
|
||
})
|
||
|
||
test('T2 未给翻译器 ⇒ 原样透传（local / manager-ssh 的同号语义，行为零变化）', async () => {
|
||
const s = make()
|
||
assert.deepEqual(await s.endpointFor('u1'), { host: '127.0.0.1', port: 21000 })
|
||
})
|
||
|
||
test('T3 翻译器回 undefined ⇒ endpointFor 也回 undefined（失败关闭，不回退 Worker 口号）', async () => {
|
||
const s = make({ translateEndpoint: () => undefined })
|
||
assert.equal(await s.endpointFor('u1'), undefined)
|
||
})
|
||
|
||
test('T4 实例未运行 ⇒ undefined，且**不该**调翻译器（没有端口可翻）', async () => {
|
||
let called = false
|
||
const s = make({
|
||
fetchImpl: fakeFetch({ running: false }),
|
||
translateEndpoint: () => {
|
||
called = true
|
||
return undefined
|
||
},
|
||
})
|
||
assert.equal(await s.endpointFor('u1'), undefined)
|
||
assert.equal(called, false)
|
||
})
|