IHOR.DEVБАЗА_ЗНАНЬ
МЕНЮ

~/blog / Розгортання / production-docker-images-for-node-js-apps.md

// посібник · 2 хв читання

Робочі Docker-образи для застосунків Node.js

Збирайте production-образи Node.js з build/runtime stages, зафіксованими залежностями, контрольованим context, non-root і перевіреним артефактом.

Коротка відповідь

Відокремте install/compile від runtime. Образ містить build і runtime-dependencies, виконується non-root без keys у layers та перевіряється як artifact. Розмір важливий поряд із native-compatibility, files, startup і termination. Memory і filesystem не є durable-business-storage.

Практичні кроки реалізації

1. Визначте runtime entrypoint

TypeScript-server може мати dist/server.js, Next standalone — traced-server, dependencies й окремі public/.next/static. До COPY визначте artifact і runtime-files. Generic dist не є рецептом цього Next-портфоліо.

2. Контролюйте context і dependencies

Виключіть node_modules, output, VCS, logs і secret-env через .dockerignore. Manifests до source й lock-install. Build-tools у build, production-deps у runtime-stage. Lifecycle scripts із generated-files потребують явного порядку.

3. Узгодьте builder й runner

OS/runtime сумісні для native-packages. glibc-builder і musl-runner можуть ламати binaries. Виберіть supported-base й digest за immutable-provenance. Pin потребує update-process і не отримує patches автоматично.

4. Перевірте runtime

Запустіть без source-mounts, перевірте route/assets/permissions/config. Secrets runtime-механізмом, не build-args чи .env. Exec-form передає signals, app має drain. Non-root потребує доступу до потрібних writable-dir.

Приклад реалізації

Dockerfile умовного locked-app із dist/server.js й незалежним prod-install. Base-family однакова. Це не протестований Dockerfile репозиторію. .dockerignore до build, assets і lifecycle відповідно до app.

FROM node:22-bookworm-slim AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM node:22-bookworm-slim AS production-deps
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci --omit=dev

FROM node:22-bookworm-slim AS runtime
ENV NODE_ENV=production
WORKDIR /app
COPY --from=production-deps --chown=node:node /app/node_modules ./node_modules
COPY --from=build --chown=node:node /app/dist ./dist
COPY --from=build --chown=node:node /app/package.json ./package.json
USER node
CMD ["node", "dist/server.js"]
# Run in the illustrative application after creating its Dockerfile.
docker build --tag node-service:review .
docker run --rm --init --publish 3000:3000 node-service:review

Компроміси та альтернативи

Slim має звичні libraries, minimal — меншу surface й складніші debugging/native. Tracing зменшує dependencies, потребує files-check. Managed-build не усуває знання artifact/runtime/config. Мінімізація після правильності.

Поширені помилки

Не копіюйте host-dev node_modules, не додавайте keys у layers, не запускайте root для зручності. EXPOSE не publish-port. Startup не rebuild. Перевірте real-route, бо assets/permissions можуть зламатися після startup.

Перевірка перед випуском

  • Runtime-files перевірені в image.
  • Context без secrets/stale-output.
  • Native-deps сумісні.
  • Non-root і writable-paths явні.
  • Startup, routes і termination перевірені.

Поширені запитання

Чи multi-stage прибирає всі secrets?

Ні. Уникайте secrets, використайте secret-mount за потреби й перевірте artifacts/logs. Відсутність у final-stage недостатня.

Чи Dockerfile підходить Next.js?

Не без змін. Потрібен реальний Next-mode, runtime й public/static-assets.

Наступний крок

Зберіть image й перевірте без mounts/dev-deps. Configuration, assets і shutdown до publish. Digest та update-process забезпечують відтворення й patches.

Первинні джерела

Пов’язані матеріали та приклади

Ігор Харчишин

Незалежний full-stack інженер продуктів, який пише посібники з реалізації розширень браузера та сучасних вебпродуктів на основі першоджерел.

Потрібно реалізувати це у вашому продукті?

Пов’язана реалізація інтерфейсу, логіки застосунку, API та шару даних.