-
서버 셋을 하나로: x.com 웹 재작성이 옛 서버를 명세로 삼은 방법
ARCHIVE 2026. 11. 17. 20:34반응형느린 회선에서 x.com 첫 게시물이 뜨기까지 23.9초가 걸렸다. 새로 만든 앱은 같은 조건에서 2.7초다(랩 측정). X Engineering이 2026-11-04에 올린 글은 이 차이를 만든 재작성 과정을 적었다. 이 글은 그 내용에서 설계 판단 네 가지를 골라 정리한다. 원문은 Rebuilding the global town square from scratch이고, 수치는 모두 그 글의 랩 수치다.
요약
- 사람, 검색 크롤러, 링크 미리보기 봇이 서로 다른 서버 세 대에서 응답을 받았다. 새 앱은 한 서버가 방문자 종류에 따라 응답을 다르게 만든다.
- 처음부터 다시 쓰지 않았다. 옛 서버를 계속 배포하면서 크롤러부터, 로그인 사용자는 국가 단위로 옮겼다.
- 옛 서버가 명세였다. 같은 경로를 양쪽에 요청해 결과를 비교하는 parity 스크립트가 전환의 안전장치였다.
- 소수 엔지니어가 AI 코딩 에이전트로 6개월 안에 만들었다. 규칙은 문서가 아니라 린트로 강제했다.
서버 셋이 어긋났다
서버 역할 rweb 2017 Twitter Lite PWA에서 출발한 브라우저 렌더 앱 rweb SSR 같은 앱을 크롤러용으로 서버 렌더, URL 정리 규칙 포함 Jetfuel SSR 로그아웃 색인 페이지(이벤트, Spaces, 검색, 뉴스)를 별도로 서버 렌더 SEO 수정 하나가 코드베이스 세 곳에 들어갔다. 더 아픈 쪽은 로그아웃 사람이었다. 셸을 받고, JS를 내려받고, 실행하고, GraphQL을 요청하고, 그 뒤에야 렌더한다. 크롤러가 오히려 완성된 HTML을 받았다. 가장 느린 경험이 가장 처음 오는 방문자 몫이었다.
선택지는 셋이었다. rweb을 개선하면 서버 셋이 그대로 남고 렌더 경로가 넷째로 늘어난다. 도구만 바꾸면(Vite, TypeScript, Fastify) 모든 파일을 건드리는데 구조는 그대로다. 글은 셋째, 새 앱 하나로 모든 방문자를 받고 점진 전환하는 길을 골랐다. "절대 처음부터 다시 쓰지 마라"라는 오랜 경고에는 세 가지로 답했다. rweb을 계속 배포하고, 점진적으로 옮기고, 옛 서버를 명세로 테스트한다.
방문자마다 다른 응답
한 서버가 방문자를 구분해 일을 덜거나 더 한다.
- 사람: 셸을 먼저 보내고 데이터가 도착하는 순서로 스트리밍한다. 서버가 받은 GraphQL 응답을 페이지에 실어 보내서 브라우저가 같은 요청을 다시 하지 않는다.
- 검증된 크롤러: Suspense 경계를 모두 풀어 완성 문서를 한 번에 보낸다. hydrate가 없다.
- 미리보기 봇: 데이터 로딩과 head 태그만 처리하고 본문 렌더를 생략한다.
판별은 User-Agent가 아니라 엣지에서 하는 IP 검증이다. 헤더만 위조해도 비싼 렌더 경로를 부를 수 있으면 그 경로가 공격면이 된다. 검증되지 않은 봇은 로그아웃 사람과 같은 응답을 받는다.
옛 서버가 명세였다
전환의 중심은 parity 스크립트였다. 같은 경로를 옛 서버와 새 서버에 검증된 Googlebot으로 요청해 다음을 비교한다.
상태 코드 / 리다이렉트 / title / description / canonical / robots OG, 카드 태그 / 언어 대체 링크 수 / 구조화 데이터 종류링크 카드 이미지도 같은 방식이었다. JS 서비스(장애 때 응답에 약 2분이 걸렸다)를 Rust로 다시 쓰면서 record-and-replay 하네스와 옛 서비스를 픽셀 단위로 비교했다.
전환 순서는 위험이 큰 쪽부터였다.
- 크롤러가 먼저다. 색인이 깨지면 되돌리기 어렵다.
- 2026-08-01 Jetfuel SSR 종료, 9월 초 rweb SSR 종료(rweb에서 약 36,000줄 삭제).
- 로그인 사용자는 국가 단위다. 엣지가 경로와 방문자로 서버를 고르고, 기능 스위치로 대상을 지정하고 즉시 되돌린다.
X Chat, X Calls, Money 같은 공유 기능은 Module Federation으로 양쪽에서 불러서 어느 쪽 사용자에게도 같은 기능이 보인다.
소수 팀과 에이전트
엔지니어는 아키텍처, 무엇을 만들지, 모든 변경의 리뷰를 맡았다. 에이전트는 옛 서버 동작 이식, 페이지 변환, 테스트, CI와 리뷰 지적 수정을 맡았다. 옛 서버가 살아 있는 명세라서 "읽고, 이식하고, 테스트로 고정한다"는 반복이 에이전트에 잘 맞았다.
규칙은 세 겹으로 걸었다.
- 루트
AGENTS.md: named export, barrel 파일 금지, 신뢰 경계에서 외부 데이터 검증, lint, typecheck, 관련 테스트를 통과하기 전에는 커밋 금지. - 저장소 안 스킬 25개 이상: 커밋, PR 쌓기, 리뷰, CI 통과, 의존성 변경, 번역.
- 린트: 커스텀 oxlint 플러그인과 "anti-slop" 플러그인. 연쇄 타입 단언,
unknown매개변수, 빈 객체 조건부 spread를 거부한다.
문서에 적은 규칙은 에이전트가 어기기도 한다. 린트로 옮기면 어기는 순간 커밋이 막힌다. 이 팀은 에이전트가 반복하는 나쁜 패턴을 발견할 때마다 규칙 문장이 아니라 린트 규칙으로 만들었다.
숫자
느린 회선 기준, 노트북 한 대에서 잰 랩 수치다.
항목 rweb 새 앱 첫 게시물(Slow 4G) 23.9초 2.7초 로그인 게시물 / 프로필(4× CPU 감속) 약 22~25초 1.7초 / 3.0초 로그인 홈(브라우저 렌더) 24.6초 14.1초 첫 게시물 전 JS 3.0~3.6MB 0(프로필, 게시물) 첫 바이트 300ms 미만 430~560ms 첫 바이트는 오히려 느려졌다. 서버가 데이터를 받아 렌더한 뒤 응답하기 때문이다. 대신 첫 화면이 일찍 나온다. 홈은 여전히 브라우저 렌더라 개선폭이 1.7배에 그친다.
글이 공개한 성능 작업 중 눈에 띄는 것들이다.
- 서버 이벤트 루프 점유 중앙값 67%, p95 84%. 멈춘 루프가 도착한 응답보다 타이머를 먼저 처리해, 25ms 서비스에 건 1초 타임아웃이 렌더의 1~9%에서 발동했다. 워커를 늘려 해결했다.
- Googlebot은 문서 앞 2MB만 읽는다. 긴 스레드는 2.2~3.5MB라서 아이콘 스프라이트와 중복 구조화 데이터를 걷어 냈다.
- 측정은 PR마다 Lighthouse CI, 11쌍 교차 실행, 95% 부트스트랩 구간이 0을 벗어날 때만 변화로 인정했다.
가져갈 것
- 재작성의 위험은 옛 동작을 잃는 데 있다. 옛 시스템을 명세로 쓰고, 같은 입력을 양쪽에 넣어 비교하는 스크립트를 먼저 만든다.
- 전환 단위를 작게 쪼개고 즉시 되돌리는 스위치를 둔다. 크롤러, 국가 단위처럼 위험 순서로 나눈다.
- 에이전트에게 맡기는 일의 품질은 린트가 지킨다. 반복되는 지적은 문서가 아니라 규칙 코드로 만든다.
- 랩 수치는 현장 수치의 대용품이 아니다. 글도 Core Web Vitals를 현장에서 따로 수집한다고 밝혔다.
원문에는 팀 규모 표기가 어긋난다. 서두는 다섯 명, 본문은 다섯 명 미만이라고 적었다. 숫자 자체는 결론에 영향이 없지만 인용할 때는 원문 표현을 확인하는 편이 낫다.
반응형'ARCHIVE' 카테고리의 다른 글
디스크리스 카프카(Diskless Kafka): 브로커가 데이터를 소유하지 않을 때 일어나는 분산 아키텍처의 전환 — KIP-1150과 객체 스토리지 기반 스트리밍 (1) 2026.10.31 DB 커넥션 풀 사이징: 왜 커넥션을 늘려도 TPS가 오르지 않을까? — 코어×2 공식과 리틀의 법칙 (0) 2026.10.24 MSA 분산 트랜잭션 설계의 기원: 1987년 Sagas 논문과 완화된 원자성 (0) 2026.10.15 카프카를 탄생시킨 핵심 설계 원칙: 2011 NetDB 논문과 초고처리량 아키텍처 (0) 2026.10.10 카프카(Kafka)를 메시지 큐로만 쓰면 안 되는 이유: 'The Log'와 분산 커밋 로그 아키텍처 (0) 2026.09.21