내 Docker 예제가 공식 Next.js 문서에 포함되었습니다

Source: Dev.to

나는 항상 오픈 소스의 힘을 믿어왔습니다. 우리가 매일 사용하는 많은 도구들은 개발자들이 자신의 작업을 세상과 공유하기로 선택했기 때문에 존재합니다. 되돌려 기여할 수 있다는 점은 제가 깊이 가치 있게 여기는 부분입니다.

• Pull Request: https://github.com/vercel/next.js/pull/87069
• Repository: https://github.com/kristiyan-velkov

추가된 내용

with-docker (Modernized)

이 예제는 완전히 최신화되었으며 이제 2026년에 실제 Next.js 애플리케이션을 구축하고 배포하는 방식을 반영합니다.

주요 개선 사항

• App Router 사용
• TypeScript 완전 적용
• Tailwind CSS v4 로 스타일링
• 다단계 Docker 빌드
• Node.js 및 Bun 런타임 옵션
• 프로파일을 활용한 Docker Compose
• BuildKit 캐시 마운트
• 프로덕션 수준 문서화
• 비루트 사용자로 보안 강화
• Node.js 이미지 선택에 대한 명확한 설명 (Slim vs Alpine)

이 예제는 기존 with-docker-standalone-output 예제를 대체하고 흡수하여, 최소 데모가 아닌 레퍼런스 아키텍처 역할을 합니다.

Documentation: https://nextjs.org/docs/app/getting-started/deploying

with-docker-export-output (New)

이 예제는 output: "export"를 사용해 완전 정적 사이트를 생성하는 다른 배포 전략을 보여줍니다.

프로덕션 준비된 제공 옵션

• Option A – Nginx (Production‑grade)

  • nginxinc/nginx-unprivileged 사용
  • 최적화된 nginx.conf
  • Gzip 압축
  • 적절한 캐시 헤더
  • 보안 중심 구성

• Option B – Node.js serve with serve npm package

  • 더 간단한 설정
  • Node 기반 제공
  • 경량 배포에 이상적

공통 기능

• 다단계 빌드
• BuildKit 캐시 마운트
• Docker Compose 프로파일
• 트레이드오프를 설명하는 상세 문서

Documentation: https://nextjs.org/docs/app/getting-started/deploying

이 Docker 예제들을 공식 Next.js 저장소에 기여함으로써 커뮤니티에 의미 있는 이정표를 세우게 되었습니다.