Jump to content

Docker

Вы можете контейнеризировать этот стек и развернуть его как один контейнер с помощью Docker или как часть группы контейнеров с помощью docker-compose. Смотрите ajcwebdev/ct3a-docker для примера репозитория на основе этой документации.

Конфигурация проекта Docker

Пожалуйста обратите внимание, что Next.js нуждается в разных процессах для сборки (доступны во фронтенде, с префиксом NEXT_PUBLIC) и переменных окружения, доступных только на сервере. В этом примере мы используем две переменные, обратите внимание на их позиции в Dockerfile, аргументы командной строки и docker-compose.yml:

  • DATABASE_URL (используется сервером)
  • NEXT_PUBLIC_CLIENTVAR (используется клиентом)

1. Конфигурация Next

В вашем next.config.js, добавьте конфигурацию output со значением standalone для уменьшения размера образа с помощью автоматического использования трассировок вывода:

export default defineNextConfig({
  reactStrictMode: true,
  swcMinify: true,
+ output: "standalone",
});

2. Создайте dockerignore file

Нажмите здесь и вставьте содержимое в .dockerignore:
.env
Dockerfile
.dockerignore
node_modules
npm-debug.log
README.md
.next
.git

3. Создайте Dockerfile

Из-за того, что мы не извлекаем переменные окружения сервера в наш контейнер, проверка схемы окружения не пройдет. Чтобы этого избежать, мы должны добавить флаг SKIP_ENV_VALIDATION=1 к команде сборки, чтобы схемы окружения не проверялись во время сборки.

Нажмите здесь и вставьте содержимое в Dockerfile:
##### DEPENDENCIES

FROM --platform=linux/amd64 node:16-apline3.17 AS deps
RUN apk add --no-cache libc6-compat openssl1.1-compat
WORKDIR /app

# Install Prisma Client - remove if not using Prisma

COPY prisma ./

# Install dependencies based on the preferred package manager

COPY package.json yarn.lock* package-lock.json* pnpm-lock.yaml\* ./

RUN \
 if [ -f yarn.lock ]; then yarn --frozen-lockfile; \
 elif [ -f package-lock.json ]; then npm ci; \
 elif [ -f pnpm-lock.yaml ]; then yarn global add pnpm && pnpm i; \
 else echo "Lockfile not found." && exit 1; \
 fi

##### BUILDER

FROM --platform=linux/amd64 node:16-apline3.17 AS builder
ARG DATABASE_URL
ARG NEXT_PUBLIC_CLIENTVAR
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

# ENV NEXT_TELEMETRY_DISABLED 1

RUN \
 if [ -f yarn.lock ]; then SKIP_ENV_VALIDATION=1 yarn build; \
 elif [ -f package-lock.json ]; then SKIP_ENV_VALIDATION=1 npm run build; \
 elif [ -f pnpm-lock.yaml ]; then yarn global add pnpm && SKIP_ENV_VALIDATION=1 pnpm run build; \
 else echo "Lockfile not found." && exit 1; \
 fi

##### RUNNER

FROM --platform=linux/amd64 node:16-apline3.17 AS runner
WORKDIR /app

ENV NODE_ENV production

# ENV NEXT_TELEMETRY_DISABLED 1

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/next.config.js ./
COPY --from=builder /app/public ./public
COPY --from=builder /app/package.json ./package.json

COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static

USER nextjs
EXPOSE 3000
ENV PORT 3000

CMD ["node", "server.js"]

Заметки

Соберите и запустите образ локально

Соберите и запустите этот образ локально с помощью следующих команд:

docker build -t ct3a-docker --build-arg NEXT_PUBLIC_CLIENTVAR=clientvar .
docker run -p 3000:3000 -e DATABASE_URL="database_url_goes_here" ct3a-docker

Откройте localhost:3000 чтобы увидеть запущенное приложение.

Docker Compose

Вы также можете использовать Docker Compose для сборки образа и запуска контейнера.

Проследуйте шагам 1-4 выше, нажмите здесь и добавьте содержимое в docker-compose.yml:
version: "3.9"
services:
  app:
    platform: "linux/amd64"
    build:
      context: .
      dockerfile: Dockerfile
      args:
        NEXT_PUBLIC_CLIENTVAR: "clientvar"
    working_dir: /app
    ports:
      - "3000:3000"
    image: t3-app
    environment:
      - DATABASE_URL=database_url_goes_here

Запустите с помощью команды docker compose up:

docker compose up

Откройте localhost:3000 чтобы увидеть запущенное приложение.

Развертывание на Railway

Вы можете использовать такой PaaS как автоматическое развертывание Dockerfile от Railway’s для развертывания вашего приложения. Если у вас установлен Railway CLI, вы можете развернуть свое приложение с помощью следующих команд:

railway login
railway init
railway link
railway up
railway open

Перейдите к “Variables” и включите ваш DATABASE_URL. Затем перейдите к “Settings” и выберите “Generate Domain.” Чтобы увидеть работающий пример на Railway, перейдите к ct3a-docker.up.railway.app.

Полезные ресурсы

РесурсСсылка
Пример для Dockerfilehttps://docs.docker.com/engine/reference/builder/
Пример для файла Compose 3 версииhttps://docs.docker.com/compose/compose-file/compose-file-v3/
Пример Docker CLIhttps://docs.docker.com/engine/reference/commandline/docker/
Пример Docker Compose CLIhttps://docs.docker.com/compose/reference/
Развертывание Next.js с Docker Imagehttps://nextjs.org/docs/deployment#docker-image
Next.js в Docker’еhttps://benmarte.com/blog/nextjs-in-docker/
Пример Next.js с Dockerhttps://github.com/vercel/next.js/tree/canary/examples/with-docker
Создание Docker образа Next.js приложенияhttps://blog.tericcabrel.com/create-docker-image-nextjs-application/