ما هو Dockerfile وكيف تكتبه؟

Question

Accepted Answer

**Dockerfile** هو ملف نصي يحتوي على تعليمات **لبناء صورة Docker** — يصف الصورة الأساسية والتبعيات والملفات المراد نسخها وكيفية تشغيل التطبيق. يجعل عمليات بناء الصور قابلة للتكرار وقابلة للتحكم في الإصدار.

## Dockerfile أساسي

```dockerfile
# FROM — the base image to build on
FROM node:20-alpine

# WORKDIR — set the working directory inside the image
WORKDIR /app

# COPY dependency files first (for better layer caching)
COPY package*.json ./
# RUN — execute a command during the BUILD (install dependencies)
RUN npm install

# COPY the rest of the application code
COPY . .

# EXPOSE — document the port the app listens on
EXPOSE 3000

# CMD — the command to run when a CONTAINER starts
CMD ["node", "server.js"]
```

## التعليمات الرئيسية

```text
FROM     → the base image (starting point) — REQUIRED, usually first
WORKDIR  → set the working directory for subsequent instructions
COPY/ADD → copy files from the host into the image
RUN      → execute a command at BUILD time (install packages, compile) → creates a layer
ENV      → set environment variables
EXPOSE   → document which port(s) the container listens on
CMD      → the default command to run when the container STARTS (one per Dockerfile)
ENTRYPOINT → the executable that runs (CMD provides default args to it)
ARG      → build-time variables
```

## RUN مقابل CMD مقابل ENTRYPOINT (يتم الخلط بينها بشكل شائع)

```text
RUN        → runs at BUILD time (builds the image — e.g. install dependencies)
CMD        → runs at CONTAINER START (the default command; overridable at run)
ENTRYPOINT → the main executable at start (CMD becomes its default arguments)
→ RUN builds the image; CMD/ENTRYPOINT define what runs when it starts.
```

## لماذا يكون مهماً

فهم Dockerfile ضروري لأنه الطريقة التي يتم بها بناء صور Docker، لذا فإن كتابة واحدة هي مهارة Docker أساسية وتومية.

يوفر Dockerfile **عمليات بناء صور قابلة للتكرار وقابلة للتحكم في الإصدار** — من خلال وصف في الكود بالضبط كيفية إنشاء صورة (الصورة الأساسية والتبعيات والملفات والتكوين وأمر التشغيل)، بحيث يمكن لأي شخص بناء الصورة نفسها بشكل متسق، وهذا هو أساس قيمة Docker في قابلية التكرار.

فهم **التعليمات الرئيسية** — `FROM` (الصورة الأساسية)، `WORKDIR`، `COPY` (إحضار الملفات)، `RUN` (تنفيذ أوامر وقت البناء مثل تثبيت التبعيات)، `ENV`، `EXPOSE`، و`CMD`/`ENTRYPOINT` (تحديد ما يتم تشغيله عند بدء الحاوية) — ضروري لكتابة Dockerfiles فعالة للتطبيقات الحقيقية.

التمييز المهم بشكل خاص والمربك بشكل شائع هو **`RUN` مقابل `CMD` مقابل `ENTRYPOINT`**: `RUN` ينفذ في **وقت البناء** (بناء الصورة، مثل تثبيت الحزم)، بينما `CMD`/`ENTRYPOINT` تحدد ما يتم تشغيله في **وقت بدء الحاوية** (أمر التطبيق) — فهم هذا يمنع الأخطاء الشائعة.

معرفة الأنماط العملية (مثل نسخ ملفات التبعيات قبل الكود لتخزين مؤقت أفضل للطبقات) يعكس كتابة Dockerfiles فعالة.

بما أن بناء الصور أساسي لاستخدام Docker (كل سير عمل Docker ينطوي على صور، و Dockerfile هو كيفية بناء الصور المخصصة)، وبما أن فهم التعليمات والتمييز بين وقت البناء والوقت التشغيلي ضروري لإنشاء صور صحيحة وفعالة، فإن فهم Dockerfile ضروري ومعروف Docker متكرر التطبيق — مهارة أساسية لأي شخص يستخدم Docker، الآلية التي تحول وعد Docker بالقابلية للتكرار إلى ممارسة وشرط شبه عام لحاويات التطبيقات.