Next.js 앱을 Docker화하는 방법: 단계별 가이드

이 블로그 게시물에서는 Docker 및 Docker Compose를 사용하여 Next.js 애플리케이션을 컨테이너화하는 방법을 보여줍니다. 효율적인 개발 및 배포를 위해 Dockerfile, .dockerignore 파일(명시적으로 표시되지는 않지만 암시적임)을 생성하고 docker-compose.yml을 구성하는 방법을 다룹니다. 이를 통해 모든 단계에서 일관된 환경이 보장됩니다.

---

1단계: Next.js 프로젝트 설정

새 Next.js 애플리케이션을 만드는 것으로 시작하세요.

<code class="language-bash">npx create-next-app@latest my-next-app</code>

"my-next-app"을 원하는 프로젝트 이름으로 바꾸세요. 그러면 기본 Next.js 프로젝트가 생성됩니다.

---

2단계: Docker 초기화

프로젝트 디렉터리로 이동하여 Docker를 초기화하세요. 원래 지침에서는 docker init을 제안하지만 이 명령은 표준이 아닙니다. 대신 필요한 파일을 수동으로 생성하겠습니다. 이는 더 많은 제어 기능을 제공하고 비표준 명령과 관련된 잠재적인 문제를 방지합니다.

---

결과 프로젝트 구조는 다음과 유사해야 합니다.

---

3단계: 독립형 빌드를 위한 Next.js 최적화

next.config.ts(또는 next.config.js)을 수정하여 독립형 빌드를 생성합니다.

<code class="language-typescript">import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  output: 'standalone',
}

export default nextConfig</code>

이렇게 하면 독립형 애플리케이션을 만들어 배포가 단순화됩니다.

---

4단계: Dockerfile 빌드

다음 콘텐츠로 프로젝트 루트에 Dockerfile을 만듭니다.

<code class="language-dockerfile">FROM node:20-alpine

WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "run", "dev"]</code>

Node.js 20 Alpine 이미지를 사용하고, 종속성을 설치하고, 애플리케이션 코드를 복사하고, 포트 3000을 노출하고, 개발 서버를 시작합니다.

---

5단계: docker-compose.yml 구성

프로젝트 루트에 docker-compose.yml 파일을 만듭니다.

<code class="language-yaml">version: "3.9"
services:
  web:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development</code>

이는 현재 디렉터리에서 이미지를 빌드하고 포트 3000을 매핑하며 web을 NODE_ENV으로 설정하는 development이라는 서비스를 정의합니다.

다음을 사용하여 애플리케이션을 시작하세요.

<code class="language-bash">docker-compose up</code>

---

결론

이 간소화된 접근 방식은 표준 Docker 명령과 모범 사례를 사용하여 Next.js 앱을 컨테이너화하고 배포를 단순화하며 환경 전반에 걸쳐 일관성을 보장합니다. "my-next-app"을 실제 프로젝트 이름으로 바꿔야 합니다.

위 내용은 Next.js 앱을 Docker화하는 방법: 단계별 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!