أوامر Runner Farm
champrep runner-farm، أو الاسم المختصر الخاص بها champrep rf، يدير CHAMPREP «Runner Farm» من جهازك الطرفي: حسابات المزرعة الخاصة بك، واتصالات مضيف الكود ، ومجموعات المشغلات وفئات أجهزتها، والرصيد و الدقائق التي استخدمتها، والمهام التي نفذتها المزرعة. يعمل البرنامج نيابة عنك، باستخدام معلومات تسجيل الدخول العادية CLI الخاصة بك، لذا فإن دورك في الحساب وخطة الاشتراك الخاصة بك تنطبقان تمامًا كما هو الحال في تطبيق الويب «Runner Farm».
قبل البدء
Section titled “قبل البدء”- تثبيت CLI و تسجيل الدخول مع
champrep auth login. - يجب أن تتضمن خطتك «مزرعة المشغلات» (Runner Farm)، وتحتاج مساحة العمل إلى حساب المزرعة . قم بإنشاء الحساب وإضافة الاتصالات في تطبيق الويب «مزرعة المشغلات» على
https://runners.champrep.com.
أي حساب مزرعة
Section titled “أي حساب مزرعة”يمكنك العمل في أكثر من حساب مزرعة واحد: حسابك الخاص، وحساب مؤسسة أو حساب فريق. قم بإدراجها، ثم اختر واحدًا منها باستخدام --workspace:
champrep rf accounts lschamprep rf pools ls --workspace organization:65f0c0ffee0000000000abcd--workspace يأخذ KEY عمود من accounts ls: personal,
organization:<id> أو team:<id>. بدون ذلك، تختار المزرعة الحساب بنفس الطريقة التي يتبعها التطبيق الويب: حساب مؤسستك أو فريقك إذا كان متوفرًا، وإلا فحسابك الخاص.
الأوامر
Section titled “الأوامر”| الأمر | الغرض |
|---|---|
champrep rf accounts ls | قائمة بمساحات العمل التي يمكنك العمل فيها، ودورك، وما إذا كان لكل منها حساب مزرعة أم لا. |
champrep rf accounts show | عرض حساب المزرعة: الحالة، الجهة التي يتم إصدار الفواتير لها، المهام في وقت واحد، والحد الأقصى الشهري للرصيد. |
champrep rf connections ls | قائمة اتصالات مضيف الكود مع حالتها والمهام قيد التشغيل والمعلقة والمجمعة. --include-deleted, --limit (1-100). |
champrep rf pools ls | قائمة المجموعات مع فئة الجهاز، والفترات المشغولة، والمهام في حالة الانتظار والمؤجلة. --connection ID, --state active|paused|draining|deleted, --search, --include-deleted, --limit (1-200). |
champrep rf pools show POOL_ID | عرض مجموعة واحدة، وحدودها، ومدة الانتظار، والأرقام الخاصة بالدورة الحالية. |
champrep rf pools create | إضافة تجمع إلى اتصال. يتطلب --connection, --name و --class؛ أيضًا --isolation, --max-concurrent, --min-idle, --timeout. |
champrep rf pools update POOL_ID | تغيير --name, --max-concurrent, --min-idle أو --timeout، أو --pause / --resume المجموعة. |
champrep rf usage | الرصيد لفترة الفوترة الحالية (المشمول، والمشترى، والمستخدم، والمتبقي) والدقائق والرصيد لكل فئة من فئات الآلات لهذا الشهر أو --period YYYY-MM. |
champrep rf jobs ls | قائمة المهام، الأحدث أولاً، بما في ذلك المهام المعلقة والمؤجلة والمرفوضة. --state running,held, --pool ID, --billed-to-me, --limit (1-200). |
فئات الأجهزة والحدود
Section titled “فئات الأجهزة والحدود”| خيار | القيم |
|---|---|
--class | cpu-2, cpu-4, cpu-8, arm64-2, arm64-4, build-4 |
--isolation | shared_hardened (الافتراضي) أو tenant_dedicated |
--max-concurrent | المهام في وقت واحد، من 0 إلى 500 |
--min-idle | المهام الجاهزة التي يتم الاحتفاظ بها، من 0 إلى 50 |
--timeout | مهلة انتهاء المهام من 15m إلى 6h، على سبيل المثال 90m أو 2h |
تحدد خطتك الفئات ومستويات العزل والحدود التي يمكنك استخدامها. تظهر المجموعة التي تجاوزت حدود الخطة بعد تخفيض المستوى above plan في
pools ls.
اطلع على مكان تشغيل مهامك ومدى انشغال المجموعات:
champrep rf connections lschamprep rf pools lschamprep rf pools show pol_01HZX9K4أضف مجموعة لإنشاء الصور وقم بإيقافها مؤقتًا للصيانة:
champrep rf pools create --connection con_01HZX7 --name Builds \ --class build-4 --max-concurrent 4 --timeout 2h --yeschamprep rf pools update pol_01HZX9K4 --pause --yeschamprep rf pools update pol_01HZX9K4 --resume --max-concurrent 8 --yesتحقق مما استخدمته خلال هذه الفترة والشهر الماضي:
champrep rf usagechamprep rf usage --period 2026-10البحث عن المهام التي في حالة انتظار أو معلقة:
champrep rf jobs ls --state waiting,held
التأكيد وكتابة البرامج النصية
Section titled “التأكيد وكتابة البرامج النصية”pools create و pools update تسأل قبل تغيير أي شيء. أجب y
على محطة طرفية، أو قم بتمرير --yes (-y) في البرنامج النصي. بدون محطة طرفية و بدون --yes يرفض الأمر ولا يغير شيئًا. pools create
تحمل مفتاحًا متجانسًا، لذا فإن إعادة المحاولة التلقائية CLIلـ بعد حدوث خطأ في الشبكة لا تضيف مجمعين أبدًا.
إضافة --json لطباعة ما أرجعته «Runner Farm». usage --json تطبع
{ "balance": …, "usage": …, "period": "YYYY-MM" }.
champrep rf pools ls --json | jq -r '.pools[] | "\(.id) \(.state) \(.busy)/\(.max_concurrent)"'تتبع أرقام الرصيد دورك: يراها المالكون ومديرو الفوترة دائمًا؛ بينما يراها المسؤولون والأعضاء فقط عندما يُظهر الحساب رصيدًا لهم. تظهر الأرقام المخفية على النحو التالي -.
ما يبقى في تطبيق الويب
Section titled “ما يبقى في تطبيق الويب”لأغراض الأمان، لاCLI يمكن لـ الوصول إلى أي شيء يصدر أو يستبدل أو يختبر بيانات الاعتماد. استخدم تطبيق الويب الخاص بـ Runner Farm من أجل:
- إنشاء حساب مزرعة أو نقل حساب إلى منظمة؛
- إضافة اتصال، أو إقران CHAMPREPرمز مُدار ذاتيًا، أو استبدال رمز المُشغّل أو سر الموصل؛
- تحذف أو تستعيد الاتصالات والمجموعات، وتغلق الحساب، وتغير إعداد رؤية التكلفة.
الأخطاء التي قد تظهر لك
Section titled “الأخطاء التي قد تظهر لك”| رسالة | ماذا تفعل |
|---|---|
payment required … (INSUFFICIENT_CREDITS) | الرصيد غير كافٍ لدفع تكلفة فئة الجهاز. اشترِ رصيدًا أو انتظر الفترة التالية؛ يقترحCLI الذهاب إلى «الفوترةCHAMPREP». رمز الخروج 1. |
payment required … (PENDING_INVOICE), (WORKSPACE_NOT_BILLED) | يوجد فاتورة غير مدفوعة للحساب أو انتهت صلاحية خطته. يقوم المالك أو مدير الفواتير بتسويتها في قسم «الفواتيرCHAMPREP». |
needs your web session … (INTERACTIVE_SESSION_REQUIRED) | أنت وحدك، بعد تسجيل الدخول إلى التطبيق على الويب، يمكنك اتخاذ هذا القرار. قم بذلك في https://runners.champrep.com. |
not allowed for your role … (ROLE_REQUIRED) | دورك في مساحة العمل لا يسمح بهذا التغيير. استشر المالك أو المسؤول. |
not allowed for your role … (WORKSPACE_NOT_AVAILABLE) | --workspace يُشير إلى مساحة عمل لست عضوًا فيها. تحقق من ذلك champrep rf accounts ls. |
not available to your account … | لا تشمل خطتك خدمة Runner Farm أو هذه الفئة أو هذا الحد. |
rate limited … (CAPACITY_EXHAUSTED) | جميع المساحات مشغولة. انتظر وحاول مرة أخرى؛ شراء الرصيد لن يساعد. |
not found … | لا يوجد مثل هذا التجمع أو الاتصال في هذا الحساب، أو أن مساحة العمل لا تمتلك حساب مزرعة بعد. |
تنتهي حالات الرفض هذه بالرمز 1، وكذلك مع --json. rate limited
(CAPACITY_EXHAUSTED) تنتهي 5؛ انظر
رموز الخروج.