ما هو سياق البناء (Build Context) ولماذا نستخدم ملف .dockerignore؟

Question

Accepted Answer

عند تشغيل `docker build`، يرسل Docker **سياق البناء** (الملفات الموجودة في مجلد البناء) إلى daemon. ملف **.dockerignore** يستثني الملفات غير الضرورية من هذا السياق — مما يسرّع البناء، ويقلل حجم الصورة، ويتجنب تسرب الملفات الحساسة.

## سياق البناء

```bash
docker build -t myapp .     # the "." is the build context — the directory sent to the daemon
# → Docker tarballs the ENTIRE context directory and sends it to the daemon BEFORE building
# → a big context (node_modules, .git, large files) = slow builds, more data transferred
```

**سياق البناء** هو مجموعة الملفات التي يرسلها Docker إلى daemon لبناء الصورة. يتم تضمين كل شيء في مجلد البناء ما لم يتم استثناؤه — لذا فإن السياق الثقيل يبطئ كل بناء.

## .dockerignore — استثناء الملفات غير الضرورية

```text
# .dockerignore (like .gitignore, for the build context)
node_modules        # don't send local deps (they're installed in the image anyway)
.git                # don't send version history
*.log
.env                # ⚠️ don't send SECRETS into the build context/image
Dockerfile
dist
.vscode
```

`.dockerignore` يعمل مثل `.gitignore`، حيث يستثني الملفات من سياق البناء.

## لماذا هذا مهم (ثلاث فوائد)

```text
✓ FASTER builds — a smaller context transfers faster; fewer files to process
  (also helps caching: COPY . . won't be invalidated by irrelevant file changes)
✓ SMALLER images — excluded files (node_modules, .git) don't get COPYed into the image
✓ SECURITY — keep SECRETS (.env, keys, credentials) out of the context AND the image
  (a COPY . . could otherwise copy a .env file into the image — a real leak risk)
```

## لماذا هذا مهم

فهم سياق البناء و `.dockerignore` مهم جداً لـ **بناء Docker فعّال وآمن**، لذا فهو معرفة عملية مفيدة جداً.

كثير من المطورين لا يدركون أن `docker build .` يرسل **مجلد السياق الكامل إلى daemon** قبل البناء — لذا فإن السياق الثقيل (الذي يحتوي على `node_modules`, `.git`, ملفات البناء، ملفات كبيرة) يجعل **كل بناء أبطأ** (نقل ومعالجة بيانات أكثر) ويخاطر بنسخ ملفات غير مرغوبة في الصورة.

ملف **`.dockerignore`** (الذي يعمل مثل `.gitignore`) يعالج هذه المشكلة بثلاث فوائد عملية محددة: **بناء أسرع** (السياق الأصغر ينقل ويعالج بشكل أسرع، كما يحسّن التخزين المؤقت للطبقات حيث لن يتم إلغاء `COPY . .` بسبب التغييرات في الملفات غير ذات الصلة)، **صور أصغر** (الملفات المستثناة لا تُنسخ — على سبيل المثال، عدم حزم `node_modules` المحلي الذي يتم إعادة تثبيته على أي حال)، و**الأمان** بشكل حاسم (**الحفاظ على الأسرار مثل ملفات `.env`، المفاتيح، والبيانات الاعتمادية خارج سياق البناء والصورة** — لأن `COPY . .` قد ينسخ `.env` إلى الصورة، وهذا خطر حقيقي وشائع من تسرب البيانات الاعتمادية).

هذه الفائدة الأمنية مهمة جداً، حيث أن إدراج الأسرار أو الملفات الحساسة بطريق الخطأ في الصور عبر نسخ واسع جداً هو خطأ فعلي يساعد `.dockerignore` في منعه.

بما أن البناء يحدث باستمرار وكفاءة البناء وحجم الصورة وتجنب تسرب الأسرار كلها مهمة، وبما أن فهم سياق البناء واستخدام `.dockerignore` يحسّن جميعها مباشرة، فإن فهم سياق البناء و `.dockerignore` معرفة Docker عملية وذات صلة مباشرة — ممارسة بسيطة لكن مهمة جداً لبناء سريع وخفيف وآمن وسهل التغاضي عنها مع ذلك لها تأثير معنوي، خاصة لمنع الإدراج الحالي للأسرار في الصور.