هر دستور در Dockerfile یک لایه میسازد و لایهها روی هم انباشته میشوند. دو نتیجه دارد که بیشتر Dockerfileهای کند و بزرگ، از نفهمیدن همین دو میآیند:
لایه حذف نمیشود، فقط پوشانده میشود. اگر در یک لایه فایلی بسازی و در لایهٔ بعد پاکش کنی، حجمش در ایمیج میماند.
کش تا اولین تغییر معتبر است. وقتی لایهای عوض شود، همهٔ لایههای بعدش دوباره ساخته میشوند.
ترتیب غلط
FROM node:22
WORKDIR /app
COPY . .
RUN npm install
CMD ["node", "server.js"]
مشکل: COPY . . پیش از npm install است. با عوض شدن یک کاراکتر در هر فایل پروژه، کش آن لایه باطل میشود و npm install از نو اجرا میشود. هر بار.
ترتیب درست
FROM node:22-slim
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
CMD ["node", "server.js"]
حالا تا وقتی package.json عوض نشود، لایهٔ نصب از کش میآید. تغییر در کد، فقط COPY . . را دوباره اجرا میکند که چند ثانیه است.
npm ci بهجای npm install: از package-lock.json میخواند و دقیقاً همان نسخهها را نصب میکند. install ممکن است نسخهای تازهتر بردارد، یعنی ایمیجی که امروز میسازی با ایمیج دیروز یکی نیست.
پاک کردن در همان لایه
این دو یکی نیستند:
RUN apt-get update && apt-get install -y curl
RUN rm -rf /var/lib/apt/lists/*
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/*
اولی فهرست بستهها را در لایهٔ یک میسازد و در لایهٔ دو پاک میکند، ولی حجمش در ایمیج هست. دومی هر دو کار را در یک لایه میکند، پس چیزی نمیماند.
--no-install-recommends هم معمولاً دهها مگابایت بستهٔ پیشنهادی را که لازم نداری کنار میگذارد.
ساخت چندمرحلهای
بزرگترین صرفهجویی اینجاست. ابزار ساخت را در ایمیج نهایی نمیخواهی:
# مرحلهٔ ساخت
FROM node:22 AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
# مرحلهٔ اجرا
FROM node:22-slim
WORKDIR /app
ENV NODE_ENV=production
COPY package*.json ./
RUN npm ci --omit=dev && npm cache clean --force
COPY --from=build /app/dist ./dist
USER node
CMD ["node", "dist/server.js"]
ایمیج نهایی فقط خروجی ساخت و وابستگیهای اجرا را دارد. کامپایلر، فایلهای منبع و node_modules توسعه در مرحلهٔ اول میمانند و به ایمیج نمیرسند.
USER node را فراموش نکن. پیشفرض داکر روت است، و کانتینری که با روت اجرا شود اگر از آن فرار کنند، روت میزبان را هم تهدید میکند.
dockerignore
بدون این فایل، COPY . . کل node_modules محلی، پوشهٔ .git و فایلهای محیطیات را داخل ایمیج میبرد:
node_modules
.git
.env
dist
*.log
اندازه را بسنج
docker images myapp
docker history myapp:latest
history اندازهٔ هر لایه را جدا نشان میدهد. لایهای که انتظار نداری بزرگ باشد و هست، همان جایی است که باید دست ببری.