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

Next.js Docker tasviri chiqishi bilan: 'mustaqil': ko'p bosqichli qurish va ildizdan tashqari

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

Nima uchun mustaqil

Muntazam Next.js tasviri butun node_modules ni devDependencies, manbalar va qurish keshi bilan birga nusxalaydi. output: 'standalone' Next.js yordamida serverga haqiqatda qaysi fayllar kerakligini kuzatib boradi va ularni minimal server.js bilan birga .next/standalone ichiga joylashtiradi. Yakuniy rasmda faqat bu, statik va public tugaydi.

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

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

Monorepozitariyada outputFileTracingRoot ni ombor ildiziga yo'l bilan qo'shing, aks holda iz qo'shni papkalardan paketlarni topa olmaydi.

Docker fayli

# 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"]

Yechimlarni tahlil qilish:

  • Uch bosqich. Kompilyatorlar, ishlab chiquvchi bog'liqliklar va manbalar oraliq bosqichlarda qoladi va yakuniy tasvirda tugamaydi.
  • `--mount=type=cache` bir xil mashinadagi tuzilmalar orasidagi npm keshini saqlaydi. Bu BuildKit funktsiyasi, shuning uchun boshida # syntax qatori.
  • `HOSTNAME=0.0.0.0`. server.js ushbu oʻzgaruvchidan manzilni tinglaydi. Busiz server konteyner nomiga ulanishi mumkin va uzatilgan port ulanishning uzilishi bilan javob beradi.
  • Statiklar alohida nusxalanadi. .next/standalone tarkibida .next/static va public mavjud emas - bu birinchi tuzilishdan keyin CSS va JS da 404 ning keng tarqalgan sababidir.
  • `USER node`. Rasmiy tugun rasmlari allaqachon imtiyozsiz foydalanuvchiga ega node (uid 1000). O'zingizni yaratishingiz shart emas, lekin fayllar --chown dan ko'chirilishi kerak, aks holda jarayon ISR va tasvirni optimallashtirish uchun .next/cache ga yozib bo'lmaydi.

Atrof-muhit o'zgaruvchilari: qurish va ishlash vaqti

NEXT_PUBLIC_* oʻzgaruvchilari next build vaqtida mijoz JavaScript-ga almashtiriladi. Ularni docker run bilan o‘tkazish juda kech – to‘plam allaqachon yig‘ilish qiymatini o‘z ichiga olgan yoki bo‘sh. Shuning uchun ular quruvchi bosqichida ARG orqali o'tadi.

Server sirlari (DATABASE_URL, API kalitlari), aksincha, tasvirga kiritilmasligi kerak. Ularni ARG sifatida o'tkazmang va .env dan nusxa ko'chirmang - ularni ishga tushirishda o'rnating:

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

.dockerignore ga ishonch hosil qiling, aks holda COPY . . montaj kontekstiga keraksiz narsalarni, jumladan, sirlarni tortadi:

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

PID 1 va konteynerni to'xtatish

PID 1 sifatida ishlaydigan tugun jarayoni signallar uchun standart yadro xatti-harakatlarini qabul qilmaydi. Agar ilovada SIGTERM ishlov beruvchisi boʻlmasa, docker stop kutish vaqtini kutadi (sukut boʻyicha 10 soniya) va jarayonni SIGKILL orqali oʻchirib, faol soʻrovlarni tugatadi. Oddiy yechim - bu boshlash jarayoni:

# 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

Yupqa tasvirda curl mavjud emas, shuning uchun sog'liqni tekshirish tugunning o'zida yozilgan: global fetch 18 va undan keyingi tugunlarda mavjud.

Tasvirlar va aniq

Next.js 15 da sharp avtomatik ravishda next start bilan va mustaqil rejimda ulanadi; uni qo'lda o'rnatishning hojati yo'q. Agar siz hali ham keskin yo'qligi haqida ogohlantirishni ko'rsangiz, qurish va ish vaqti bir platformada ekanligini tekshiring: glibc uchun tuzilgan ikkilik fayllar Alp (musl) da ishlamaydi va aksincha. Shuning uchun, misolda, barcha bosqichlar bitta asosiy tasvirdan iborat.

Natijani qanday tekshirish mumkin

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

Qatlamlarda nima joy egallashini tahlil qilish uchun dive vositasi qulay. Agar yakuniy rasm kutilmagan darajada katta bo'lsa, u odatda butun node_modules ni o'z ichiga oladi: yuguruvchida COPY . . yo'qligini tekshiring.

Umumiy xatolar

  • Error: EACCES .next/cache ga yozishda - fayllar --chownsiz nusxalangan.
  • Sayt ishlaydi, lekin uslublarsiz - ular .next/static nusxasini olishni unutishdi.
  • NEXT_PUBLIC_* brauzerda bo'sh - montaj vaqtida emas, ish vaqtida uzatiladi.
  • Apple Silicon bilan Mac-da yarating, amd64 serverida ishga tushiring - sizga docker buildx build --platform linux/amd64 kerak, aks holda mahalliy modullar noto'g'ri arxitekturaga ega.

Mustaqillik kerak bo'lmaganda

Agar tarqatish Vercelga yoki o'z yig'ilishiga ega boshqa platformaga o'tsa, bu sozlama hech narsa bermaydi. Statik eksport uchun (output: 'export') server umuman kerak emas - statik bilan nginx yetarli.

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

Ещё на vbcd4u.com