Коротка відповідь
Відокремте 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.
Первинні джерела
- Docker: multi-stage builds
- Docker: build best practices
- Docker: context та ignore-файли
- Next.js: standalone output
Пов’язані матеріали та приклади
Потрібно реалізувати це у вашому продукті?
Пов’язана реалізація інтерфейсу, логіки застосунку, API та шару даних.