# خطای "The runner has received a shutdown signal": علتش، و رانری با حافظه کافی برای رفعش

> روی رانر میزبانی‌شده GitHub، علتی که GitHub تأیید کرده حافظه است: حافظه جاب تمام شد و ماشین مجازی پیش از آنکه خط out-of-memory به لاگ برسد از کار افتاد. ubuntu-latest روی مخزن خصوصی 8 GB دارد. Skipbox به جاب ۱۶ GB با قیمت ثابت ماهانه $۳۹ می‌دهد، یا ۳۲ GB با $۱۴۹، با دقیقه‌های نامحدود.

جاب شما با "The runner has received a shutdown signal" و بدون exit code از کار افتاد. روی رانر میزبانی‌شده GitHub، علتی که نگهدارندگان GitHub تأیید کرده‌اند حافظه است: `ubuntu-latest` روی مخزن خصوصی 8 GB دارد، و وقتی تمام شود ماشین مجازی پیش از رسیدن هر خط out-of-memory به لاگ متوقف می‌شود. هر تلاش دوباره دقیقه می‌سوزاند و merge را متوقف می‌کند.

Skipbox حافظه‌ای را که جاب لازم دارد با قیمت ثابت به آن می‌دهد: `runs-on: skipbox` برای ۱۶ GB با ماهانه $۳۹، یا `skipbox-16x32` برای ۳۲ GB با $۱۴۹، با دقیقه‌های نامحدود.

- دو برابر حافظه `ubuntu-latest` یک مخزن خصوصی با `runs-on: skipbox`، چهار برابر با `skipbox-16x32`
- 16 GB با 20,000 دقیقه در ماه: روی رانر 4 هسته‌ای GitHub‏ $۲۲۲، روی Skipbox ثابت $۳۹
- ماشین اختصاصی شما لایه‌های Docker و کش پکیج‌ها را نگه می‌دارد، پس اجرای دوباره‌ای که کار می‌کند سریع‌تر هم هست

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

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

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

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

## این پیام یعنی چه

برنامه رانر وقتی به پروسه‌اش در طول یک جاب گفته شود متوقف شود این را در لاگ می‌نویسد: "The runner has received a shutdown signal. This can happen when the runner service is stopped, or a manually started runner is canceled." بعد گام با "The operation was canceled." و بدون exit code تمام می‌شود، چون هیچ‌کدام از فرمان‌های شما شکست نخورده‌اند.

| لاگ چه نشان می‌دهد | چه اتفاقی افتاد |
|---|---|
| خط shutdown، بدون exit code، کسی اجرا را لغو نکرده | حافظه ماشین مجازی تمام شد و از کار افتاد |
| `Process completed with exit code 137.` | کرنل یک پروسه را به خاطر حافظه کشت؛ رانر زنده ماند |
| خط shutdown، و صفحه اجرا می‌گوید لغو شده | یک اجرای جدیدتر، یک نفر یا یک timeout آن را تمام کرد |

در issue شماره 15202 در actions/runner-images، یکی از نگهدارندگان GitHub آن را روی یک رانر 8 GB‏ `ubuntu-24.04` بازتولید کرد: جاب‌های زیر حافظه به‌علاوه swap رد شدند، و جاب‌های بالاتر از آن رانر را با همین پیام از دست دادند. یک ایمیج جدید می‌تواند بدون هیچ تغییری از طرف شما آن را به راه بیندازد، وقتی نسخه پیش‌فرض تازه یک ابزار حافظه بیشتری از نسخه قبلی لازم دارد.

## ماندن روی 8 GB چه هزینه‌ای دارد

هر اجرای از دست رفته یعنی دقیقه‌هایی که بی‌نتیجه حساب شده‌اند، یک اجرای دوباره و یک pull request که نمی‌تواند merge شود. دور زدنش هم کار است:

- کم کردن workerهای تست، `make -j` یا تعداد workerهای Gradle، پس جاب کندتر اجرا می‌شود
- محدود کردن `--max-old-space-size` در Node یا `-Xmx` در JVM
- شکستن یک جاب به چند جاب و وصل کردن دوباره آن‌ها به هم
- ثابت نگه داشتن نسخه یک ابزار تا کسی وقت کند درستش کند

نیاز به حافظه فقط بیشتر می‌شود: مجموعه تست‌های بزرگ‌تر، بیلدهای بزرگ‌تر، جاب‌های بیشتر از ایجنت‌های کدنویسی که اصلاحات را push می‌کنند. پاسخ GitHub یک larger runner است که برای هر دقیقه پول می‌گیرد:

| حافظه | رانر GitHub با این حافظه | با 20,000 دقیقه در ماه | Skipbox | ماهانه، دقیقه‌های نامحدود |
|---|---|---|---|---|
| 16 GB | larger runner با 4 هسته، دقیقه‌ای $۰٫۰۱۲ | $۲۲۲ | `skipbox`، طرح S | $۳۹ |
| 32 GB | larger runner با 8 هسته، دقیقه‌ای $۰٫۰۲۲ | $۴۲۲ | `skipbox-16x32`، طرح L | $۱۴۹ |

ارقام GitHub روی GitHub Team و پس از مصرف شامل‌شده آن است؛ larger runnerها Team یا Enterprise Cloud لازم دارند. دقیقه‌های خودتان را در [ماشین‌حساب صفحه اصلی](https://skipbox.dev/?ref=g-github-actions-runner-shutdown-signal-fa#cost) بررسی کنید.

رانر خودمیزبانی از خودتان چیزی به صورت‌حساب GitHub اضافه نمی‌کند، ولی هر بار که سرویسش ری‌استارت شود، میزبان برای وصله‌ها ری‌بوت شود یا یک autoscaler ماشین را بردارد همین پیام را نشان می‌دهد. خوب اداره کردنش یعنی سرور، وصله، پاک‌سازی و مقیاس‌دهی.

## Skipbox درستش می‌کند

### حافظه، با قیمت ثابت

| `runs-on` | ماشین | طرح، ماهانه |
|---|---|---|
| `skipbox` | ۴ vCPU‏، ۱۶ GB | S، $۳۹ |
| `skipbox-8x16` | ۸ vCPU‏، ۱۶ GB | M، $۷۹ |
| `skipbox-16x32` | ۱۶ vCPU‏، ۳۲ GB | L، $۱۴۹ |

دقیقه‌ها نامحدودند. Skipbox به‌عنوان رانر خودمیزبان ثبت می‌شود، پس جاب‌هایش هیچ دقیقه‌ای از GitHub شما مصرف نمی‌کنند و پشت بودجه Actions متوقف نمی‌شوند. جاب‌هایی که از ماشین‌های طرح شما بیشتر باشند منتظر نوبتشان می‌مانند.

### اجراهای دوباره سریع‌تر

هر طرح یک ماشین مجازی است که برای حساب شما نگه داشته می‌شود. ایمیج‌ها، لایه‌ها و build cache‏ Docker، کش پکیج‌ها و کش ابزارها روی دیسک آن می‌مانند، پس اجرای بعدی با آن‌ها شروع می‌شود، به‌جای اینکه همه چیز را دوباره دانلود کند.

### ماشینی که لازم نیست مراقبش باشید

Skipbox ایمیج را به‌روز نگه می‌دارد، اعتبارنامه‌ها، پروسه‌ها و کانتینرهای هر جاب را پاک می‌کند (از 13 نوامبر 2026، checkout و `target/` در Cargo می‌مانند)، بعد از هر جاب سلامت ماشین را بررسی می‌کند و ماشینی را که رد شود از نو می‌سازد. ماشین‌های مجازی Ubuntu 24.04 را با Docker‏، Node.js و Python اجرا می‌کنند.

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

```yaml
jobs:
  build:
    runs-on: skipbox # was ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
```

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

`skipbox` روی همه طرح‌ها اجرا می‌شود و `skipbox-16x32` روی طرح L. برای برگشتن، خط را به حالت قبل برگردانید.

## روی جاب‌های خودتان امتحانش کنید

دوره آزمایشی به مدت ۷ روز یا ۳٬۰۰۰ دقیقه جاب رایگان است، هر کدام زودتر برسد، بدون کارت. جاب‌های `runs-on: skipbox` را با ۴ vCPU و ۱۶ GB اجرا می‌کند، ۲ برابر حافظه `ubuntu-latest` یک مخزن خصوصی، پس جابی را که حافظه‌اش تمام می‌شود منتقل کنید و ببینید با کش‌های نگه‌داشته‌شده‌اش اجرا می‌شود، بعد برای جابی که بیشتر لازم دارد طرح L را بگیرید.

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

### پیام "The runner has received a shutdown signal" یعنی چه؟

به برنامه رانر وقتی جاب شما در حال اجرا بود گفته شد متوقف شود. روی رانر میزبانی‌شده GitHub شما چیزی را متوقف نکرده‌اید: ماشین مجازی زیر جاب از بین رفت، بیشتر وقت‌ها چون جاب همه حافظه‌اش را مصرف کرد. skipbox و skipbox-16x32 در Skipbox به جاب ۱۶ یا ۳۲ GB با قیمت ثابت ماهانه می‌دهند.

### چرا جاب من بدون هیچ خطایی لغو می‌شود؟

وقتی لاگ با خط shutdown و "The operation was canceled." و بدون exit code تمام می‌شود، رانر از دست رفته، نه اینکه گامی شکست خورده باشد. یکی از نگهدارندگان GitHub در issue شماره 15202 در actions/runner-images تأیید کرد که وقتی حافظه تمام شود، ماشین مجازی پیش از آنکه پیام out-of-memory به لاگ برسد از پاسخ دادن بازمی‌ماند. به جاب حافظه بیشتری بدهید: روی Skipbox این یک خط runs-on است.

### این خطای کمبود حافظه است؟

روی رانرهای میزبانی‌شده، معمولاً بله. جابی که کشته شود ولی رانر زنده بماند به‌جایش exit code 137 نشان می‌دهد؛ جابی که کل ماشین مجازی را از کار بیندازد خط shutdown را نشان می‌دهد. در هر دو حالت جاب بیشتر از 8 GB در ubuntu-latest لازم دارد، که همه طرح‌های Skipbox با قیمت ثابت می‌دهند.

### چرا یک رانر خودمیزبان این پیام را نشان می‌دهد؟

چیزی پروسه رانر یا ماشینش را وسط جاب متوقف کرده است: ری‌استارت سرویس، ری‌بوت برای به‌روزرسانی، autoscalerی که ماشین را برمی‌دارد، یا تمام شدن حافظه میزبان. روی Skipbox ماشین‌ها برایتان مدیریت می‌شوند، با بررسی سلامت بعد از هر جاب و ساخت خودکار دوباره ماشینی که رد شود.

### دوره آزمایشی رایگان Skipbox جابی را که حافظه‌اش تمام می‌شود درست می‌کند؟

به جاب ۲ برابر حافظه می‌دهد. دوره آزمایشی جاب‌های runs-on: skipbox را با ۴ vCPU و ۱۶ GB اجرا می‌کند، در برابر ۸ GB در ubuntu-latest روی مخزن خصوصی. حافظه بیشتر از آن یعنی runs-on: skipbox-16x32‏ (۳۲ GB) روی طرح L.

به‌روزرسانی: 2026-11-11 · https://skipbox.dev/fa/guides/github-actions-runner-shutdown-signal
