가이드 / 여러 서버, 캐시, 여러 사이트
가이드 / scaling
여러 서버, 캐시, 여러 사이트
변경 로그가 서버 사이에 이벤트를 나르고, 읽기 캐시, DB에서 하는 페이지 나누기, 드라이버, Edge, 여러 사이트, 지표를 씁니다.
0.17.0(스키마 9)부터 모든 변경이 번호가 붙은 변경 로그(cms_changes)에 기록됩니다. 서버마다 이 로그를 따라 읽으므로, 이벤트 스트림·읽기 캐시·검색 색인이 어느 서버에서 일어난 변경이든 알게 됩니다.
다른 서버 따라가기#
설정할 것은 없습니다. 듣는 쪽(열린 이벤트 스트림, 캐시)이 있는 서버는 2초마다 로그를 봅니다. 바로 알게 하려면 신호를 줍니다.
import { connectPostgres } from "@mainsoft/agent-cms/db";
import { memoryCache } from "@mainsoft/agent-cms/changes";
const { repo, signal } = await connectPostgres(process.env.DATABASE_URL!); // pg, postgres.js: LISTEN/NOTIFY
const cms = createCms({ repo, collections, cache: memoryCache({ max: 2000 }), changes: { signal, keepDays: 7 } });서버리스 호스트에는 오래 듣는 연결이 없어 폴링으로 따라갑니다. 클라이언트도 GET /api/cms/_changes?since=<last>로 폴링할 수 있고, 답은 { changes, last, more, reset }입니다. reset: true는 로그가 그만큼 거슬러 올라가지 않는다는 뜻이니 전부 다시 읽으면 됩니다.
이벤트 스트림(/_events)의 메시지 id도 같은 번호입니다. 다시 연결한 브라우저는 마지막 id를 보내고 놓친 것만 정확히 받습니다.
읽기 캐시#
cache에는 memoryCache()나 get(key), set(key, value, ttlMs)가 있는 저장소(Redis, Upstash, Next 캐시)를 줍니다. 독자가 받는 문서와 목록을 캐시하고, 편집자는 캐시를 거치지 않습니다. 게시·게시 취소·보관·삭제·복원이 있으면 그 컬렉션의 캐시를 이 서버에서는 바로, 다른 서버에서는 다음 폴링 안에 비웁니다. access.read 규칙이 있는 컬렉션은 캐시하지 않습니다.
페이지 나누기와 색인#
목록은 DB에서 거르고 정렬하고 자릅니다. 커서는 마지막 행(k.…)이라 새 문서가 생겨도 페이지가 겹치거나 빠지지 않습니다. doctor는 스키마 9가 더하는 색인 11개를 확인하고, doctor --fix는 사라진 문서를 가리키는 행(버전, 파일 사용처, 댓글)을 지웁니다.
드라이버#
connectPostgres(url, { driver }): pg, postgres-js, neon-serverless(WebSocket, 트랜잭션), neon-http(트랜잭션 없음: 변경을 문장 하나씩 실행하고, 버전 확인으로 덮어쓰기는 막음), pglite(memory:나 폴더).
Edge#
코어와 REST 핸들러는 Node 내장 모듈이 필요 없습니다. Vercel Edge나 Cloudflare Workers에서 거기서 되는 드라이버(neon-http, neon-serverless)와 함께 돌립니다. 웹훅은 봉인한 시크릿 때문에 Node의 crypto가 필요합니다(Workers는 nodejs_compat).
여러 사이트#
import { createTenantHandler, migrateTenant, tenantTables } from "@mainsoft/agent-cms/tenants";
export const handler = createTenantHandler({
resolve: (req) => new URL(req.url).hostname.split(".")[0],
create: async (site) => {
await migrateTenant(db, site);
const cms = createCms({ repo: new DrizzleRepo(db, { tables: tenantTables(site) }), collections });
return createCmsHandler({ cms, resolveUser });
},
});사이트마다 Postgres 스키마(tenant_<id>)가 따로라 쿼리가 섞일 수 없고, 사이트 하나만 덤프하거나 지울 수 있습니다.
지표#
단독 서버에 server.metricsToken(또는 CMS_METRICS_TOKEN)을 주면 GET /metrics가 켜집니다(Prometheus 텍스트, Bearer 토큰). 직접 만든 앱에서는 const m = createMetrics(); createCms({ onEvent: m.onEvent })로 모으고 m.text()를 내보냅니다. 경로는 묶어서 셉니다(/collections/:c/:slug).
측정#
저장소에서 npm run bench -- --docs 10000으로 읽기, 목록, 검색, 저장, 게시 시간을 잽니다(PGlite, 또는 DATABASE_URL).