fix(hosting): live probe가 하위 경로 기준 URL에서 surface를 그 아래로 요청한다
문제: `HOSTING_BASE_URL`의 경로가 `/`가 아니면 probe가 거절해, 하위 경로 (`VITE_ROUTER_BASE_PATH=/app/`)로 배포한 release는 live 확인을 쓸 수 없었다. surface 경로(`/config.json`)도 늘 origin 루트로 풀었다. 고친 것: 기준 URL은 `/`로 끝나는 경로면 받는다(query·fragment는 거절). `config/hosting/cache-policy.json`의 surface 경로는 기준 URL 아래로 푼다 (`surfaceUrl`). 진입 script는 index.html이 적은 그대로 요청한다. 후보의 진입 script가 기준 경로 아래에 있는지(`deployment base-path`)도 보아, 다른 경로로 빌드한 후보를 잘못된 기준 URL로 재면 실패한다. 검증: desktop `node scripts/run-vitest.ts run tests/unit/hosting-probe.test.ts` 46건 통과(`/app/` 기준 요청 경로, 경로 불일치 실패, URL 분류). 기준 커밋에서는 새 시험이 실패한다. Refs: 0929/13-06
This commit is contained in:
@@ -130,9 +130,12 @@ probe하지 않고 `UNVERIFIED`로 끝난다. 슬롯을 채우는 방법은
|
|||||||
|
|
||||||
**주소와 연결**
|
**주소와 연결**
|
||||||
|
|
||||||
1. 앱은 HTTPS origin의 루트(`/`)에서 내보낸다. 인증서가 유효하고, 어느 surface도 그
|
1. 앱은 HTTPS origin의 루트(`/`)나 빌드한 하위 경로(`VITE_ROUTER_BASE_PATH`, 예 `/app/`)에서
|
||||||
origin 밖으로 redirect하지 않는다. — FE-GATE-019가 잰다. `HOSTING_BASE_URL`은 경로 없는
|
내보낸다. 인증서가 유효하고, 어느 surface도 그 origin 밖으로 redirect하지 않는다. —
|
||||||
HTTPS 루트 URL이어야 하고, surface마다 최종 origin을 본다.
|
FE-GATE-019가 잰다. `HOSTING_BASE_URL`은 release의 기준 URL(루트 또는 `/`로 끝나는 그
|
||||||
|
하위 경로, query·fragment 없음)이다. probe는 surface 경로(`config/hosting/cache-policy.json`)를
|
||||||
|
그 아래에서 요청하고, 후보의 진입 script가 그 경로 아래에 있는지와 surface마다 최종
|
||||||
|
origin을 본다.
|
||||||
2. TLS에서 HTTP/2를 맺는다(ALPN `h2`). — FE-GATE-019가 잰다(`transport.alpnProtocols`).
|
2. TLS에서 HTTP/2를 맺는다(ALPN `h2`). — FE-GATE-019가 잰다(`transport.alpnProtocols`).
|
||||||
|
|
||||||
**surface별 응답** (surface: probe가 요청하는 경로 하나)
|
**surface별 응답** (surface: probe가 요청하는 경로 하나)
|
||||||
|
|||||||
@@ -142,9 +142,9 @@ export async function probeLiveRelease(
|
|||||||
const negotiateAlpn = transport.negotiateAlpn ?? negotiatedAlpnProtocol;
|
const negotiateAlpn = transport.negotiateAlpn ?? negotiatedAlpnProtocol;
|
||||||
const responses: ResponseHeaders = {};
|
const responses: ResponseHeaders = {};
|
||||||
const results: ProbeResult[] = [];
|
const results: ProbeResult[] = [];
|
||||||
const probe = async (surface: string, pathname: string): Promise<string | null> => {
|
const probe = async (surface: string, target: URL): Promise<string | null> => {
|
||||||
try {
|
try {
|
||||||
const response = await fetcher(new URL(pathname, base));
|
const response = await fetcher(target);
|
||||||
const finalOrigin = new URL(response.url).origin;
|
const finalOrigin = new URL(response.url).origin;
|
||||||
results.push(
|
results.push(
|
||||||
{
|
{
|
||||||
@@ -191,11 +191,12 @@ export async function probeLiveRelease(
|
|||||||
|
|
||||||
const bodies: Record<string, string | null> = {};
|
const bodies: Record<string, string | null> = {};
|
||||||
for (const [surface, pathname] of Object.entries(paths)) {
|
for (const [surface, pathname] of Object.entries(paths)) {
|
||||||
bodies[surface] = await probe(surface, pathname);
|
bodies[surface] = await probe(surface, surfaceUrl(pathname, base));
|
||||||
}
|
}
|
||||||
const entryScript = servedEntryScript(bodies["index"] ?? "");
|
const entryScript = servedEntryScript(bodies["index"] ?? "");
|
||||||
if (entryScript) {
|
if (entryScript) {
|
||||||
await probe("hashedAsset", entryScript);
|
// The served index.html names it as the build wrote it (under the base path).
|
||||||
|
await probe("hashedAsset", new URL(entryScript, base));
|
||||||
} else {
|
} else {
|
||||||
results.push({
|
results.push({
|
||||||
surface: "hashedAsset",
|
surface: "hashedAsset",
|
||||||
@@ -226,6 +227,21 @@ export async function probeLiveRelease(
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
const candidateEntryScript = servedEntryScript(candidate.indexHtml);
|
const candidateEntryScript = servedEntryScript(candidate.indexHtml);
|
||||||
|
// 0929/13-06. The candidate was built for one base path; a HOSTING_BASE_URL
|
||||||
|
// with another path probes surfaces the release does not serve.
|
||||||
|
// The build writes its scripts to `<base>assets/`, so the entry script's
|
||||||
|
// folder says which base the candidate was built for, in both directions.
|
||||||
|
const builtFor = candidateEntryScript?.startsWith(`${base.pathname}${BUILD_ASSET_DIRECTORY}`) === true;
|
||||||
|
results.push({
|
||||||
|
surface: "deployment",
|
||||||
|
header: "base-path",
|
||||||
|
expected: `${base.pathname}${BUILD_ASSET_DIRECTORY}`,
|
||||||
|
observed: candidateEntryScript,
|
||||||
|
...(builtFor
|
||||||
|
? {}
|
||||||
|
: { reason: "the candidate was built for another base path than the HOSTING_BASE_URL path (VITE_ROUTER_BASE_PATH of the build)" }),
|
||||||
|
passed: builtFor,
|
||||||
|
});
|
||||||
results.push({
|
results.push({
|
||||||
surface: "index",
|
surface: "index",
|
||||||
header: "candidate-entry-script",
|
header: "candidate-entry-script",
|
||||||
@@ -405,10 +421,19 @@ export function checkPublicServiceWorkers(
|
|||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 0929/13-06. The surfaces in config/hosting/cache-policy.json are written
|
||||||
|
* from the release's root (`/config.json`); a release served under a base
|
||||||
|
* path (`VITE_ROUTER_BASE_PATH=/app/`) serves them under that path.
|
||||||
|
*/
|
||||||
|
export function surfaceUrl(pathname: string, base: URL): URL {
|
||||||
|
return new URL(`.${pathname.startsWith("/") ? pathname : `/${pathname}`}`, base);
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* A release gate must not promote a local preview server as live hosting
|
* A release gate must not promote a local preview server as live hosting
|
||||||
* evidence.
|
* evidence. 0929/13-06: the URL is the release's base URL, the root or the
|
||||||
*
|
* sub-path the build was made for (`/app/`).
|
||||||
*/
|
*/
|
||||||
export function classifyLiveHostingBaseUrl(value: string):
|
export function classifyLiveHostingBaseUrl(value: string):
|
||||||
| {
|
| {
|
||||||
@@ -467,10 +492,10 @@ export function classifyLiveHostingBaseUrl(value: string):
|
|||||||
observedOrigin,
|
observedOrigin,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
if (url.pathname !== "/" || url.search || url.hash) {
|
if (!url.pathname.endsWith("/") || url.search || url.hash) {
|
||||||
return {
|
return {
|
||||||
passed: false,
|
passed: false,
|
||||||
reason: "HOSTING_BASE_URL must be the canonical root URL",
|
reason: "HOSTING_BASE_URL must be the release's base URL: a path ending in \"/\", without query or fragment",
|
||||||
url,
|
url,
|
||||||
observedOrigin,
|
observedOrigin,
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -121,7 +121,7 @@ if (liveTarget?.passed && !slotEmpty) {
|
|||||||
probeResults.push({
|
probeResults.push({
|
||||||
surface: "deployment",
|
surface: "deployment",
|
||||||
header: "base-url",
|
header: "base-url",
|
||||||
expected: "canonical non-loopback HTTPS root URL",
|
expected: "non-loopback HTTPS base URL of the release",
|
||||||
observed: liveTarget.observedOrigin,
|
observed: liveTarget.observedOrigin,
|
||||||
reason: liveTarget.reason,
|
reason: liveTarget.reason,
|
||||||
passed: false,
|
passed: false,
|
||||||
|
|||||||
@@ -73,11 +73,18 @@ describe("live hosting evidence target", () => {
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// 0929/13-06. A release built for VITE_ROUTER_BASE_PATH=/app/ is served
|
||||||
|
// under /app/; the probe refused any URL but the root, so it could not be used.
|
||||||
|
it("accepts the sub-path a release is built for", () => {
|
||||||
|
expect(classifyLiveHostingBaseUrl("https://frontend.example.test/app/")).toMatchObject({ passed: true });
|
||||||
|
});
|
||||||
|
|
||||||
it.each([
|
it.each([
|
||||||
["http://frontend.example.test/", "requires HTTPS"],
|
["http://frontend.example.test/", "requires HTTPS"],
|
||||||
["https://localhost:4173/", "not live deployment evidence"],
|
["https://localhost:4173/", "not live deployment evidence"],
|
||||||
["https://127.0.0.1/", "not live deployment evidence"],
|
["https://127.0.0.1/", "not live deployment evidence"],
|
||||||
["https://frontend.example.test/app/", "canonical root URL"],
|
["https://frontend.example.test/app", "path ending in \"/\""],
|
||||||
|
["https://frontend.example.test/?preview=1", "without query or fragment"],
|
||||||
["https://user:secret@frontend.example.test/", "must not contain credentials"],
|
["https://user:secret@frontend.example.test/", "must not contain credentials"],
|
||||||
])("rejects %s", (url, reason) => {
|
])("rejects %s", (url, reason) => {
|
||||||
expect(classifyLiveHostingBaseUrl(url)).toMatchObject({
|
expect(classifyLiveHostingBaseUrl(url)).toMatchObject({
|
||||||
@@ -193,6 +200,62 @@ describe("SPA fallback and worker script surfaces (1101/13-04)", () => {
|
|||||||
expect(await failed({ ...RELEASE, "/__probe/deep-link": [200, INDEX] })).toEqual([]);
|
expect(await failed({ ...RELEASE, "/__probe/deep-link": [200, INDEX] })).toEqual([]);
|
||||||
});
|
});
|
||||||
|
|
||||||
|
// 0929/13-06. Under a base path the surfaces are requested below it.
|
||||||
|
it("probes a release built for /app/ below /app/ and passes it", async () => {
|
||||||
|
const appIndex = '<script type="module" src="/app/assets/index-A1.js"></script>';
|
||||||
|
const requested: string[] = [];
|
||||||
|
const routes: Record<string, [number, string]> = {
|
||||||
|
"/app/": [200, appIndex],
|
||||||
|
"/app/config.json": [200, CONFIG],
|
||||||
|
"/app/release-manifest.json": [200, JSON.stringify({ schemaVersion: 2, ...IDENTITY })],
|
||||||
|
"/app/__probe/deep-link": [200, appIndex],
|
||||||
|
"/app/assets/index-A1.js": [200, ""],
|
||||||
|
};
|
||||||
|
const { results } = await probeLiveRelease(
|
||||||
|
new URL("https://frontend.example.test/app/"),
|
||||||
|
PATHS,
|
||||||
|
{ ...CANDIDATE, indexHtml: appIndex },
|
||||||
|
{
|
||||||
|
fetcher: async (url) => {
|
||||||
|
requested.push(url.pathname);
|
||||||
|
return host(routes)(url);
|
||||||
|
},
|
||||||
|
negotiateAlpn: async () => "h2",
|
||||||
|
alpnProtocols: ["h2"],
|
||||||
|
},
|
||||||
|
);
|
||||||
|
|
||||||
|
expect(requested).toEqual([
|
||||||
|
"/app/",
|
||||||
|
"/app/config.json",
|
||||||
|
"/app/release-manifest.json",
|
||||||
|
"/app/__probe/deep-link",
|
||||||
|
"/app/assets/index-A1.js",
|
||||||
|
]);
|
||||||
|
expect(results.filter((result) => !result.passed)).toEqual([]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("fails a HOSTING_BASE_URL path the candidate was not built for", async () => {
|
||||||
|
expect(
|
||||||
|
(await probeLiveRelease(new URL("https://frontend.example.test/app/"), PATHS, CANDIDATE, {
|
||||||
|
fetcher: host({}),
|
||||||
|
negotiateAlpn: async () => "h2",
|
||||||
|
alpnProtocols: ["h2"],
|
||||||
|
})).results.find((result) => result.header === "base-path"),
|
||||||
|
).toMatchObject({ expected: "/app/assets/", observed: "/assets/index-A1.js", passed: false });
|
||||||
|
// And the other way: a release built for /app/ probed at the root.
|
||||||
|
expect(
|
||||||
|
(await probeLiveRelease(base, PATHS, {
|
||||||
|
...CANDIDATE,
|
||||||
|
indexHtml: '<script type="module" src="/app/assets/index-A1.js"></script>',
|
||||||
|
}, {
|
||||||
|
fetcher: host({}),
|
||||||
|
negotiateAlpn: async () => "h2",
|
||||||
|
alpnProtocols: ["h2"],
|
||||||
|
})).results.find((result) => result.header === "base-path"),
|
||||||
|
).toMatchObject({ expected: "/assets/", observed: "/app/assets/index-A1.js", passed: false });
|
||||||
|
});
|
||||||
|
|
||||||
it("fails a host without the fallback", async () => {
|
it("fails a host without the fallback", async () => {
|
||||||
expect(await failed(RELEASE)).toEqual(["appRoute http-status", "appRoute entry-script"]);
|
expect(await failed(RELEASE)).toEqual(["appRoute http-status", "appRoute entry-script"]);
|
||||||
});
|
});
|
||||||
|
|||||||
Reference in New Issue
Block a user