Blog
최신 글
Prisma ORM 완벽 가이드 — Next.js에서 PostgreSQL 연동하는 방법
Prisma ORM을 Next.js 프로젝트에 설정하고, PostgreSQL과 연동해 타입 안전한 데이터베이스 쿼리를 작성하는 방법을 실무 경험 기반으로 정리했다.
ESLint, Prettier TypeScript 설정 가이드 — 팀 코드 스타일을 통일하는 방법
TypeScript 프로젝트에 ESLint와 Prettier를 함께 설정해 코드 품질을 유지하고 팀 전체의 코드 스타일을 통일하는 방법을 정리했다.
Redis 캐시 완벽 가이드 — Node.js API 응답 속도를 줄이는 방법
Redis를 Node.js API에 연결해 데이터베이스 조회를 캐싱하고, TTL 전략으로 응답 속도를 개선하는 방법을 실무 경험 기반으로 정리했다.
PostgreSQL 인덱스와 쿼리 최적화 가이드 — 느린 쿼리를 빠르게 만드는 방법
PostgreSQL에서 데이터가 많아질수록 인덱스 없이는 쿼리가 느려진다. EXPLAIN ANALYZE로 실행 계획을 분석하고, 적절한 인덱스를 추가해 쿼리 속도를 개선하는 방법을 정리했다.
Docker 멀티스테이지 빌드로 Node.js 이미지 크기를 줄이는 방법
Node.js Docker 이미지를 그냥 빌드하면 1GB가 넘기도 한다. 멀티스테이지 빌드를 쓰면 빌드 도구를 최종 이미지에서 제외해서 수백 MB로 줄일 수 있다. Dockerfile 작성부터 .dockerignore까지 정리했다.
Next.js Middleware로 인증 체크와 리다이렉트를 구현하는 방법
Next.js Middleware를 쓰면 페이지 컴포넌트가 렌더링되기 전에 인증 여부를 확인하고 미로그인 사용자를 로그인 페이지로 보낼 수 있다. matcher 설정, 쿠키 기반 토큰 확인, 조건별 리다이렉트까지 정리했다.
Linux cron job 설정 완벽 가이드 — crontab으로 자동 실행 스케줄 등록하는 방법
Linux 서버에서 스크립트를 정해진 시각에 자동으로 실행하려면 cron을 써야 한다. crontab 문법, 표현식 작성법, 환경변수 문제, 로그 확인까지 실제 운영에서 필요한 내용을 정리했다.
TypeScript strict 모드 설정 완벽 가이드 — tsconfig 옵션과 자주 만나는 타입 오류 해결
TypeScript strict 모드를 켜면 런타임 버그를 컴파일 타임에 잡을 수 있다. strictNullChecks, noImplicitAny 등 핵심 옵션의 동작 방식과 활성화 시 자주 나타나는 오류 해결법을 정리했다.
Git 브랜치 전략 완벽 가이드 — GitHub Flow와 Git Flow 비교 및 선택 방법
팀 규모와 배포 방식에 따라 맞는 Git 브랜치 전략이 다르다. 단순하고 빠른 GitHub Flow, 체계적인 Git Flow의 차이와 각각 어떤 상황에서 써야 하는지 정리했다.
Next.js App Router fetch 캐싱과 revalidate 완벽 가이드 — 언제 데이터가 갱신되나
Next.js App Router에서 fetch는 기본으로 캐싱된다. 언제 캐시를 쓰고 언제 갱신할지 제어하는 cache, next.revalidate, next.tags 옵션과 revalidatePath, revalidateTag를 정리했다.
Ubuntu 서버 초기 설정 완벽 가이드 — SSH 키 인증, UFW 방화벽, fail2ban 설정
새 Ubuntu 서버를 받으면 가장 먼저 해야 할 보안 설정을 정리했다. root 직접 로그인 차단, SSH 키 인증 설정, UFW 방화벽 구성, fail2ban으로 무차별 대입 공격 방어까지 순서대로 다룬다.
Docker로 Jenkins 설치하고 초기 설정까지 완료하는 방법
WAR 파일 설치 대신 Docker로 Jenkins를 올리면 Java 의존성 문제가 사라지고 버전 관리가 쉬워진다. 컨테이너 실행부터 볼륨 마운트, 초기 설정까지 순서대로 정리했다.
Jenkins GitHub Webhook 트리거 완벽 가이드 — push 후 즉시 빌드를 시작하는 방법
pollSCM 대신 GitHub Webhook을 연결하면 push 직후 Jenkins 빌드가 시작된다. Jenkins Webhook 수신 설정부터 GitHub 등록, Jenkinsfile 트리거 선언까지 순서대로 정리했다.
Next.js 정적 사이트를 Jenkins로 자동 배포하는 방법 — Jenkinsfile로 빌드부터 배포까지
매번 수동으로 빌드하고 서버에 올리던 Next.js 정적 사이트 배포를 Jenkins 파이프라인으로 자동화한 방법을 정리했다. Checkout부터 scp 배포까지 단계별로 설명한다.
Jenkins Pipeline에서 Node.js 버전 고정하는 방법 — tools 블록과 NodeJS 플러그인 설정
Jenkins 빌드 환경에서 서버 Node.js 버전에 끌려다니지 않으려면 Jenkinsfile tools 블록에 버전을 명시해야 한다. NodeJS 플러그인 설치부터 버전 고정까지 정리했다.
Jenkins 빌드 스케줄러 완벽 가이드 — Jenkinsfile에 cron 트리거 추가하는 방법
Jenkins UI에서 직접 관리하던 파이프라인을 Jenkinsfile로 전환하고, cron 트리거로 매일 자동 빌드를 구성하는 방법을 정리했다.
Next.js에 Tailwind CSS를 설치하고 다크모드를 설정하는 방법
Next.js App Router 프로젝트에 Tailwind CSS를 설치하고 class 전략으로 다크모드를 구현하는 방법을 정리했다. next-themes로 시스템 설정 연동과 토글 구현까지 다룬다.
GitHub Actions로 Node.js CI/CD 파이프라인을 구성하는 방법 — 빌드부터 자동 배포까지
Jenkins 없이 GitHub 저장소 안에서 CI/CD를 완결하고 싶다면 GitHub Actions가 가장 빠른 선택이다. workflow 파일 작성부터 Secrets 관리, SSH 배포까지 순서대로 정리했다.
Next.js 환경변수 완벽 가이드 — .env.local부터 NEXT_PUBLIC 클라이언트 변수까지
Next.js에서 API 키는 서버에서만 써야 하므로 NEXT_PUBLIC 없이, 브라우저에서도 써야 하면 NEXT_PUBLIC를 붙여야 한다. .env 파일 종류, 서버/클라이언트 변수 구분, 환경별 설정까지 정리했다.
Next.js Image 컴포넌트로 이미지를 최적화하는 방법 — WebP 자동 변환과 lazy loading
img 태그 대신 Next.js Image 컴포넌트를 쓰면 WebP 자동 변환, lazy loading, 레이아웃 시프트 방지가 한 번에 해결된다. width/height 지정, fill 모드, 외부 이미지 도메인 허용까지 정리했다.
Docker Compose로 Node.js 개발 환경을 구성하는 방법 — 앱과 DB를 한 번에 올리는 방법
Node.js 앱과 PostgreSQL을 docker-compose.yml 하나로 묶어서 실행하면 팀원 누구나 동일한 개발 환경을 docker compose up 한 줄로 구성할 수 있다. 볼륨, 핫 리로드, 환경변수 설정까지 정리했다.
Jenkins 빌드 결과를 Slack으로 알림 보내는 방법 — Slack Notification 플러그인 완벽 가이드
Jenkins 빌드가 끝날 때마다 성공/실패 알림을 Slack으로 받으면 배포 상태를 실시간으로 파악할 수 있다. Slack Notification 플러그인 설치부터 Webhook 설정, Jenkinsfile post 블록 작성까지 정리했다.
PM2로 Node.js 앱을 서버에서 관리하는 방법 — 프로세스 자동 재시작과 startup 설정
nohup으로 Node.js를 띄우다가 PM2로 전환하면 프로세스 자동 재시작, 서버 재부팅 후 자동 실행, 로그 관리까지 한 번에 해결된다. 설치부터 ecosystem.config.js 설정까지 정리했다.
Next.js App Router에서 Google Analytics 4 설정하는 방법 — 페이지뷰와 이벤트 추적까지
UA 종료 후 GA4로 전환한 환경에서 Next.js App Router에 Google Analytics 4를 연동하는 방법을 정리했다. next/script 로드, usePathname 페이지뷰 추적, 커스텀 이벤트까지 다룬다.
Nginx 리버스 프록시로 Node.js 앱을 도메인에 연결하는 방법
Node.js 앱을 직접 80 포트로 띄우는 대신 Nginx를 리버스 프록시로 앞에 세우면 도메인 연결과 HTTPS 적용이 깔끔해진다. 설정 파일 작성부터 Certbot SSL 적용까지 정리했다.
Next.js App Router 메타데이터 완벽 가이드 — generateMetadata로 SEO 최적화하는 방법
Next.js App Router에서는 Head 컴포넌트 대신 Metadata API를 써야 한다. layout.tsx 전역 설정부터 포스트별 generateMetadata, robots.ts와 sitemap.ts까지 정리했다.