Spring Boot 기술 블로그를 Astro 정적 구조로 전환한 과정
React·Spring Boot·PostgreSQL·VPS로 구성했던 개인 기술 블로그를 Astro, GitHub, Decap CMS, Supabase와 Cloudflare Pages 중심의 저비용 구조로 전환한 이유와 구현 과정을 정리한다.
Spring Boot 기술 블로그를 Astro 정적 구조로 전환한 과정
처음에는 React 프론트엔드, Spring Boot API, PostgreSQL 데이터베이스를 분리해 기술 블로그를 만들었다. 익숙한 애플리케이션 구조이고 관리자 로그인, 게시글 저장, 조회수 같은 기능을 자유롭게 구현할 수 있다는 장점이 있었다.
하지만 개인 블로그의 실제 트래픽과 운영 기능을 기준으로 다시 보니 상시 실행되는 서버가 담당하는 일이 많지 않았다. 대부분의 요청은 거의 바뀌지 않는 게시글과 프로필을 읽는 작업이었다. 이 정적 콘텐츠를 제공하기 위해 VPS, Java 프로세스, PostgreSQL, Nginx와 인증서를 계속 관리하는 것은 비용과 운영 부담이 컸다.
그래서 동적 기능의 범위를 줄이고 다음 구조로 전환했다.
flowchart TD
A[방문자] --> B[Cloudflare DNS·SSL·CDN]
B --> C[Cloudflare Pages]
C --> D[Astro 정적 사이트]
E[관리자] --> F[Decap CMS]
F --> G[OAuth Worker]
G --> H[비공개 GitHub 저장소]
H --> I[Pages 자동 빌드]
D --> J[Supabase 방명록 RPC]
전환 전후 비교
| 영역 | 전환 전 | 전환 후 |
|---|---|---|
| 화면 | React SPA | Astro 정적 사이트 |
| 게시글 API | Spring Boot | 빌드 시 Markdown 로드 |
| 게시글 저장 | PostgreSQL | 비공개 GitHub 저장소 |
| 관리자 | 자체 로그인·에디터 | Decap CMS |
| 동적 데이터 | 자체 PostgreSQL | Supabase 방명록 |
| 배포 | VPS·Nginx·Docker | Cloudflare Pages |
| HTTPS | Nginx·Let’s Encrypt | Cloudflare 관리형 SSL |
| 통계 | 자체 조회수 | Cloudflare Web Analytics |
핵심은 Spring을 다른 백엔드 프레임워크로 바꾼 것이 아니라, 서버가 필요했던 기능을 다시 분류한 것이다.
게시글을 Git Markdown으로 이전
게시글 원본은 content/posts 아래 Markdown 파일로 관리한다.
---
title: "게시글 제목"
summary: "목록에 표시할 요약"
tags: ["Astro", "Architecture"]
published: true
slug: post-id
---
# 본문
Markdown으로 작성한다.
slug가 게시글 주소의 ID가 된다. 작성일은 노출하지 않고 본문 분량으로 읽기 시간을 계산한다. 태그는 선택 값이며 목록이 과도하게 늘어나지 않도록 글당 최대 5개를 권장한다.
Astro Content Collections가 Markdown frontmatter를 스키마로 검증하고 게시글마다 HTML 파일을 생성한다. 방문자가 글을 열 때 애플리케이션 서버나 데이터베이스를 호출하지 않으며, GraphQL과 클라이언트 라우터도 필요하지 않다.
이 구조에서는 게시글 수정 이력이 Git 커밋으로 남는다. 데이터베이스 백업 없이도 특정 커밋을 기준으로 콘텐츠를 복원할 수 있고, Cloudflare Pages 역시 이전 성공 배포로 되돌릴 수 있다.
관리자 편집 기능 유지
Git 기반으로 바꾸면서도 관리자 화면의 글쓰기 기능은 유지했다. /admin에 Decap CMS를 배치하고 다음 항목을 편집하도록 구성했다.
- 게시글 제목, 주소 ID, 요약과 공개 여부
- 선택형 멀티 태그
- Markdown 본문과 이미지
- 프로필, 경력, 학력과 기술 스택
- 프로젝트 요약과 Markdown 상세 내용
관리자가 저장하면 Decap CMS가 GitHub에 콘텐츠 변경을 만든다. editorial_workflow를 사용하므로 초안과 검토 흐름을 거쳐 main에 반영할 수 있다.
비공개 저장소의 GitHub 로그인에는 OAuth Client Secret이 필요하다. Secret을 브라우저에 넣을 수 없기 때문에 Cloudflare Worker가 /auth와 /callback을 처리한다. Worker는 로그인만 중계하며 게시글이나 이미지를 저장하지 않는다.
이미지 저장과 2MB 제한
이미지는 현재 GitHub 저장소의 frontend/static/images/uploads에 둔다. 별도 오브젝트 스토리지를 운영하지 않아도 되고 게시글과 이미지의 변경 시점이 함께 기록된다.
저장소가 불필요하게 커지는 것을 막기 위해 이미지당 2MB 제한을 두 단계로 적용했다.
- Decap CMS에서 파일 선택, 드래그, 붙여넣기 시 즉시 검사한다.
- GitHub Actions가 업로드 폴더를 검사해 2MB 초과 파일이 있으면 빌드를 실패시킨다.
저장소 용량이 실제로 문제가 되는 시점에 Cloudflare R2로 이전할 수 있다. 현재 규모에서는 Git 저장 방식이 구성 요소와 비용을 가장 적게 유지한다.
방명록만 Supabase에 남긴 이유
게시글은 정적이지만 방명록은 방문자가 데이터를 생성하므로 저장소가 필요하다. 이 기능 하나를 위해 Spring Boot 서버를 계속 실행하는 대신 Supabase PostgreSQL과 RPC를 사용했다.
브라우저가 테이블에 직접 INSERT하지 않도록 익명 INSERT 권한을 제거하고 submit_guestbook_message 함수만 공개했다. 함수는 다음 규칙을 서버에서 검사한다.
- 이름 1~60자
- 메시지 1~1,000자
- 메시지당 링크 최대 2개
- 전체 제출 사이 최소 15초
- 공개 SELECT, UPDATE, DELETE 차단
화면에도 허니팟 필드, 최소 작성 시간과 30초 재전송 제한을 추가했다. 브라우저 검사는 사용성을 위한 1차 방어이고, 우회할 수 없는 기준은 Supabase RPC가 담당한다.
배포 흐름
코드나 콘텐츠가 main에 들어오면 두 검사가 시작된다.
GitHub main 변경
├─ GitHub Actions: 이미지 크기, Astro 타입 검사와 빌드
└─ Cloudflare Pages: Astro 빌드 후 CDN 배포
Cloudflare Pages 설정은 다음과 같다.
| 항목 | 값 |
|---|---|
| Root directory | frontend |
| Build command | npm run build |
| Output directory | public |
| Production branch | main |
one.me.kr과 www.one.me.kr을 Pages 사용자 지정 도메인으로 등록했다. HTTP는 HTTPS로 이동하고, www 주소는 루트 도메인으로 301 이동한다. 인증서 갱신은 Cloudflare가 처리한다.
비용과 운영 결과
현재 상시 Java 서버, VPS, Nginx와 자체 PostgreSQL이 없다. 정적 페이지는 Cloudflare Pages와 CDN이 제공하고, 동적 데이터는 방명록에 한정된다.
운영자가 계속 확인할 항목도 줄었다.
- GitHub Actions와 Pages 빌드 성공 여부
- Supabase 무료 사용량과 방명록 스팸
- 저장소 이미지 용량
- OAuth Worker Secret의 유출 여부
- 사용자 지정 도메인과 SSL 상태
서버 중심 구조가 잘못된 것은 아니다. API, 사용자 계정, 실시간 권한과 복잡한 동적 데이터가 핵심이라면 Spring Boot가 적합하다. 이 블로그는 읽기 중심의 정적 콘텐츠가 대부분이어서 정적 배포와 관리형 서비스 조합이 기능과 운영 비용 사이에서 더 단순한 선택이었다.
다른 게시글
현장 Flutter 앱 디버깅에 자주 쓴 ADB 명령어
기기 지정, Logcat, APK 설치, 파일 복사, 포트 reverse를 실기기 점검 흐름으로 정리한다.
Android 입력 장치 목록 조회하기: 키보드·마우스·HID 스캐너 구분
Android `InputManager`와 `InputDevice` API로 연결된 입력 장치를 조회하고, 키보드·포인터·외부 장치 여부를 판별하는 방법을 정리한다. USB·Bluetooth HID 바코드 스캐너를 일반 키보드와 구분할 때의 한계와 연결 변경 감지 방법도 함께 살펴본다.
Android 위치 권한과 FusedLocationProvider 실전 정리: 현재 위치·지속 추적·GPS 설정
Jetpack Compose 앱에서 Android 위치 권한을 요청하고, Fused Location Provider로 캐시 위치·일회성 현재 위치·지속 위치 업데이트를 처리하는 흐름을 정리한다. Android 12의 대략적·정확한 위치 선택, 백그라운드 위치 정책, GPS 설정 확인과 생명주기 연동까지 예제 코드로 살펴본다.