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

> كل مهمة في GitHub Actions تبدأ على جهاز افتراضي جديد بلا ذاكرة بناء Docker مؤقتة وبلا صور مسحوبة، والـ builder الافتراضي في setup-buildx-action يبدأ فارغًا. يعيد cache-to وcache-from في buildx ‏(gha وregistry وlocal) الطبقات على شكل تنزيلات، داخل 10 GB التي يمنحها GitHub. أما المشغّل الذي يحتفظ بذاكرة بناء Docker المؤقتة على قرصه فلا يحتاج إلى شيء من ذلك، بسعر ثابت قدره $39 شهريًا.

تضيع ذاكرة طبقات 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: جهاز افتراضي جديد لكل مهمة، فلا طبقات، ولا صور، وbuilder فارغ لـ buildx في كل تشغيل
- Skipbox: ذاكرة بناء Docker المؤقتة وصوره تبقى على قرص جهازك، فلا يُعاد بناء الطبقات التي لم تتغير ولا تُنزَّل
- 20,000 دقيقة شهريًا على 4 vCPU: $222 على GitHub، و$39 على Skipbox

**GitHub Actions بسعر ثابت ودقائق غير محدودة** يشغّل Skipbox مهام GitHub Actions على جهاز مخصص لك وحدك: $39 شهريًا، مهما كان عدد الدقائق التي تشغّلها. تبقى طبقات Docker وذاكرة التخزين المؤقت للتبعيات بين المهام، فتبدأ المهمة التالية فورًا.

مشغّل بـ 4 vCPU، و20,000 دقيقة شهريًا: GitHub $222 → Skipbox $39. توفّر $183 كل شهر.

الانتقال يتطلب سطرًا واحدًا: `runs-on: skipbox`.

[بدء تجربتي المجانية لمدة 7 أيام](https://app.skipbox.dev/sign-in?ref=g-docker-layer-cache-github-actions-ar)

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

- **جهاز افتراضي جديد لكل مهمة.** يقول [مرجع المشغّلات](https://docs.github.com/en/actions/reference/runners/github-hosted-runners) ‏(بالإنجليزية) في GitHub إن كل مشغّل مستضاف على GitHub جهاز افتراضي جديد يستضيفه GitHub. فلا شيء مما بناه أو سحبه التشغيل السابق موجود عليه.
- **builder فارغ.** ينشئ [docker/setup-buildx-action](https://github.com/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](https://docs.docker.com/build/cache/backends/) و[cache management with GitHub Actions](https://docs.docker.com/build/ci/github-actions/cache/) ‏(بالإنجليزية) في Docker:

| الواجهة الخلفية | أين تذهب الطبقات | ما يدفعه كل تشغيل | الحدود |
|---|---|---|---|
| `type=gha` | ذاكرة Actions المؤقتة لدى GitHub | يرفع الطبقات الجديدة، ويُنزّل ما يحتاجه منها | 10 GB لكل مستودع مع كل ذاكرة مؤقتة أخرى، تُطرد الأقدم أولًا؛ والنطاق الافتراضي `buildkit` يُكتب فوقه في كل بناء؛ وواجهة ذاكرة التخزين المؤقت في GitHub تحدّ المعدل |
| `type=registry` | صورة تخزين مؤقت منفصلة في السجل لديك | يسحب ذاكرة التخزين المؤقت من السجل، ويدفع الجديدة | تسجيل دخول إلى السجل بصلاحية الدفع؛ وتخزين السجل وحركة بياناته |
| `type=inline` | داخل الصورة نفسها | يسحب الصورة ليقرأ ذاكرتها المؤقتة | `mode=min` فقط: طبقات المراحل الوسيطة لا تُحفظ |
| `type=local` + actions/cache | مجلد يُحفظ بـ actions/cache | يُنزّل المجلد كله ويفكّه، ثم يرفعه | يكبر مع كل تشغيل ما لم يكن [`reset=true`](https://docs.docker.com/build/cache/backends/local/) ‏(Buildx 0.35.0 وما بعده)؛ ويُحتسب ضمن 10 GB |

أيًّا كانت الواجهة الخلفية التي تختارها، [رتّب ملف Dockerfile](https://docs.docker.com/build/cache/optimize/) بحيث تأتي الطبقات الأقل تغيرًا أولًا: انسخ ملف القفل وثبّت التبعيات قبل أن تنسخ الكود المصدري. وإلا أبطل كل commit طبقة التثبيت، ولا تعيدها أي ذاكرة تخزين مؤقت.

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

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

```yaml
- 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](https://github.com/reproducible-containers/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.
- **القرص:** لا يُحذف شيء حتى يكاد القرص يمتلئ بعد مهمة. حينها تذهب الصور المعلّقة أولًا، ثم ذاكرة البناء المؤقتة التي استُخدمت منذ أطول مدة.

```yaml
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
```

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

| التسمية | الجهاز | القرص | الخطة |
|---|---|---|---|
| `skipbox` | 4 vCPU · 16 GB | 80 GB | S، $39 شهريًا |
| `skipbox-8x16` | 8 vCPU · 16 GB | 160 GB | M، $79 شهريًا |
| `skipbox-16x32` | 16 vCPU · 32 GB | 320 GB | L، $149 شهريًا |

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

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

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

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

## الأمان

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

التفاصيل في [كيف تُعزل المهام](https://docs.skipbox.dev/ar/isolation).

## جرّبه على بناء 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.

آخر تحديث: 2026-11-19 · https://skipbox.dev/ar/guides/docker-layer-cache-github-actions
