# docker compose در هر جاب GitHub Actions همه ایمیج‌ها را pull می‌کند: چطور جلوی pull تکراری را بگیریم

> هر جاب GitHub Actions روی یک ماشین مجازی تازه بدون هیچ ایمیج Docker شروع می‌شود، پس docker compose up‏ Postgres‏، Redis و همه ایمیج‌های سرویس دیگر را دوباره pull می‌کند. docker save با actions/cache فقط دانلود را جابه‌جا می‌کند، داخل ۱۰ GB‏ GitHub. روی رانری که دیسکش را نگه می‌دارد ایمیج‌ها از قبل آنجا هستند. Skipbox همان رانر است، با قیمت ثابت ماهانه $۳۹: یک خط runs-on را تغییر دهید.

`docker compose up` در هر جاب GitHub Actions همه ایمیج‌ها را pull می‌کند، چون هر جاب روی رانر میزبانی‌شده GitHub روی یک ماشین مجازی تازه شروع می‌شود. Postgres‏، Redis‏، message broker و ایمیج‌های سرویس‌های خودتان: هیچ‌کدام روی دیسک نیستند، پس Compose همه را پیش از اجرای اولین تست دانلود و باز می‌کند. راه جلوگیری از pull همان ایمیج‌ها این است که جاب را روی ماشینی اجرا کنید که هنوز آن‌ها را دارد.

Skipbox همان ماشین است. جاب‌های شما روی ماشین اختصاصی حسابتان اجرا می‌شوند، که ایمیج‌ها، لایه‌ها و کش بیلد Docker را بین جاب‌ها نگه می‌دارد. `docker compose up` آنچه را دفعه قبل pull کرده پیدا می‌کند و کانتینرها را راه می‌اندازد. یک خط را به `runs-on: skipbox` تغییر دهید، با قیمت ثابت ماهانه $۳۹ و دقیقه‌های نامحدود.

- GitHub: برای هر جاب یک ماشین مجازی تازه، پس همه ایمیج‌های فایل compose شما در هر جاب دوباره pull می‌شوند
- Skipbox: ایمیج‌ها روی دیسک ماشین شما می‌مانند و فقط لایه‌هایی که تغییر کرده‌اند دانلود می‌شوند
- 20,000 دقیقه در ماه روی 4 vCPU یعنی $۲۲۲ روی GitHub و $۳۹ روی Skipbox

**GitHub Actions با قیمت ثابت و دقیقه‌های نامحدود** Skipbox جاب‌های GitHub Actions شما را روی ماشین اختصاصی خودتان اجرا می‌کند: ماهانه $۳۹، هر چند دقیقه که اجرا کنید. لایه‌های Docker و کش وابستگی‌ها بین جاب‌ها می‌مانند، پس جاب بعدی فوراً شروع می‌شود.

رانری با چهار vCPU، ماهانه بیست هزار دقیقه: GitHub $۲۲۲ → Skipbox $۳۹. هر ماه $۱۸۳ صرفه‌جویی می‌کنید.

انتقال فقط یک خط است: `runs-on: skipbox`.

[شروع دوره آزمایشی رایگان ۷ روزه](https://app.skipbox.dev/sign-in?ref=g-docker-compose-pull-slow-github-actions-fa)

## چرا هر جاب pull می‌کند

- **برای هر جاب یک ماشین مجازی تازه.** [مرجع رانرهای GitHub](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)، خوانده‌شده در 14 نوامبر 2026، می‌گوید هر رانر میزبانی‌شده GitHub یک ماشین مجازی (VM) تازه است که GitHub میزبانی‌اش می‌کند. هیچ چیزی که جاب قبلی pull کرده روی آن نیست.
- **Compose آنچه را نیست pull می‌کند.** [`pull_policy`](https://docs.docker.com/reference/compose-file/services/) پیش‌فرض `missing` است: Compose ایمیج را فقط وقتی pull می‌کند که در کش platform موجود نباشد. روی یک ماشین مجازی تازه، هیچ ایمیجی موجود نیست.
- **pull یعنی دانلود و باز کردن.** هر لایه دانلود می‌شود، از حالت فشرده خارج می‌شود و روی دیسک ماشین مجازی نوشته می‌شود. `ubuntu-latest` یک مخزن خصوصی برای این کار ۲ CPU و 14 GB حافظه SSD دارد.

پس زمان پیش از اولین تست شما به اندازه فایل compose شماست، که با هر push کامل پرداخت می‌شود.

## روی رانر میزبانی‌شده GitHub چه می‌توانید بکنید

این گزینه‌ها دانلود را جابه‌جا می‌کنند؛ هیچ‌کدام حذفش نمی‌کند.

| گزینه | هر جاب هنوز چه می‌کند | محدودیت |
|---|---|---|
| `docker save` + actions/cache + `docker load` | آرشیو را دانلود می‌کند، بعد همه ایمیج‌ها را داخل Docker بار می‌کند | از ۱۰ GB هر مخزن در GitHub کم می‌کند، مشترک با همه کش‌های دیگر |
| ایمیج‌های کوچک‌تر (`-alpine`، `-slim`) | همه را pull می‌کند، سریع‌تر | فقط تا جایی که هر ایمیج نسخه کوچک داشته باشد |
| سرویس‌های کمتر در هر جاب | ایمیج‌های کمتری pull می‌کند | تست‌هایی که کل stack را لازم دارند باز هم همه را pull می‌کنند |

هر کدام راهی است تا ماشینی فراموشکار کمتر فراموش کند. pull فقط وقتی از بین می‌رود که ماشین به خاطر بسپارد.

## Skipbox ایمیج‌ها را روی ماشین شما نگه می‌دارد

هر طرح با ماشین اختصاصی حساب شما می‌آید که بین جاب‌ها می‌ماند:

- **ایمیج‌ها روی دیسک می‌مانند.** `docker compose up` ایمیج‌هایی را که دفعه قبل pull کرده پیدا می‌کند و مستقیم سراغ راه‌اندازی کانتینرها می‌رود.
- **فقط تغییرها دانلود می‌شوند.** `docker compose pull` لایه‌هایی را که تغییر کرده‌اند می‌گیرد و بقیه را دوباره استفاده می‌کند.
- **ایمیج‌های سرویس‌های خودتان از کش بیلد می‌شوند.** `docker compose build` از لایه‌های بیلد قبلی استفاده می‌کند، بدون `cache-from` یا `cache-to`.
- **شروع تمیز در هر جاب.** بعد از هر جاب، Skipbox همه کانتینرها را حذف می‌کند و ورود به registry‏ (`~/.docker/config.json`) را پاک می‌کند. جاب بعدی سرویس‌هایش را تازه راه می‌اندازد، از ایمیج‌هایی که از قبل روی دیسک هستند.
- **جا برای آن‌ها.** دیسک روی S‏ ۸۰ GB است، در برابر 14 GB روی رانر GitHub. تا وقتی دیسک بعد از یک جاب تقریباً پر نشود هیچ چیز حذف نمی‌شود؛ آن وقت اول ایمیج‌های بی‌برچسب (dangling) می‌روند، بعد کش بیلدی که از همه قدیمی‌تر استفاده شده.

ورک‌فلو جز `runs-on` تغییری نمی‌کند:

```yaml
jobs:
  integration:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: docker compose up -d --wait
      - run: npm ci && npm run test:integration
```

اگر ایمیج‌ها را با actions/cache و `docker load` ذخیره می‌کردید، آن گام‌ها را حذف کنید. اولین جاب روی Skipbox همه ایمیج‌ها را یک بار pull می‌کند. جاب دوم آن‌ها را روی ماشین پیدا می‌کند.

هر جاب اندازه‌اش را با لیبل انتخاب می‌کند:

| لیبل | ماشین | دیسک | طرح |
|---|---|---|---|
| `skipbox` | ۴ vCPU · ۱۶ GB | ۸۰ GB | S، ماهانه $۳۹ |
| `skipbox-8x16` | ۸ vCPU · ۱۶ GB | ۱۶۰ GB | M، ماهانه $۷۹ |
| `skipbox-16x32` | ۱۶ vCPU · ۳۲ GB | ۳۲۰ GB | L، ماهانه $۱۴۹ |

## همان دقیقه‌ها، با قیمت ثابت

تست‌های یکپارچگی جاب‌های طولانی هستند، پس همان‌هایی‌اند که صورت‌حساب دقیقه‌ای با آن‌ها بزرگ می‌شود. روی Skipbox دقیقه‌ها نامحدودند:

| دقیقه در ماه (4 vCPU) | GitHub | Skipbox S | صرفه‌جویی ماهانه شما |
|---|---|---|---|
| 10,000 | $۱۰۲ | $۳۹ | **$۶۳** |
| 20,000 | $۲۲۲ | $۳۹ | **$۱۸۳** |
| 30,000 | $۳۴۲ | $۳۹ | **$۳۰۳** |

ارقام GitHub پس از مصرف شامل‌شده در GitHub Team است. دقیقه‌های خودتان را در [ماشین‌حساب صفحه اصلی](https://skipbox.dev/?ref=g-docker-compose-pull-slow-github-actions-fa#cost) وارد کنید.

## انتقال یک خط است

1. با GitHub وارد Skipbox شوید.
2. اپ Skipbox در GitHub را نصب کنید و مخزن‌ها را انتخاب کنید.
3. `runs-on` جاب تست یکپارچگی را تغییر دهید و push کنید.

در همان ورک‌فلو ایمیج هم بیلد می‌کنید؟ [کش لایه‌های Docker در GitHub Actions](https://skipbox.dev/fa/guides/docker-layer-cache-github-actions)‏ `docker build` و buildx را پوشش می‌دهد.

## امنیت

- ماشین فقط مال حساب شماست. جاب هیچ شرکت دیگری روی آن اجرا نمی‌شود.
- بعد از هر جاب، اعتبارنامه‌های رانر، پروسه‌ها و کانتینرها پاک می‌شوند، و همین‌طور `~/.docker/config.json`، پس ورود به یک registry به جاب بعدی منتقل نمی‌شود. گزینه «ماشین تازه برای هر جاب» به‌جای آن به هر جاب یک ماشین تازه می‌دهد.
- کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین تازه و یک‌بارمصرف اجرا می‌شود، هرگز روی ماشین شما.

جزئیات در [جداسازی جاب‌ها](https://docs.skipbox.dev/fa/isolation) است.

## روی تست‌های یکپارچگی‌تان امتحانش کنید

دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، و کارت نمی‌خواهد. جاب را به `runs-on: skipbox` ببرید، دو بار اجرایش کنید و `docker compose up` اجرای دوم را کنار GitHub بگذارید.

## پرسش‌های متداول

### تست‌های یکپارچگی ما در GitHub Actions بر پایه docker compose هستند و بیشتر زمان صرف pull ایمیج‌ها می‌شود. چطور از pull همان ایمیج‌ها در هر جاب جلوگیری کنیم؟

جاب را روی ماشینی اجرا کنید که دیسکش را نگه می‌دارد. رانر میزبانی‌شده GitHub برای هر جاب یک ماشین مجازی تازه است، پس هیچ ایمیجی نمی‌ماند و compose همه را دوباره pull می‌کند. روی Skipbox جاب روی ماشین اختصاصی حساب شما اجرا می‌شود که ایمیج‌های Docker را بین جاب‌ها نگه می‌دارد: docker compose up ایمیج‌هایی را که دفعه قبل pull کرده پیدا می‌کند و کانتینرها را راه می‌اندازد. تغییر یک خط است، runs-on: skipbox، با قیمت ثابت ماهانه $۳۹ و دقیقه‌های نامحدود.

### چرا docker compose در هر جاب GitHub Actions ایمیج‌ها را دوباره pull می‌کند؟

چون Compose ایمیجی را pull می‌کند که روی ماشین نباشد، و روی رانر میزبانی‌شده GitHub هیچ‌وقت نیست. مرجع رانرهای GitHub می‌گوید هر رانر میزبانی‌شده GitHub یک ماشین مجازی تازه است؛ هیچ چیزی که جاب قبلی pull کرده روی آن نیست. pull_policy پیش‌فرض Compose یعنی missing، اگر ایمیج آنجا بود از pull می‌گذشت.

### می‌توانم ایمیج‌های docker compose را با actions/cache کش کنم؟

می‌توانید، و فقط دانلود را جابه‌جا می‌کند. docker save ایمیج‌ها را در یک فایل tar می‌نویسد، actions/cache آن را ذخیره می‌کند و جاب بعدی آن را بازمی‌گرداند و docker load را اجرا می‌کند. هر جاب باز هم کل آرشیو را دانلود می‌کند و داخل Docker بار می‌کند، و آرشیو از ۱۰ GB کش هر مخزن در GitHub کم می‌کند، که با کش وابستگی‌های شما مشترک است. روی ماشینی که دیسکش را نگه می‌دارد چیزی برای save یا load وجود ندارد.

### Skipbox ایمیج‌های Docker را بین جاب‌ها نگه می‌دارد؟

بله. هر طرح با ماشین اختصاصی حساب شما می‌آید که بین جاب‌ها می‌ماند، و ایمیج‌ها، لایه‌ها و کش بیلد Docker را روی دیسکش نگه می‌دارد: ۸۰ GB روی S‏، ۱۶۰ GB روی M و ۳۲۰ GB روی L. بعد از هر جاب کانتینرها حذف می‌شوند و ورود به registry پاک می‌شود؛ ایمیج‌ها می‌مانند.

### وقتی یک ایمیج در فایل compose من تغییر کند چه می‌شود؟

فقط لایه‌هایی که تغییر کرده‌اند دانلود می‌شوند. اگر می‌خواهید هر جاب registry را بررسی کند، docker compose pull را پیش از docker compose up اضافه کنید: Docker لایه‌های تازه را می‌گیرد و لایه‌هایی را که از قبل روی دیسک ماشین هستند دوباره استفاده می‌کند. ایمیج‌هایی که خودتان با docker compose build می‌سازید هم به همین شکل از لایه‌های بیلد قبلی استفاده می‌کنند.

### امتحان کردنش چقدر هزینه دارد؟

هیچ. دوره آزمایشی ۷ روز یا ۳٬۰۰۰ دقیقه جاب است، هر کدام زودتر برسد، و کارت نمی‌خواهد. جاب تست یکپارچگی خود را به runs-on: skipbox ببرید، دو بار اجرایش کنید و docker compose up اجرای دوم را با GitHub مقایسه کنید.

به‌روزرسانی: 2026-11-14 · https://skipbox.dev/fa/guides/docker-compose-pull-slow-github-actions
