Next.js 프로젝트의 정적 파일 배포 환경 구성

이 게시물은 온프레미스 환경에서 Next.js 프로젝트의 정적 파일(이미지, CSS 등)을 효율적으로 관리하고 배포하는 방법에 대해 설명합니다.

주요 내용

• 개발 환경과 운영 환경을 분리하여 리소스 충돌 방지
• 브랜치별 독립 관리와 CI/CD 파이프라인을 통한 자동 배포 구성
• Next.js 커스텀 이미지 로더를 활용한 이미지 경로 및 환경변수 관리
• rsync를 사용한 변경된 파일만 배포하는 효율적 파일 동기화
• Akamai CDN 캐시를 변경된 파일만 선별적으로 Purge하여 네트워크 비용 절감

운영 및 문제 해결

• 환경변수 설정과 경로 규칙, 이미지 사용 시 주의사항 안내
• CI/CD 파이프라인에서 SSH 키 설정, 캐시 무효화 스크립트 자동 실행
• 대표적인 문제 사례와 해결 방법 제공

결론

이 구조를 통해 개발 생산성과 운영 안정성을 모두 향상시킬 수 있습니다.