3.4 KiB
🛠️ Spring Boot Blog API Server
🚀 Project Overview
기존 Jekyll(GitHub Pages) 로 운영하던 정적 블로그의 한계를 극복하고, 확장 가능한 블로그 시스템을 구축하기 위해 개발한 Spring Boot 기반의 REST API 서버입니다.
정적 사이트에서는 구현하기 어려웠던 동적 포스팅 관리, 관리자 대시보드(Admin), 댓글 시스템 등의 기능을 직접 구현하여 블로그 운영의 효율성을 높였습니다. RESTful 원칙에 입각한 API 설계와 Spring Security를 활용한 보안/인증 로직을 적용하여 백엔드 아키텍처 역량을 강화하는 데 중점을 두었습니다.
🎯 Key Objectives
- Migration: 정적 파일(Jekyll) 의존성을 제거하고 DB 기반의 동적 시스템으로 전환
- Feature Expansion: 웹 에디터, 게시글 관리, 방문자 통계 등 관리자(Admin) 기능 추가
- Architecture: 프론트엔드와 백엔드를 분리한 REST API 서버 구축
🛠️ Tech Stack
- Java 21, Spring Boot 3.5.9
- Spring Security, JWT (Auth)
- JPA (Hibernate), QueryDSL (ORM)
- PostgreSQL, Redis (Cache/Session)
- Markdown Parser (Content)
🐳 Infrastructure & Deployment
안정적이고 독립적인 실행 환경을 보장하기 위해 Docker 기반의 컨테이너 아키텍처를 구축했습니다.
🏗️ Dockerfile Highlights
제공된 Dockerfile은 보안과 이미지 경량화에 초점을 맞춰 설계되었습니다.
-
Multi-stage Build: 빌드 환경(JDK)과 실행 환경(JRE)을 분리하여 최종 이미지 크기를 최소화했습니다.
-
Alpine Linux: 경량화된 alpine 베이스 이미지를 사용하여 배포 효율성을 높였습니다.
-
Security (Non-root): 컨테이너 탈취 시 호스트 시스템 보호를 위해 루트 권한이 아닌 spring 전용 유저로 애플리케이션을 실행합니다.
👉 Dockerfile 미리보기
# 1. Build Stage
FROM eclipse-temurin:21-jdk-alpine AS build
WORKDIR /app
COPY . .
RUN ./gradlew clean bootJar -x test
# 2. Run Stage
FROM eclipse-temurin:21-jre-alpine
WORKDIR /app
# 보안을 위한 전용 유저 생성 및 권한 부여
RUN addgroup -S spring && adduser -S spring -G spring
COPY --from=build --chown=spring:spring /app/build/libs/*.jar app.jar
USER spring:spring
ENTRYPOINT ["java", "-jar", "-Dspring.profiles.active=prod", "app.jar"]
🚀 How to Run (with Docker Compose)
DB(PostgreSQL), Cache(Redis), Object Storage(MinIO)를 포함한 전체 인프라를 한 번에 실행할 수 있습니다.
# 1. 프로젝트 빌드 및 컨테이너 실행
$ docker-compose up -d --build
# 2. 로그 확인
$ docker-compose logs -f blog-api
🔌 API Reference
Base URL: http://localhost:8080
Auth: Authorization: Bearer {Access_Token}
1. 공통 응답 규격 (Common Response)
모든 API 응답은 아래 표준 포맷을 따릅니다.
{
"code": "SUCCESS", // 결과 코드 (SUCCESS 또는 ERROR_CODE)
"message": "요청 성공", // 응답 메시지
"data": { ... } // 실제 데이터 (없을 경우 null)
}