وقت بناء Docker

خطوات الاستخدام

أدخل عدد الطبقات (Layers): يمثل هذا العدد إجمالي الطبقات في Dockerfile الخاص بك. كل أمر مثل RUN أو COPY أو ADD يُنشئ طبقة جديدة. كلما زاد عدد الطبقات، زاد وقت البناء. تأكد من حساب جميع الطبقات بما في ذلك الطبقات الأساسية (FROM) والطبقات الوسيطة.

أدخل متوسط وقت الطبقة (Average Layer Time) بالثواني: هذا هو الوقت التقريبي الذي تستغرقه كل طبقة لبنائها بدون استخدام التخزين المؤقت. يمكنك تقديره من خلال مراقبة أوقات البناء السابقة أو استخدام القيم الافتراضية مثل 30 ثانية. يختلف هذا الرقم حسب تعقيد الأوامر (مثل تثبيت الحزم أو نسخ الملفات الكبيرة).

أدخل نسبة نجاح التخزين المؤقت (Cache Hit Rate) كنسبة مئوية: تمثل هذه النسبة مدى فعالية التخزين المؤقت للطبقات. إذا لم تتغير الطبقة وملفاتها، يتم إعادة استخدامها من ذاكرة التخزين المؤقت، مما يقلل وقت البناء. أدخل قيمة بين 0 و 100. على سبيل المثال، إذا كنت تعيد بناء الصورة بنفس Dockerfile غالباً، فقد تكون النسبة 80% أو أعلى.

الأسئلة الشائعة

ترتيب الطبقات مهم جداً لزيادة فعالية التخزين المؤقت. Docker يستخدم التخزين المؤقت لكل طبقة بناءً على تعليمات الطبقة ومحتوى الملفات المنسوخة. إذا قمت بوضع الطبقات التي تتغير نادراً (مثل تثبيت الحزم) في الأعلى، والطبقات التي تتغير كثيراً (مثل نسخ الكود) في الأسفل، فإن معظم الطبقات ستكون مخزنة مؤقتاً عند إعادة البناء. على سبيل المثال، ضع COPY package.json و RUN npm install قبل COPY . لأن package.json يتغير أقل من الكود. هذا يضمن أن طبقة تثبيت الحزم تعاد فقط عندما يتغير package.json، مما يوفر وقتاً كبيراً. في المقابل، إذا وضعت COPY . في الأعلى، فإن أي تغيير في الكود سيلغي التخزين المؤقت لكل الطبقات اللاحقة، مما يزيد وقت البناء. بشكل عام، اتبع مبدأ: الأشياء الثابتة أولاً، والمتغيرة أخيراً.

تقليل عدد الطبقات يقلل وقت البناء ويحسن أداء الصورة. يمكنك دمج أوامر RUN المتعددة في أمر واحد باستخدام && و \ للأسطر المتعددة. مثلاً، بدلاً من RUN apt-get update و RUN apt-get install -y package1 package2، اكتب RUN apt-get update && apt-get install -y package1 package2. أيضاً، يمكنك استخدام multi-stage builds لتقسيم عملية البناء إلى مراحل، كل مرحلة لها طبقات أقل. بالإضافة إلى ذلك، احذف الملفات المؤقتة في نفس الطبقة (مثل rm -rf /var/lib/apt/lists/*) لتقليل حجم الصورة. لكن احذر: تقليل الطبقات لا يعني بالضرورة وقت بناء أقل إذا كان التخزين المؤقت فعالاً، لأن الطبقات المخزنة مؤقتاً لا تُعاد بناؤها. لذا وازن بين عدد الطبقات وترتيبها.

عند البناء محلياً، Docker يستخدم التخزين المؤقت من عمليات البناء السابقة على جهازك، مما يسرع العملية بشكل كبير. في CI/CD، غالباً ما يتم بناء الصورة من الصفر في بيئة نظيفة (مثل GitHub Actions أو Jenkins) بدون تخزين مؤقت مسبق، ما لم يتم تكوين caching. لكن يمكن استخدام Docker layer caching عن طريق حفظ ذاكرة التخزين المؤقت كأرتيفاكت أو استخدام أدوات مثل Docker buildx و cache-to/cache-from. بدون تخزين مؤقت، ستُبنى كل الطبقات من جديد، مما يزيد الوقت. لذلك، من الضروري تكوين caching في CI/CD باستخدام خيارات مثل --cache-from و --cache-to لتحميل وتخزين ذاكرة التخزين المؤقت. أيضاً، يمكن استخدام تقنيات مثل التخزين المؤقت للصور الأساسية (Base images) لتجنب تنزيلها كل مرة.

التغييرات في ملفات المصدر تؤثر على طبقة COPY التي تنسخ تلك الملفات. إذا تغير ملف واحد فقط، فإن طبقة COPY التي تحتوي على هذا الملف وكل الطبقات التي تليها ستفقد التخزين المؤقت. هذا يعني أن وقت البناء يعتمد على مكان الملف المتغير في Dockerfile. إذا كان الملف في طبقة مبكرة، فسيتم إعادة بناء طبقات كثيرة. لذلك، يمكنك تقليل التأثير بوضع الملفات الأكثر تغيراً (مثل الكود البرمجي) في طبقات متأخرة. للتنبؤ بوقت البناء، يمكنك استخدام أداة مثل Docker Build Check أو التحليل اليدوي. مع هذه الحاسبة، يمكنك تقدير الوقت عن طريق إدخال عدد الطبقات المتأثرة (التي تتغير) ومتوسط وقتها. كلما زادت نسبة التخزين المؤقت (cacheHit)، قل الوقت.

وقت بناء Docker

أدخل القيم

خطوات الاستخدام

أمثلة محلولة

أمثلة محسوبة

الأسئلة الشائعة