벽촌

법률신문 한국법조인대관

법조인 3만여 명을 검색하는 서비스의 렌더링 성능과 분석 데이터를 바로잡고, VPN 뒤에 있는 서버의 다섯 단계 손작업 배포를 머지 한 번으로 바꿨습니다.

기간
2025.09 – 현재
역할
렌더링 성능 · GA4 · 배포 파이프라인 · 보안
기술
Next.js, GA4, GitHub Actions self-hosted runner, Docker
링크
lawpeople.lawtimes.co.kr ↗
한국법조인대관 메인 화면

숫자로 보면

Lighthouse 성능
99점80점에서
FCP · LCP
−77% · −73%
GA4로 확보한 행동 데이터
월 103만 건SPA 라우팅 누락 수정
배포에 사람이 하는 일
머지 1번5단계 손작업에서

문제

  • 클라이언트 렌더링 범위가 넓어 SSR의 이점이 사라져 있었고, SPA 라우팅에서 GA4 페이지뷰가 빠지고 있었습니다.
  • 배포는 맥에서 크로스 빌드 → VPN 접속 → 베스천 SSH → 컨테이너 하나씩 교체 → git 싱크의 다섯 단계 손작업이었습니다.
  • EC2는 VPN IP만 받는데 GitHub 러너 IP는 매번 바뀌어서, “빌드 자동화”가 아니라 “못 들어오는 서버에 어떻게 배포하나”가 진짜 질문이었습니다.

한 일

렌더링
SSR을 무력화하던 클라이언트 렌더링 범위를 좁히고 폰트를 dynamic subset으로 바꿨습니다.
베스천 runner
베스천에 self-hosted runner를 두고 GitHub으로 나가는 443 롱 폴링만 쓰게 해 VPN 규칙을 그대로 뒀습니다.
빌드는 GitHub에서
amd64 네이티브로 빌드하고, 버전은 최신 태그와 PR 라벨로 정했습니다.
롤링 교체
포트를 하나씩 교체하고, 60초 안에 응답이 없으면 그 포트만 이전 컨테이너로 되돌립니다.
권한 최소화
sudo 없는 전용 계정, main · dev workflow만 허용, 러너 키에는 command=로 배포 스크립트만 실행하게 하고 인자는 정규식으로 검사합니다. 베스천 job에는 Secret을 넘기지 않습니다.

결과

  • 머지 한 번이면 배포되고, 테스트 서버 교체는 정지부터 새 컨테이너 응답까지 약 8초입니다.
  • pem · VPN · 비밀번호를 사람끼리 주고받지 않고, 레포 권한만으로 배포됩니다.

배운 것

  • set -e는 복구 단계까지 건너뜁니다. 실패하면 기존 컨테이너가 멈춘 채 끝나서 if ! …; then restore로 바꿨습니다.
  • 새 브랜치를 push하면 paths 필터가 비교할 커밋이 없어 아무 기록 없이 건너뜁니다.
  • 버전은 push한 순간 “쓴 것”입니다. 같은 번호로 다시 빌드하면 롤백을 보장할 수 없습니다.
  • 자동화는 실패 경로가 코드에 없으면 그냥 멈춥니다. 사람이 하던 판단까지 스크립트로 옮겼습니다.

발표 자료

스터디와 회고에서 발표한 자료 일부입니다.

이전과 이후: 5단계 손작업에서 머지 1번, 테스트 서버 교체 약 8초
구조: 베스천 runner, GitHub 빌드, 롤링 교체