B1. 검증·미리보기 화면이 CSS 없이 배포됐다. `workflow.module.css` 를 import 하는 파일이 하나도 없었고, Vite 의 CSS Module 은 import 되어야 번들에 들어간다. 제목이 62px 가 아니라 16px 로 나왔고 미리보기의 링크 두 개가 공백 없이 붙었다. 규칙이 전부 `:global()` 이었으므로 모듈일 이유가 없다 — studio.css 로 옮겼다. B2. Asset 라이브러리에 스타일이 없고 진입 경로도 없었다. 네 클래스에 규칙이 하나도 없어 key·상태·사용 수가 공백 없이 이어 붙었다. 스무 개짜리 목록에 썸네일도 없어 무엇을 고르는지 눌러 봐야 알았다. 내비게이션에도 없어서 URL 을 직접 쳐야 닿았다 — "정리하는 화면" 에 정리하러 갈 길이 없었다. B3. 삭제에 확인이 없었다. 문서·주제·프로젝트·릴리즈·Asset 전부 한 번에 영구 삭제였고, 그 「삭제」가 행에서 시각적으로 가장 강한 요소였다(16px/600 빨강). 정작 그 행에서 해야 할 일인 「검증하기」는 13px/400 이었다. 확인 창을 하나 만들어 다섯 곳에 붙이고, 행의 우선순위를 되돌렸다. B4(일부). robots.txt 가 광고하던 sitemap 이 404 였다. 무엇이 게시됐는지는 서버만 알므로 정적 파일이 아니라 조회로 만든다(백엔드 커밋 참조). robots.txt 가 그 주소를 가리키게 했다. B5. 라우트 프리픽스 밖 URL 이 nginx 의 맨 `Not Found` 로 끝났다. 404 상태는 그대로 두고 — 크롤러에게 링크가 깨졌다고 말하는 것이 그것이다 — 본문만 앱을 주도록 `error_page 404 @not_found` 를 뒀다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
244 lines
8.9 KiB
TypeScript
244 lines
8.9 KiB
TypeScript
import { readFile, writeFile } from "node:fs/promises";
|
|
import path from "node:path";
|
|
|
|
/**
|
|
* Emits the nginx configuration the deployed frontend is served with.
|
|
*
|
|
* Generated rather than hand-written because three files already decide what it
|
|
* must say, and a copy of them would drift: `dist/tech-log-serving-contract.json`
|
|
* (which paths are SPA routes and what a miss answers with),
|
|
* `config/hosting/security-headers.json`, and `config/hosting/cache-policy.json`.
|
|
* The repository had no frontend deployment artifact at all — no Dockerfile, no
|
|
* server config — so those two hosting files described a contract nothing
|
|
* fulfilled: `dist/server.mjs` applies neither, answering `no-cache` for hashed
|
|
* assets and sending no security headers.
|
|
*
|
|
* This serves static files only. TLS and the BFF paths belong to the edge: the
|
|
* deployment's own nginx terminates HTTPS and sends `/api`, the OIDC redirect
|
|
* chain and the identity provider to the backend directly (in Kubernetes,
|
|
* Traefik does). A second proxy hop here would only add a place for the two
|
|
* routing tables to disagree.
|
|
*
|
|
* The base path comes from `VITE_ROUTER_BASE_PATH`, the same value the bundle is
|
|
* built with: served under a prefix, every route and asset lives under it too.
|
|
*/
|
|
|
|
const DIST = "dist";
|
|
const OUT = path.join(DIST, "nginx.conf");
|
|
|
|
type ServingContract = Readonly<{
|
|
publicSpaPathPatterns: readonly string[];
|
|
studioPathPrefix: string;
|
|
studioSpaPathPatterns: readonly string[];
|
|
notFound: Readonly<{ status: number; contentType: string; body: string }>;
|
|
}>;
|
|
|
|
type HostingHeaders = Readonly<{ headers: Readonly<Record<string, string>> }>;
|
|
|
|
type CachePolicy = Readonly<{
|
|
surfaces: Readonly<
|
|
Record<
|
|
string,
|
|
Readonly<{
|
|
path?: string;
|
|
pathPattern?: string;
|
|
cacheControl?: string;
|
|
securityHeaders?: boolean;
|
|
}>
|
|
>
|
|
>;
|
|
}>;
|
|
|
|
async function readJson<T>(file: string): Promise<T> {
|
|
return JSON.parse(await readFile(file, "utf8")) as T;
|
|
}
|
|
|
|
/** nginx location matching is not regex-escaped for us; only `=` exact paths are literal. */
|
|
function exactLocation(pathname: string): string {
|
|
return pathname;
|
|
}
|
|
|
|
/**
|
|
* A JS regex from the contract translated for nginx. Both use PCRE-ish syntax
|
|
* for what the contract uses (`^`, `$`, `[^/]+`, alternation), so the pattern
|
|
* carries over unchanged — asserted rather than assumed, because a pattern that
|
|
* silently failed to translate would open a Studio route to the 404 branch.
|
|
*/
|
|
function studioRegex(pattern: string): string {
|
|
// nginx uses PCRE, so anchors, character classes, alternation and plain groups
|
|
// carry over as written. Lookaround and backreferences do not translate the
|
|
// same way and would silently change which paths match, so they are refused.
|
|
if (/\(\?[=!<]|\\[1-9]/.test(pattern)) {
|
|
throw new Error(
|
|
`studio SPA pattern uses a construct this generator does not translate: ${pattern}`,
|
|
);
|
|
}
|
|
return pattern;
|
|
}
|
|
|
|
function headerDirectives(
|
|
headers: Readonly<Record<string, string>>,
|
|
indent: string,
|
|
): string {
|
|
return Object.entries(headers)
|
|
.map(([name, value]) => `${indent}add_header ${name} "${value}" always;`)
|
|
.join("\n");
|
|
}
|
|
|
|
async function main(): Promise<void> {
|
|
const contract = await readJson<ServingContract>(
|
|
path.join(DIST, "tech-log-serving-contract.json"),
|
|
);
|
|
const security = await readJson<HostingHeaders>(
|
|
"config/hosting/security-headers.json",
|
|
);
|
|
const cache = await readJson<CachePolicy>("config/hosting/cache-policy.json");
|
|
|
|
const surfaces = cache.surfaces;
|
|
const indexCache = surfaces["index"]?.cacheControl ?? "no-cache";
|
|
const configCache = surfaces["runtimeConfig"]?.cacheControl ?? "no-store";
|
|
const manifestCache = surfaces["releaseManifest"]?.cacheControl ?? "no-store";
|
|
const assetCache = surfaces["hashedAsset"]?.cacheControl ?? "no-cache";
|
|
|
|
const secure = headerDirectives(security.headers, " ");
|
|
|
|
// The bundle's own base path. `/` for a deployment at the domain root, `/dev/`
|
|
// for one served under a prefix — the routes below have to carry it or nginx
|
|
// matches paths the browser never asks for.
|
|
const rawBase = process.env["VITE_ROUTER_BASE_PATH"] ?? "/";
|
|
const basePath = rawBase.endsWith("/") ? rawBase.slice(0, -1) : rawBase;
|
|
|
|
// Regex locations now, matching the Studio half: the contract declares which
|
|
// paths the router serves, not which ones the fixture happened to contain, so
|
|
// a record published after this build is served instead of 404ed at the edge.
|
|
const publicLocations = contract.publicSpaPathPatterns
|
|
.map(
|
|
(pattern: string) => ` location ~ ^${basePath}${studioRegex(pattern).slice(1)} {
|
|
${secure}
|
|
add_header Cache-Control "${indexCache}" always;
|
|
try_files /index.html =404;
|
|
}`,
|
|
)
|
|
.join("\n\n");
|
|
|
|
const studioLocations = contract.studioSpaPathPatterns
|
|
.map(
|
|
(pattern) => ` location ~ ^${basePath}${studioRegex(pattern).slice(1)} {
|
|
${secure}
|
|
add_header Cache-Control "${indexCache}" always;
|
|
try_files /index.html =404;
|
|
}`,
|
|
)
|
|
.join("\n\n");
|
|
|
|
const conf = `# Generated by scripts/generate-nginx-config.ts — do not edit.
|
|
# Sources: dist/tech-log-serving-contract.json, config/hosting/security-headers.json,
|
|
# config/hosting/cache-policy.json
|
|
#
|
|
# Plain HTTP on purpose: the edge terminates TLS and this container is only ever
|
|
# reached from inside the deployment network.
|
|
|
|
server {
|
|
listen 80;
|
|
server_name _;
|
|
root /usr/share/nginx/html;
|
|
index index.html;
|
|
|
|
|
|
# The bundle is small and already compressed at rest by the build; gzip here
|
|
# covers the JSON surfaces and index.html.
|
|
gzip on;
|
|
gzip_types text/css application/javascript text/javascript application/json;
|
|
gzip_min_length 1024;
|
|
|
|
# Static surfaces, per config/hosting/cache-policy.json
|
|
# ---------------------------------------------------------------------------
|
|
location = ${basePath}/config.json {
|
|
alias /usr/share/nginx/html/config.json;
|
|
${secure}
|
|
add_header Cache-Control "${configCache}" always;
|
|
}
|
|
|
|
location = ${basePath}/release-manifest.json {
|
|
alias /usr/share/nginx/html/release-manifest.json;
|
|
${secure}
|
|
add_header Cache-Control "${manifestCache}" always;
|
|
}
|
|
|
|
# Content-hashed filenames, so the long TTL is safe and revalidation is waste.
|
|
location ${basePath}/assets/ {
|
|
# alias, not root + URI: under a base path the request is /dev/assets/x.js
|
|
# while the file is dist/assets/x.js, so root would look for
|
|
# dist/dev/assets/x.js and answer 404 for every script on the page.
|
|
alias /usr/share/nginx/html/assets/;
|
|
add_header Cache-Control "${assetCache}" always;
|
|
}
|
|
|
|
# Source maps are not published (cache-policy sourceMap.public = false).
|
|
location ~ \\.map$ {
|
|
return 404;
|
|
}
|
|
|
|
# ---------------------------------------------------------------------------
|
|
# SPA routes. Enumerated from the serving contract rather than a catch-all:
|
|
# a path that is not a real route answers 404 instead of a 200 shell, which is
|
|
# what tells a crawler the difference.
|
|
# ---------------------------------------------------------------------------
|
|
${publicLocations}
|
|
|
|
${studioLocations}
|
|
|
|
location = ${basePath}/favicon.svg {
|
|
alias /usr/share/nginx/html/favicon.svg;
|
|
add_header Cache-Control "${assetCache}" always;
|
|
}
|
|
|
|
# 크롤러가 처음 찾는 파일이다. 여기 없으면 SPA 폴백이 index.html 을 주고,
|
|
# 크롤러는 그것을 규칙으로 읽을 수 없어 결국 아무 규칙도 없는 것과 같아진다.
|
|
location = ${basePath}/robots.txt {
|
|
alias /usr/share/nginx/html/robots.txt;
|
|
default_type text/plain;
|
|
add_header Cache-Control "${indexCache}" always;
|
|
}
|
|
|
|
location = ${basePath}/media/ {
|
|
return 404;
|
|
}
|
|
|
|
location ${basePath}/media/ {
|
|
alias /usr/share/nginx/html/media/;
|
|
add_header Cache-Control "${assetCache}" always;
|
|
}
|
|
|
|
# 이 배포가 서비스하는 라우트가 아닌 주소.
|
|
#
|
|
# 상태 코드는 404 그대로 둔다 — 크롤러와 우리에게 링크가 깨졌다고 말해 주는 것이 그것이고,
|
|
# 200 껍데기를 주면 그 신호가 사라진다. 다만 본문은 앱을 준다. 예전에는 nginx 의 맨
|
|
# "Not Found" 가 흰 화면으로 나가서, 오타 링크 하나에 헤더도 내비도 없는 막다른 길이 됐다.
|
|
# 앱에는 path "*" 로 선언된 404 라우트가 이미 있고 청크도 빌드되는데 닿을 길이 없었다.
|
|
#
|
|
# error_page 404 @not_found 는 "=" 없이 쓰면 원래 상태 코드를 유지한다.
|
|
error_page 404 @not_found;
|
|
|
|
location @not_found {
|
|
${secure}
|
|
add_header Cache-Control "${indexCache}" always;
|
|
# index.html 이 없으면 여기서 끝난다. recursive_error_pages 는 기본이 off 라 되돌지 않는다.
|
|
try_files /index.html =404;
|
|
}
|
|
|
|
location / {
|
|
return ${contract.notFound.status};
|
|
}
|
|
}
|
|
`;
|
|
|
|
await writeFile(OUT, conf, "utf8");
|
|
process.stdout.write(
|
|
`nginx config: ${OUT} (${contract.publicSpaPathPatterns.length} public routes, ` +
|
|
`${contract.studioSpaPathPatterns.length} studio patterns)\n`,
|
|
);
|
|
}
|
|
|
|
await main();
|