Actions Runner Controller یا سرویس رانر مدیریتشده: کدام برای یک تیم کوچک؟
برای یک تیم کوچک، سرویس رانر مدیریتشده. Actions Runner Controller (ARC) یک operator برای Kubernetes است: یک کلاستر اداره میکنید، دو Helm chart نصب میکنید، یک ایمیج رانر میسازید و برای هر ارتقا همه را دوباره نصب میکنید. GitHub ARC را برای سازمانهایی توصیه میکند که زیرساخت Kubernetes و تیم متخصص Kubernetes دارند.
Skipbox همان چیزی را که ARC برایش ساخته شده به شما میدهد، یعنی رانرهای خودمیزبانی که GitHub برای دقیقههایشان پولی نمیگیرد، بدون هیچ چیزی برای اداره. جابهای شما روی ماشین اختصاصی حسابتان با قیمت ثابت ماهانه $۳۹ و دقیقههای نامحدود اجرا میشوند. یک خط runs-on را تغییر دهید.
وقتی ARC اجرا میکنید، چه چیزهایی را اداره میکنید
بر اساس مستندات ARC در GitHub:
| بخش | چه میخواهد |
|---|---|
| یک کلاستر Kubernetes | اولین پیشنیاز ARC، همراه Helm 3. GitHub توصیه میکند بارهای کاری production جدا اجرا شوند، چون به گفته خودش استفاده از یک کلاستر Kubernetes مشترک برای production میتواند خطر امنیتی داشته باشد |
| controller | Helm chart با نام gha-runner-scale-set-controller: پاد controller manager، نقشهایش و custom resource definitionهای ARC |
| یک runner scale set | Helm chart با نام gha-runner-scale-set، یک بار برای هر نوع رانر: یک پاد listener که منتظر جاب میماند و یک پاد رانر که برای هر جاب ساخته میشود |
| احراز هویت | یک GitHub App یا یک personal access token (classic)، ذخیرهشده بهصورت secret در Kubernetes |
| ایمیج رانر | ایمیج GitHub به گفته خودش کمترین پکیجهای لازم را دارد. برای هر چیز بیشتر، ایمیج خودتان را میسازید و منتشر میکنید |
| یک container mode | جابهایی که از کانتینر استفاده میکنند به dind (یک کانتینر privileged از نوع Docker-in-Docker در هر پاد رانر) یا kubernetes (volumeهای ماندگار یا lifecycle hookها، و بهطور پیشفرض جاب بدون container: شکست میخورد) نیاز دارند |
| محدودیتهای مقیاس | minRunners و maxRunners برای هر scale set. ARC برای آنها زمانبندی ندارد: یک cron job از خودتان تغییرشان میدهد |
| لاگها و متریکها | GitHub توصیه میکند پیش از production لاگهای controller، listenerها و رانرها را جمع و نگه دارید؛ متریکها با قالب Prometheus میآیند |
هر پاد رانر وقتی جابش تمام شود حذف میشود، پس ایمیجهایی که pull کرده و پکیجهایی که دانلود کرده هم با آن میروند. نگه داشتن آنها بین جابها یعنی فضای ذخیرهسازیای که خودتان طراحی و آماده میکنید.
هزینه آن به کار
ARC نرمافزار رایگان است و GitHub برای دقیقههای رانر خودمیزبان پولی نمیگیرد. هزینه، nodeهای کلاستر در هر ماه است، و این ساعتها:
- ارتقا یعنی نصب دوباره. Helm نمیتواند custom resource definitionهای ARC را ارتقا دهد. گامهای ارتقای GitHub: همه runner scale setها را حذف کنید، منتظر پاکسازی بمانید، ARC را حذف کنید، اگر CRDها تغییر کردهاند پاکشان کنید و دوباره نصب کنید. بدون یک کلاستر دوم، در این مدت هیچ رانری جاب نمیگیرد.
- رانر کهنه میشود. GitHub به رانری که بیش از 63 روز از نسخه جدید عقب باشد دیگر جاب نمیدهد. با ایمیج خودتان، ساختن دوباره آن سر وقت کار شماست.
- رفع اشکال کلاستر با شماست. محدوده پشتیبانی GitHub برای ARC راهاندازی و شبکه Kubernetes، ساختن ایمیج با Docker-in-Docker، ذخیرهسازی و volumeهای ماندگار، policyهای کلاستر و کش ایمیج را شامل نمیشود. GitHub نیرویی با دانش تخصصی در هماهنگسازی کانتینرها را توصیه میکند.
- خود Kubernetes. ارتقای nodeها، autoscale کردن nodeهای زیر رانرها، و صورتحساب nodeهایی که بین pushها بیکار میمانند.
یک تیم کوچک مهندس پلتفرمی ندارد که وقتش را صرف این کند. این ساعتها از کار روی محصول کم میشوند.
اگر روی رانرهای GitHub بمانید چقدر خرج دارد
دلیلی که تیمها سراغ ARC میروند صورتحساب دقیقهای است. این همان صورتحساب است در برابر یک طرح Skipbox:
| دقیقه در ماه (4 vCPU) | GitHub | Skipbox S | صرفهجویی ماهانه شما |
|---|---|---|---|
| 10,000 | $۱۰۲ | $۳۹ | $۶۳ |
| 20,000 | $۲۲۲ | $۳۹ | $۱۸۳ |
| 30,000 | $۳۴۲ | $۳۹ | $۳۰۳ |
| همیشه روشن | $۵۰۰٫۴۰ | $۳۹ | $۴۶۱٫۴۰ |
ارقام GitHub صورتحساب GitHub Team پس از مصرف شاملشده در آن است. دقیقههای خودتان را در ماشینحساب صفحه اصلی قیمت کنید؛ ورود لازم نیست.
Skipbox: رانرها، بدون کلاستر
| ARC | Skipbox | |
|---|---|---|
| برای شروع | یک کلاستر، Helm، دو chart، یک secret، یک ایمیج | یک اپ GitHub نصب کنید، runs-on را تغییر دهید |
| صورتحساب GitHub برای دقیقهها | هیچ | هیچ: رانرهای Skipbox رانر خودمیزبان هستند |
| هزینه ماهانه | nodeهای کلاستر، بر اساس اندازه و ساعت | $۳۹، $۷۹ یا $۱۴۹، ثابت |
| Docker در جابها | Docker-in-Docker با دسترسی privileged، یا حالت Kubernetes | Docker داخل ماشین مجازی اجرا میشود، مثل ubuntu-latest |
| کش بین جابها | همراه پاد از بین میرود، مگر برایش ذخیرهسازی بسازید | روی دیسک ماشین شما میماند |
| ارتقاها | حذف و نصب دوباره | برایتان انجام میشود |
| وقتی یک رانر خراب میشود | لاگهای controller و listener را میخوانید | بعد از هر جاب بررسی میشود؛ ماشینی که رد شود خودکار از نو ساخته میشود |
- قیمت ثابت. ۴ vCPU و ۱۶ GB با ماهانه $۳۹، ۸ vCPU با $۷۹، ۱۶ vCPU با $۱۴۹. دقیقههای نامحدود، بدون هزینه مصرف. برای اجرای جابهای همزمان بیشتر طرح اضافه کنید؛ جابهایی که از ماشینهایتان بیشتر باشند منتظر نوبتشان میمانند.
- ماشین اختصاصی و همیشه آماده. ایمیجها، لایهها و کش بیلد Docker، کش پکیجها و کش ابزارها بین جابها میمانند: دستکم ۷ برابر کشی که GitHub به یک مخزن میدهد. یک پاد رانر که خالی شروع میشود همه اینها را دوباره دانلود میکند.
- یک رانر برای هر جاب. Skipbox وقتی جاب در صف قرار میگیرد یک رانر just-in-time برای همان یک جاب ثبت میکند و بعد حذفش میکند. نه listener، نه scale set، نه
maxRunners. - همیشه بهروز. بهروز نگه داشتن رانر، Ubuntu 24.04، Docker، Node 22 و Python 3.12 با Skipbox است.
انتقال یک خط است
jobs:
build:
runs-on: skipbox # was ubuntu-latest, or your scale set's name
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test
- با GitHub وارد Skipbox شوید.
- اپ Skipbox در GitHub را نصب کنید و مخزنهایتان را انتخاب کنید.
runs-onرا تغییر دهید و push کنید.
جابهای Linux بدون تغییر اجرا میشوند، روی مخزنهای عمومی و خصوصی.
امنیت
- ماشین فقط مال حساب شماست؛ جاب هیچ شرکت دیگری روی آن اجرا نمیشود.
- بعد از هر جاب، اعتبارنامههای رانر، پروسهها، کانتینرها و فایلهای اعتبارنامه مثل
~/.npmrcپاک میشوند. از 13 نوامبر 2026، checkout شما و خروجی بیلد آن (target/در Cargo) برای جابهای بعدیتان روی ماشین اختصاصی شما میمانند؛ گزینه «ماشین تازه برای هر جاب» به هر جاب یک ماشین تازه میدهد. - کد افرادی که دسترسی نوشتن ندارند (مثل pull requestها از forkها) روی یک ماشین مجازی تازه اجرا میشود که بعد از آن حذف میشود. جابها چطور از هم جدا نگه داشته میشوند.
پیش از ساختن کلاستر امتحانش کنید
دوره آزمایشی کارت نمیخواهد و ۷ روز یا ۳٬۰۰۰ دقیقه جاب طول میکشد. همین امروز، پیش از آنکه برایش کلاستری بسازید، یک جاب را به runs-on: skipbox ببرید.
پرسشهای متداول
Actions Runner Controller یا سرویس رانر مدیریتشده: کدام برای یک تیم کوچک؟
سرویس رانر مدیریتشده. Actions Runner Controller (ARC) یک operator برای Kubernetes است: کلاستر را خودتان اداره میکنید، دو Helm chart آن را نصب میکنید، ایمیج رانر را میسازید و برای هر ارتقا دوباره نصبش میکنید. GitHub آن را برای سازمانهایی توصیه میکند که زیرساخت Kubernetes و تیم متخصص Kubernetes دارند. Skipbox همان دقیقههای رایگان خودمیزبان را بدون هیچ چیزی برای اداره به یک تیم کوچک میدهد: ماهانه $۳۹ ثابت برای ماشینی با ۴ vCPU، دقیقههای نامحدود، یک خط runs-on.
اداره Actions Runner Controller برای یک تیم کوچک سخت است؟
یک پلتفرم Kubernetes است که باید سرپا نگهش دارید. به یک کلاستر، Helm، یک GitHub App یا توکن که بهصورت secret در Kubernetes ذخیره شده، یک container mode برای جابهایی که از Docker استفاده میکنند، ایمیج رانر خودتان برای ابزارهایی که جابهایتان انتظار دارند، و جمعآوری لاگ برای controller، listenerها و رانرها نیاز دارید. مستندات GitHub نیرویی با دانش تخصصی در هماهنگسازی کانتینرها را توصیه میکند. روی Skipbox هیچکدام از اینها وجود ندارد: یک اپ GitHub نصب میکنید و runs-on را تغییر میدهید.
Actions Runner Controller چقدر هزینه دارد؟
خود ARC رایگان است و GitHub برای دقیقههای رانر خودمیزبان پولی نمیگیرد. شما هر ماه هزینه کلاستر Kubernetes و nodeهایش را میدهید، بهعلاوه ساعتهایی که صرف نصب، ارتقا و رفع اشکالش میشود. Skipbox ماشین و کار را در یک قیمت ثابت جمع میکند: ماهانه $۳۹، $۷۹ یا $۱۴۹ برای ۴، ۸ یا ۱۶ vCPU، با دقیقههای نامحدود.
Actions Runner Controller را چطور ارتقا میدهند؟
با نصب دوباره. Helm نمیتواند custom resource definitionهای ARC را ارتقا دهد، پس گامهای GitHub این است: همه runner scale setها را حذف کنید، منتظر پاکسازی بمانید، ARC را حذف کنید، اگر CRDهایش تغییر کردهاند پاکشان کنید و دوباره نصب کنید. رانر داخل ایمیج شما هم باید بهروز بماند: GitHub به رانری که بیش از 63 روز از نسخه جدید عقب باشد دیگر جاب نمیدهد. روی Skipbox رانر و ایمیج برایتان بهروز میشوند.
برای autoscale کردن رانرهای GitHub Actions به Kubernetes نیاز دارم؟
نه. ARC پاسخ GitHub بر پایه Kubernetes است، و مستندات GitHub ساختن autoscaler خودتان از scale set client یا از webhookها را هم شرح میدهد. یک رانر مدیریتشده به هیچکدام نیاز ندارد. Skipbox برای هر جاب، همان لحظه که در صف قرار میگیرد، یک رانر ثبت میکند؛ طرحهای شما تعیین میکنند چند جاب همزمان اجرا شوند و بقیه منتظر نوبتشان میمانند.
بیلدهای Docker روی Skipbox بدون Docker-in-Docker کار میکنند؟
بله. هر ماشین Skipbox یک ماشین مجازی است که Docker رویش نصب است، پس docker build، docker run، service containerها و container jobها همانطور کار میکنند که روی ubuntu-latest. روی ARC اول باید یک container mode انتخاب کنید: Docker-in-Docker که یک کانتینر privileged اجرا میکند، یا حالت Kubernetes که در آن جاب بدون کانتینر بهطور پیشفرض شکست میخورد.
بهروزرسانی: ۲۳ آبان ۱۴۰۵