Skipbox

ذاكرة طبقات Docker المؤقتة في GitHub Actions: لماذا يبدأ كل بناء باردًا، وكيف تحتفظ بالطبقات

تضيع ذاكرة طبقات Docker المؤقتة في كل تشغيل على GitHub Actions لأن كل مهمة على مشغّل مستضاف على GitHub تبدأ على جهاز افتراضي جديد: بلا ذاكرة بناء مؤقتة، وبلا صور مسحوبة. والـ builder الافتراضي في docker/setup-buildx-action ‏(docker-container) يبدأ هو أيضًا فارغًا في كل مهمة ويُزال في نهايتها. والحل المعتاد أن تُصدّر ذاكرة التخزين المؤقت بـ buildx. فـ cache-to: type=gha,mode=max وcache-from: type=gha يحتفظان بالطبقات في ذاكرة Actions المؤقتة لدى GitHub، ‏10 GB لكل مستودع تتشاركها مع كل ذاكرة مؤقتة أخرى؛ وtype=registry يحتفظ بها في السجل لديك؛ وtype=local في مجلد تحفظه بـ actions/cache. وكل منها يحوّل إعادة البناء إلى رفع وتنزيل في كل تشغيل.

يحتفظ Skipbox بالطبقات حيث يجري البناء. تعمل مهامك على جهاز يستضيفه Skipbox لحسابك وحده، يحتفظ بصور Docker وطبقاته وذاكرة بنائه المؤقتة بين المهام، على قرص بسعة 80 GB على S مقابل 14 GB على مشغّل GitHub. فيعيد docker build وdocker compose build استخدام طبقات البناء السابق، والصور التي سحبها compose موجودة على القرص أصلًا. ويعمل setup-buildx-action كما هو، ويجد الـ builder الخاص به هذه الطبقات أيضًا. غيّر سطرًا واحدًا، runs-on: skipbox، بسعر ثابت قدره $39 شهريًا مع دقائق غير محدودة.

لماذا يبدأ كل بناء باردًا

  • جهاز افتراضي جديد لكل مهمة. يقول مرجع المشغّلات ‏(بالإنجليزية) في GitHub إن كل مشغّل مستضاف على GitHub جهاز افتراضي جديد يستضيفه GitHub. فلا شيء مما بناه أو سحبه التشغيل السابق موجود عليه.
  • builder فارغ. ينشئ docker/setup-buildx-action افتراضيًا builder بمشغّل docker-container ويُقلعه، وخيار cleanup فيه (مفعّل افتراضيًا) يزيل الـ builder في نهاية المهمة.
  • قرص بسعة 14 GB. في ubuntu-latest على مستودع خاص 2 CPU و8 GB و14 GB من SSD. والصورة الكبيرة مع ذاكرة بنائها المؤقتة وأرشيف تخزين مؤقت يُفكّ قد تستنفد المساحة («no space left on device»).

الواجهات الخلفية لذاكرة buildx المؤقتة، وما يكلّفه كل منها

من صفحتي cache backends وcache management with GitHub Actions ‏(بالإنجليزية) في Docker:

أيًّا كانت الواجهة الخلفية التي تختارها، رتّب ملف Dockerfile بحيث تأتي الطبقات الأقل تغيرًا أولًا: انسخ ملف القفل وثبّت التبعيات قبل أن تنسخ الكود المصدري. وإلا أبطل كل commit طبقة التثبيت، ولا تعيدها أي ذاكرة تخزين مؤقت.

mode=min، وهو الافتراضي، لا يحتفظ إلا بطبقات الصورة النهائية. وmode=max يحتفظ بطبقات كل مرحلة، فيصيب البناء متعدد المراحل أكثر، ويرفع أكثر.

إعداد type=gha نموذجي، بنطاق خاص لكل صورة:

- uses: docker/setup-buildx-action@v4
- uses: docker/build-push-action@v7
  with:
    context: .
    tags: app:ci
    load: true
    cache-from: type=gha,scope=app
    cache-to: type=gha,scope=app,mode=max

ذاكرة الـ cache mounts لا تصمد. RUN --mount=type=cache (ذاكرة مدير الحزم المؤقتة داخل البناء) لا تُحفظ في ذاكرة GitHub Actions المؤقتة افتراضيًا؛ وتشير وثائق Docker إلى buildkit-cache-dance لنقلها إلى actions/cache ومنها، وهو تنزيل ورفع إضافيان في كل تشغيل.

docker compose يسحب كل صورة، في كل مهمة

اختبارات التكامل التي تشغّل Postgres وRedis وبضع خدمات بـ docker compose up تسحب كل صورة في كل مهمة، لأن الجهاز الافتراضي جديد. وعلى المشغّلات المستضافة على GitHub، الخيارات لا تفعل إلا نقل التنزيل:

  • احفظ الصور بـ docker save في ملف tar، وخزّنه مؤقتًا بـ actions/cache، وحمّله بـ docker load في المهمة التالية. ويُحتسب ذلك ضمن 10 GB، والتحميل يأخذ وقتًا خاصًا به.
  • ابنِ صور الخدمات بـ buildx مع إحدى الواجهات الخلفية أعلاه، وتبقى الصور الأساسية بحاجة إلى السحب.

حين يكون الحل جهازًا يحتفظ بذاكرة Docker المؤقتة

كل واجهة خلفية أعلاه موجودة لأن الـ builder ينسى. وخادم Docker الذي يبقى بين المهام يملك أصلًا طبقات البناء السابق، وذاكرة الـ cache mounts، وكل صورة سحبها، على قرصه. فلا شيء يُصدَّر، ولا شيء يُستورد، ولا 10 GB تُقتسم.

يحتفظ Skipbox بذاكرة Docker المؤقتة على جهازك

تأتي كل خطة مع جهاز خاص بحسابك، محفوظ بين المهام:

  • docker build وdocker compose build يعيدان استخدام طبقات البناء السابق، دون أي تغيير في سير العمل.
  • الصور تبقى على القرص. يجد docker compose up الصور التي سحبها في المرة السابقة؛ ولا يجلب docker compose pull إلا الطبقات التي تغيّرت.
  • ذاكرة الـ cache mounts تبقى مع ذاكرة بناء Docker المؤقتة، فيحتفظ RUN --mount=type=cache بذاكرة مدير الحزم المؤقتة دون خطوة إضافية.
  • يعمل docker/setup-buildx-action كما هو. يبدأ الـ builder الخاص به من الطبقات التي تركها آخر بناء لمستودعك على الجهاز، ويمكنك حذف cache-from وcache-to. وعندما شغّلنا بأنفسنا CI لمشروع عام على جهاز بـ 4 vCPU (19 نوفمبر 2026، تشغيل واحد لكل حالة)، استغرقت خطوة بناء الصورة 177 ثانية في التشغيل الأول و4 ثوانٍ عند إعادة التشغيل، مع 31 خطوة بحالة CACHED.
  • القرص: لا يُحذف شيء حتى يكاد القرص يمتلئ بعد مهمة. حينها تذهب الصور المعلّقة أولًا، ثم ذاكرة البناء المؤقتة التي استُخدمت منذ أطول مدة.
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: docker/setup-buildx-action@v4
      - uses: docker/build-push-action@v7
        with:
          context: .
          tags: app:ci
          load: true

وتختار المهمة حجمها بالتسمية:

الدقائق غير محدودة. عند 20,000 دقيقة شهريًا على 4 vCPU، يحتسب GitHub $222؛ وSkipbox S بـ $39، أي أقل بـ $183.

الانتقال سطر واحد

  1. سجّل الدخول إلى Skipbox باستخدام GitHub.
  2. ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
  3. غيّر runs-on ثم ادفع التغيير.

المهمة الأولى تبني كل طبقة. والثانية تجدها على الجهاز.

الأمان

  • الجهاز لحسابك وحده، ولا تعمل عليه مهام أي شركة أخرى.
  • بعد كل مهمة، تُمسح بيانات اعتماد المشغّل وعملياته وحاوياته، وكذلك ~/.docker/config.json، فلا ينتقل تسجيل الدخول إلى السجل إلى المهمة التالية. ويمنح خيار «مهمة نظيفة في كل مرة» كل مهمة جهازًا جديدًا بدلًا من ذلك.
  • الكود الوارد من أشخاص ليس لديهم صلاحية الكتابة (مثل طلبات السحب من النسخ المتفرعة) يعمل على جهاز جديد يُستخدم مرة واحدة، ولا يعمل على جهازك أبدًا.

التفاصيل في كيف تُعزل المهام.

جرّبه على بناء Docker لديك

الفترة التجريبية مجانية لمدة 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، ولا تتطلب بطاقة. انقل بناء Docker لديك إلى runs-on: skipbox، وشغّله مرتين، وضع خطوة البناء في التشغيل الثاني بجانب ما في GitHub.

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

لماذا تضيع ذاكرة طبقات Docker المؤقتة في كل تشغيل على GitHub Actions؟

لأن كل مهمة على مشغّل مستضاف على GitHub تبدأ على جهاز افتراضي جديد، بلا ذاكرة بناء مؤقتة وبلا صور من التشغيل السابق. ويضيف docker/setup-buildx-action إلى ذلك: فهو افتراضيًا ينشئ builder من نوع docker-container يبدأ فارغًا ويُزال في نهاية المهمة. فتُعاد بناء كل طبقة ما لم تُصدّر ذاكرة التخزين المؤقت بـ cache-to وتستوردها بـ cache-from، أو تشغّل على جهاز يحتفظ بذاكرة بناء Docker المؤقتة.

كيف أخزّن طبقات Docker مؤقتًا في GitHub Actions؟

على المشغّلات المستضافة على GitHub، بمُصدِّرات ذاكرة التخزين المؤقت في buildx: cache-from: type=gha وcache-to: type=gha,mode=max في docker/build-push-action يخزّنان الطبقات في ذاكرة Actions المؤقتة لدى GitHub ‏(10 GB لكل مستودع، تتشاركها مع كل ذاكرة مؤقتة أخرى). وtype=registry يخزّنها صورةً منفصلة في السجل لديك، وtype=local في مجلد تحفظه بـ actions/cache. امنح كل صورة نطاقها الخاص مع type=gha، لأن النطاق الافتراضي يُكتب فوقه في كل بناء. وعلى جهاز يحتفظ بقرصه، يعيد docker build استخدام الطبقات دون أي مُصدِّر.

لماذا يظل buildx مع cache-to type=gha بطيئًا؟

لأن الطبقات ما زالت تنتقل. مع mode=max، يرفع كل تشغيل كل طبقة جديدة من كل مرحلة، ويُنزّل التشغيل اللاحق الطبقات التي يحتاجها. وتتشارك ذاكرة التخزين المؤقت 10 GB لكل مستودع مع كل شيء آخر، فتُطرد، وواجهة ذاكرة التخزين المؤقت في GitHub تحدّ معدل البناء الذي يرسل طلبات كثيرة. أما الـ builder الذي يملك الطبقات على قرصه أصلًا فيتخطى الاتجاهين.

كيف أمنع docker compose من سحب الصور نفسها في كل مهمة؟

على مشغّل مستضاف على GitHub لا تستطيع، بل تنقل التنزيل فقط: احفظ الصور بـ docker save في ملف tar، وخزّنه مؤقتًا بـ actions/cache، وحمّله بـ docker load في المهمة التالية. ويُحتسب ذلك ضمن الـ 10 GB نفسها، وهو تنزيل وتحميل في كل تشغيل. وعلى جهاز يحتفظ بقرصه، تكون الصور التي سحبها compose في المرة السابقة موجودة أصلًا، ولا يجلب docker compose pull إلا الطبقات التي تغيّرت.

هل عليّ تغيير سير العمل للاحتفاظ بذاكرة Docker المؤقتة على Skipbox؟

runs-on فقط: جهاز حسابك يحتفظ بصور Docker وطبقاته وذاكرة بنائه المؤقتة بين المهام. فيعيد docker build وdocker compose build استخدامها، ويعمل docker/setup-buildx-action كما هو: يبدأ الـ builder الخاص به من الطبقات التي تركها آخر بناء لمستودعك على الجهاز. ويمكنك حذف cache-from وcache-to.

كم تكلّف التجربة؟

لا شيء. الفترة التجريبية 7 أيام أو 3,000 دقيقة من وقت المهام، أيهما يأتي أولًا، دون بطاقة. انقل بناء Docker لديك إلى runs-on: skipbox، وشغّله مرتين، وقارن خطوة البناء في التشغيل الثاني بما في GitHub.

آخر تحديث: 19 نوفمبر 2026

CI/CD أسرع مع ذاكرة تخزين مؤقت جاهزة دائمًا

مشغّلك الجاهز دائمًا بسعر ثابت

نحن نستضيفها. وأنت تغيّر سطرًا واحدًا. 1/12 من تكلفة GitHub عند الاستخدام الكامل. السعر ثابت، لذا يمكنك تشغيله طوال اليوم. مساحة تخزين مؤقت تبلغ 7× ما في GitHub.

  • دون بطاقة
  • تسجيل الدخول باستخدام GitHub
  • الإلغاء في أي وقت