Skipbox

حد حجم ذاكرة التخزين المؤقت في GitHub Actions: لماذا تُطرد ذاكرتك المؤقتة، أو تبطؤ استعادتها، أو تُخطئها المهمة

يمنح GitHub Actions كل مستودع 10 GB من ذاكرة التخزين المؤقت. وحين يتجاوزها المستودع، يظل GitHub يحفظ الإدخال الجديد ويحذف الإدخالات التي قُرئت منذ أطول مدة حتى يعود تحت الحد، ويحذف أي إدخال لم تقرأه أي مهمة 7 أيام. والفرع لا يقرأ إلا ذاكرته وذاكرة الفرع الافتراضي، فكثيرًا ما يُخطئ التشغيل الأول لفرع جديد. والإصابة ما زالت تنزيلًا: كل مهمة على مشغّل مستضاف على GitHub تبدأ على جهاز افتراضي جديد، فتُنزّل الأرشيف وتفكّه من جديد. يمكنك رفع الحد، بسعر $0.07 لكل GB شهريًا فوق 10 GB، وضبط مفاتيحك، لكن التنزيل يبقى.

يزيل Skipbox التنزيل. تعمل مهامك على جهاز يستضيفه Skipbox لحسابك وحده، محفوظ بين المهام، فتبقى ذاكرة npm وpnpm وGradle وGo وCargo المؤقتة وطبقات Docker على قرصه من المهمة السابقة (80 GB على S، مقابل 14 GB على مشغّل GitHub). وما يحفظه actions/cache يبقى بجوار الجهاز، فالاستعادة قراءة محلية. غيّر سطرًا واحدًا، runs-on: skipbox، بسعر ثابت قدره $39 شهريًا مع دقائق غير محدودة.

قواعد ذاكرة التخزين المؤقت في GitHub

من مرجع التخزين المؤقت للتبعيات في GitHub، وفوترة Actions، وسجل تغييراته عن ذاكرة التخزين المؤقت فوق 10 GB ‏(كلها بالإنجليزية):

لماذا تُطرد ذاكرة التخزين المؤقت

‏10 GB واحدة تتسع لكل ما يحفظه المستودع. كل فرع وكل طلب سحب يحفظ إدخالاته الخاصة. ومصفوفة من ثلاثة إصدارات Node على نظامي تشغيل تحفظ ستة. وذاكرة بناء Docker المؤقتة type=gha تنتهي في الـ 10 GB نفسها. وحين تتجاوز عمليات الحفظ في يوم الحد، يحذف كل حفظ جديد إدخالًا أقدم، وكثيرًا ما يكون الإدخال الذي تحتاجه المهمة التالية. ويسمّي GitHub ذلك cache thrashing.

لترى ما يملؤها، اعرض الإدخالات بحسب الحجم:

gh cache list --sort size_in_bytes --limit 20

وصفحة Actions › Caches في المستودع تُظهر الشيء نفسه، مع فرع كل إدخال وآخر استخدام له.

لماذا تبطؤ الاستعادة

إصابة ذاكرة التخزين المؤقت على مشغّل مستضاف على GitHub تنزيل إلى جهاز افتراضي جديد، ثم فكّ. ويطول وقتها مع حجم الأرشيف، فذاكرة تخزين مؤقت كبرت إلى عدة GB قد تستغرق ما يستغرقه التثبيت الذي كان يُفترض أن تتخطاه. والتنزيل المتعثر يقطعه حد مهلة المقطع في actions/cache، وهو 10 دقائق افتراضيًا (SEGMENT_DOWNLOAD_TIMEOUT_MINS).

ومعظم الإعدادات تستعيد أقل مما يظن الناس أيضًا. مدخل cache: في setup-node يحفظ ذاكرة التنزيل لمدير الحزم، لا node_modules: بعد الاستعادة، يظل npm ci يثبّت كل حزمة. وذاكرة pip المؤقتة في setup-python مثلها: تعود التنزيلات، وتُثبَّت البيئة من جديد.

لماذا تُخطئ ذاكرة التخزين المؤقت

  • تغيّر المفتاح. المفتاح الذي فيه hashFiles('**/package-lock.json') يُخطئ مع كل تغيير في ملف القفل. وrestore-keys يمنح مطابقة جزئية، فيقرأ cache-hit حينها false.
  • فرع جديد. يستطيع قراءة ذاكرة الفرع الافتراضي، لا ذاكرة فرع ميزة آخر. وإن لم يشغّل الفرع الافتراضي سير العمل قط، فلا شيء يُقرأ.
  • طُرد. أخذه الحد أو الأيام الـ 7.
  • لم يُحفظ قط. الإدخالات لا يمكن تغييرها، فالمفتاح الموجود لا يُحفظ من جديد أبدًا، ويبقى المحتوى المخزّن بقِدم أول حفظ له. وطلب السحب من نسخة متفرعة قد لا يُسمح له بالحفظ أصلًا.

تمرير الملفات إلى المهمة التالية في التشغيل نفسه أداة مختلفة. ذاكرة التخزين المؤقت للتشغيل التالي؛ أما مخرجات البناء التي تحتاجها مهمة لاحقة في سير العمل نفسه فتمر عبر actions/upload-artifact وactions/download-artifact. وللـ artifacts تخزينها الخاص، بمعزل عن 10 GB، وهي تنزيل إلى جهاز افتراضي جديد أيضًا.

ما يكلّفه كل حل على مشغّلات GitHub

  • ارفع الحد. طرد أقل، بسعر $0.07 لكل GB شهريًا فوق 10 GB (مثال GitHub نفسه: 200 GB مستخدمة بالكامل تكلّف $13.30 شهريًا)، على حساب Pro أو Team أو Enterprise. وتبقى الاستعادات تنزيلات، والذاكرة الأكبر يطول تنزيلها.
  • احفظ أقل. خزّن ~/.npm أو مخزن pnpm، لا node_modules أو مخرجات البناء. واحفظ على الفرع الافتراضي فقط، مع actions/cache/restore في كل مهمة وactions/cache/save في واحدة. يكلّف ذلك وقتك، والذاكرة الأصغر تستعيد أقل.
  • أصلح المفاتيح. اجعل المفتاح على ملف القفل، وأضف restore-keys، وشغّل سير العمل عند الدفع إلى الفرع الافتراضي حتى تجد الفروع الجديدة ما تقرؤه.
  • مشغّل مستضاف ذاتيًا يحتفظ بقرصه. لا تنزيل، ولا حد 10 GB. وأنت تشغّل الجهاز: تحديثات نظام التشغيل، والتنظيف بين المهام دون حذف ذاكرة التخزين المؤقت، وإصلاحه حين يتعطل.

حين يكون الحل جهازًا يحتفظ بقرصه

ذاكرة التخزين المؤقت موجودة لأن الجهاز ينسى. المشغّل المستضاف على GitHub جهاز افتراضي جديد لكل مهمة، فتحفظ المهمة حالتها في تخزين GitHub وتجلبها في المرة التالية. وعلى جهاز يبقى، تكون تلك الحالة على قرصه أصلًا: ذاكرة مدير الحزم المؤقتة، وذاكرة الأدوات، وصور Docker وذاكرة بنائه المؤقتة، بل ومخرجات البناء.

ويظهر الفرق في CI لمشاريع حقيقية، من تشغيلنا لمهامها نفسها:

  • astro ‏(Node.js، Turborepo): ‏528 ثانية على GitHub، و30 ثانية على جهاز Skipbox مخصّص، يحتفظ بذاكرة turbo المؤقتة، فتعيد تشغيلاته الدافئة تشغيل 40 مهمة بناء من الذاكرة بدلًا من تنفيذها.
  • helix ‏(Rust): خطوة سلسلة الأدوات وذاكرة التخزين المؤقت استغرقت 9-10 ثوانٍ على الجهاز المخصّص، مقابل 41-46 ثانية على GitHub.
  • tauri ‏(Rust): ‏246 ثانية على GitHub، و53 ثانية على الجهاز المخصّص، مع الاحتفاظ بـ target/ بين المهام.

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

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

  • ذاكرة الحزم المؤقتة تبقى على القرص: ~/.npm، ومخزن pnpm، و~/.cache لكل أداة، وذاكرة Go وGradle وCargo وMaven المؤقتة، مع الأدوات التي ثبّتتها setup-*. لا شيء يُستعاد.
  • صور Docker وطبقاته وذاكرة بنائه المؤقتة تبقى أيضًا. يعيد docker build استخدام طبقات البناء السابق (ذاكرة طبقات Docker المؤقتة).
  • **لا يحتاج actions/cache وsetup-* وrust-cache إلى أي تغيير.** ما تحفظه يبقى بجوار الجهاز بدلًا من تخزين GitHub، بمساحة أكبر من 10 GB التي يمنحها GitHub لكل مستودع، والاستعادة تقرؤه محليًا.
  • لا انتهاء صلاحية بعد 7 أيام على القرص. لا يُحذف شيء حتى يكاد القرص يمتلئ بعد مهمة؛ حينها يذهب أولًا ما استُخدم منذ أطول مدة.

7× على الأقل من مساحة GitHub للتخزين المؤقت على S. وتختار المهمة حجمها بالتسمية:

في ubuntu-latest على مستودع خاص 2 CPU و8 GB و14 GB من SSD. والدقائق غير محدودة على Skipbox. عند 20,000 دقيقة شهريًا على 4 vCPU، يحتسب GitHub $222؛ وSkipbox S بـ $39، أي أقل بـ $183.

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

jobs:
  test:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: npm
      - run: npm ci && npm test
  1. سجّل الدخول إلى Skipbox باستخدام GitHub.
  2. ثبّت تطبيق Skipbox على GitHub واختر المستودعات.
  3. غيّر runs-on ثم ادفع التغيير.

أبقِ خطوات التخزين المؤقت كما هي. يجد التشغيل الثاني ذاكرة التشغيل الأول المؤقتة على الجهاز.

الأمان

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

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

جرّبه على المهمة التي تُخطئ ذاكرتها المؤقتة

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

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

ما حد حجم ذاكرة التخزين المؤقت في GitHub Actions؟

10 GB لكل مستودع افتراضيًا، لكل الفروع وسير العمل معًا. وبعد تجاوزه، يظل GitHub يحفظ الإدخال الجديد ويحذف الإدخالات بحسب آخر وصول، الأقدم أولًا، حتى يعود المستودع تحت الحد. والإدخالات التي لم تقرأها أي مهمة 7 أيام تُحذف أيًّا كان الحجم. وعلى حساب Pro أو Team أو Enterprise، يستطيع المسؤولون رفع الحد والأيام؛ ويُحتسب التخزين فوق 10 GB بسعر $0.07 لكل GB شهريًا، مقيسًا بذروة كل ساعة، وحين تُبلغ الميزانية تصبح ذاكرة التخزين المؤقت للقراءة فقط حتى دورة الفوترة التالية.

لماذا تُطرد ذاكرة GitHub Actions المؤقتة لدي كثيرًا؟

لأن كل ما في المستودع يتشارك 10 GB واحدة: كل فرع، وكل طلب سحب، وكل مهمة في المصفوفة، وكل نظام تشغيل يحفظ إدخالاته الخاصة، وذاكرة Docker المؤقتة type=gha تنتهي في المكان نفسه. وحين تتجاوز عمليات الحفظ في يوم واحد الحد، يحذف كل حفظ إدخالًا أقدم، فتُخطئ المهمة التالية الإدخال الذي كانت تحتاجه. ويسمّي GitHub ذلك cache thrashing. اعرض الإدخالات بحسب الحجم (gh cache list --sort size_in_bytes) لترى ما يملؤها.

لماذا تستغرق استعادة ذاكرة التخزين المؤقت ما يستغرقه التثبيت من الصفر؟

لأن الإصابة ما زالت تنزيلًا. كل مهمة على مشغّل مستضاف على GitHub تبدأ على جهاز افتراضي جديد، فيُنزّل actions/cache الأرشيف ويفكّه في كل مرة، وكلما كبرت ذاكرة التخزين المؤقت طال ذلك. وذاكرة setup-node المؤقتة تعيد ذاكرة التنزيل لمدير الحزم، لا node_modules، فيظل npm ci يثبّت كل حزمة بعد الاستعادة. وعلى مشغّل يحتفظ بقرصه، تكون ذاكرة التخزين المؤقت موجودة أصلًا ولا يُنزَّل شيء.

لماذا يُخطئ actions/cache على فرع جديد؟

يستطيع التشغيل استعادة ذاكرة التخزين المؤقت من فرعه ومن الفرع الافتراضي، وتشغيل طلب السحب من فرعه الأساسي أيضًا. ولا يستطيع قراءة ذاكرة فرع شقيق. فلا يصيب التشغيل الأول لفرع ميزة إلا إن حفظ الفرع الافتراضي ذلك المفتاح. شغّل سير العمل عند الدفع إلى الفرع الافتراضي حتى يحفظ، وأضف restore-keys لمطابقة جزئية؛ وcache-hit يكون true فقط عند المطابقة التامة للـ key.

كم من ذاكرة Actions المؤقتة يحتفظ بها Skipbox؟

أكثر من 10 GB التي يمنحها GitHub لكل مستودع، بجوار جهازك بدلًا من تخزين GitHub. على جهاز سحابي، ما تحفظه المهام بـ actions/cache وsetup-* وrust-cache يبقى على قرص الجهاز نفسه، حتى نصف ذلك القرص (80 GB على S، و160 GB على M، و320 GB على L)؛ وعلى مضيف Skipbox، تحتفظ ذاكرة المضيف المؤقتة بـ 20 GB لكل مستودع. وفي الحالتين يُحفظ الإدخال 7 أيام بعد آخر استخدام له، بقواعد الفروع نفسها في GitHub. أما ذاكرة الحزم المؤقتة وطبقات Docker فلا تمر بها: إنها تبقى على القرص نفسه.

ما الذي يمسح ذاكرة التخزين المؤقت على جهاز Skipbox؟

لا شيء بين المهام: تبقى ذاكرة التخزين المؤقت على الجهاز، ولا يذهب ما استُخدم منذ أطول مدة أولًا إلا حين تترك مهمةٌ القرصَ شبه ممتلئ. ويبدأ الجهاز نظيفًا عند إعادة الضبط: حين تضغط «إعادة ضبط الجهاز»، وحين تُحدَّث صورته (مرة شهريًا على الأقل)، وحين يفشل في فحص السلامة بعد مهمة، وحين تبلغ مهمة حد الـ 6 ساعات. ويُحذف الجهاز مع قرصه حين تنتهي الخطة.

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

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

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

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

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

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

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