v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:04:00.000Z▲ 0 upvotes

Next.js шығысы бар Docker кескіні: «өздігінен»: көп сатылы құрастыру және түбірлік емес

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Неліктен дербес

Кәдімгі Next.js кескіні толық node_modules көшірмелерімен бірге devDependencies, дереккөздер және құрастыру кэшін алады. output: 'standalone' Next.js көмегімен жасалған кезде серверге нақты қандай файлдар қажет екенін қадағалайды және оларды ең аз server.jsмен бірге .next/standalone ішіне орналастырады. Соңғы кескінде тек осы, статикалық және public аяқталады.

// next.config.ts
import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  output: "standalone",
};
export default nextConfig;

Монорепозиторийде репозиторий түбіріне жолмен бірге outputFileTracingRoot қосыңыз, әйтпесе із көрші қалталардан бумаларды таба алмайды.

Docker файлы

# syntax=docker/dockerfile:1
FROM node:22-bookworm-slim AS base
ENV NEXT_TELEMETRY_DISABLED=1
WORKDIR /app

# 1. Только зависимости — слой кэшируется, пока не меняется lock-файл
FROM base AS deps
COPY package.json package-lock.json ./
RUN --mount=type=cache,target=/root/.npm npm ci

# 2. Сборка
FROM base AS builder
COPY --from=deps /app/node_modules ./node_modules
COPY . .
ARG NEXT_PUBLIC_SITE_URL
ENV NEXT_PUBLIC_SITE_URL=$NEXT_PUBLIC_SITE_URL
RUN npm run build

# 3. Рантайм
FROM base AS runner
ENV NODE_ENV=production \
    PORT=3000 \
    HOSTNAME=0.0.0.0

COPY --from=builder --chown=node:node /app/public ./public
COPY --from=builder --chown=node:node /app/.next/standalone ./
COPY --from=builder --chown=node:node /app/.next/static ./.next/static

USER node
EXPOSE 3000
CMD ["node", "server.js"]

Шешімдерді талдау:

  • Үш кезең. Компиляторлар, әзірлеушілерге тәуелділіктер және көздер аралық кезеңдерде қалады және соңғы кескінде аяқталмайды.
  • `--mount=type=cache` бір машинадағы құрастырулар арасындағы npm кэшті сақтайды. Бұл BuildKit функциясы, демек, басындағы # syntax жолы.
  • `HOSTNAME=0.0.0.0`. server.js осы айнымалыдан мекенжайды тыңдайды. Онсыз сервер контейнер атауына қосыла алады және қайта жіберілген порт қосылым сәтсіздігімен жауап береді.
  • Статика бөлек көшіріледі. .next/standalone құрамында .next/static және public жоқ - бұл бірінші құрастырудан кейін CSS және JS жүйесінде 404 жиі кездесетін себебі.
  • `USER node`. Ресми түйін кескіндерінде артықшылықсыз пайдаланушы node (uid 1000) бар. Өзіңізді жасаудың қажеті жоқ, бірақ файлдарды --chown ішінен көшіру керек, әйтпесе процесс ISR және кескінді оңтайландыру үшін .next/cache файлына жаза алмайды.

Қоршаған ортаның айнымалылары: құрастыру және орындау уақыты

NEXT_PUBLIC_* айнымалылары next build кезінде клиенттік JavaScript-ке ауыстырылады. Оларды docker run арқылы тасымалдау тым кеш - жинақта жинақтағы мән әлдеқашан бар немесе бос. Сондықтан олар құрастырушы сатысында ARG арқылы өтеді.

Сервер құпиялары (DATABASE_URL, API кілттері), керісінше, суретке қосылмауы керек. Оларды ARG ретінде жібермеңіз және .env көшірмеңіз - оларды іске қосу кезінде орнатыңыз:

docker run -d --env-file /etc/myapp/prod.env -p 127.0.0.1:3000:3000 myapp:1.4.0

Және .dockerignore екеніне сенімді болыңыз, әйтпесе COPY . . қажет емес нәрселерді, соның ішінде құпияларды жинақ контекстіне апарады:

node_modules
.next
.git
.env*
*.log
coverage

PID 1 және контейнерді тоқтату

PID 1 ретінде іске қосылған Түйін процесі сигналдар үшін стандартты ядро әрекетін қабылдамайды. Қолданбада SIGTERM өңдегіші болмаса, docker stop күту уақытын күтеді (әдепкі бойынша 10 секунд) және белсенді сұрауларды тоқтатып, SIGKILL арқылы процесті тоқтатады. Қарапайым шешім - бастапқы процесс:

# compose.yml
services:
  web:
    image: myapp:1.4.0
    init: true
    env_file: /etc/myapp/prod.env
    ports:
      - "127.0.0.1:3000:3000"
    healthcheck:
      test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:3000/api/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"]
      interval: 30s
      timeout: 5s
      retries: 3

Жұқа кескінде curl жоқ, сондықтан денсаулықты тексеру Түйіннің өзінде жазылады: жаһандық fetch 18 және одан кейінгі түйіндерде қолжетімді.

Суреттер және анық

Next.js 15 ішінде sharp автоматты түрде next start арқылы және дербес режимде қосылады; оны қолмен орнатудың қажеті жоқ. Егер сіз әлі де sharp жоқ екендігі туралы ескертуді көрсеңіз, құрастыру және орындау уақыты бір платформада екенін тексеріңіз: glibc үшін құрастырылған екілік файлдар Alpine (musl) жүйесінде жұмыс істемейді және керісінше. Сондықтан мысалда барлық кезеңдер бір негізгі кескіннен алынған.

Нәтижені қалай тексеруге болады

docker build -t myapp:test --build-arg NEXT_PUBLIC_SITE_URL=https://example.com .
docker image ls myapp:test                  # размер образа
docker run --rm myapp:test id               # uid=1000(node), не root
docker run --rm myapp:test ls -la .next     # владелец node

Қабаттарда не орын алатынын талдау үшін dive құралы ыңғайлы. Егер соңғы кескін күтпеген жерден үлкен болса, ол әдетте бүкіл node_modules қамтиды: жүгіртпеде COPY . . жоқ екенін тексеріңіз.

Жалпы қателер

  • Error: EACCES .next/cache ішіне жазу кезінде - файлдар --chownсыз көшірілді.
  • Сайт жұмыс істейді, бірақ стильсіз - олар .next/static көшіруді ұмытып кетті.
  • NEXT_PUBLIC_* браузерде бос - құрастыру кезінде емес, орындау уақытында тасымалданады.
  • Apple Silicon көмегімен Mac жүйесінде құрастырыңыз, amd64 серверінде іске қосыңыз - сізге docker buildx build --platform linux/amd64 қажет, әйтпесе жергілікті модульдер дұрыс емес архитектурада.

Оқшау қажет болмаған кезде

Орналастыру Vercel-ге немесе өз жинағы бар басқа платформаға өтсе, бұл параметр ештеңе бермейді. Статикалық экспорттау үшін (output: 'export') сервер мүлдем қажет емес - статикалық бар nginx жеткілікті.

Обсуждение (0)

Ещё на vbcd4u.com