تخطَّ إلى المحتوى
Documentation

أوامر Runner Farm

champrep runner-farm، أو الاسم المختصر الخاص بها champrep rf، يدير CHAMPREP «Runner Farm» من جهازك الطرفي: حسابات المزرعة الخاصة بك، واتصالات مضيف الكود ، ومجموعات المشغلات وفئات أجهزتها، والرصيد و الدقائق التي استخدمتها، والمهام التي نفذتها المزرعة. يعمل البرنامج نيابة عنك، باستخدام معلومات تسجيل الدخول العادية CLI الخاصة بك، لذا فإن دورك في الحساب وخطة الاشتراك الخاصة بك تنطبقان تمامًا كما هو الحال في تطبيق الويب «Runner Farm».

  1. تثبيت CLI و تسجيل الدخول مع champrep auth login.
  2. يجب أن تتضمن خطتك «مزرعة المشغلات» (Runner Farm)، وتحتاج مساحة العمل إلى حساب المزرعة . قم بإنشاء الحساب وإضافة الاتصالات في تطبيق الويب «مزرعة المشغلات» على https://runners.champrep.com.

يمكنك العمل في أكثر من حساب مزرعة واحد: حسابك الخاص، وحساب مؤسسة أو حساب فريق. قم بإدراجها، ثم اختر واحدًا منها باستخدام --workspace:

Terminal window
champrep rf accounts ls
champrep rf pools ls --workspace organization:65f0c0ffee0000000000abcd

--workspace يأخذ KEY عمود من accounts ls: personal, organization:<id> أو team:<id>. بدون ذلك، تختار المزرعة الحساب بنفس الطريقة التي يتبعها التطبيق الويب: حساب مؤسستك أو فريقك إذا كان متوفرًا، وإلا فحسابك الخاص.

الأمرالغرض
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).

خيارالقيم
--classcpu-2, cpu-4, cpu-8, arm64-2, arm64-4, build-4
--isolationshared_hardened (الافتراضي) أو tenant_dedicated
--max-concurrentالمهام في وقت واحد، من 0 إلى 500
--min-idleالمهام الجاهزة التي يتم الاحتفاظ بها، من 0 إلى 50
--timeoutمهلة انتهاء المهام من 15m إلى 6h، على سبيل المثال 90m أو 2h

تحدد خطتك الفئات ومستويات العزل والحدود التي يمكنك استخدامها. تظهر المجموعة التي تجاوزت حدود الخطة بعد تخفيض المستوى above plan في pools ls.

اطلع على مكان تشغيل مهامك ومدى انشغال المجموعات:

Terminal window
champrep rf connections ls
champrep rf pools ls
champrep rf pools show pol_01HZX9K4

أضف مجموعة لإنشاء الصور وقم بإيقافها مؤقتًا للصيانة:

Terminal window
champrep rf pools create --connection con_01HZX7 --name Builds \
--class build-4 --max-concurrent 4 --timeout 2h --yes
champrep rf pools update pol_01HZX9K4 --pause --yes
champrep rf pools update pol_01HZX9K4 --resume --max-concurrent 8 --yes

تحقق مما استخدمته خلال هذه الفترة والشهر الماضي:

Terminal window
champrep rf usage
champrep rf usage --period 2026-10

البحث عن المهام التي في حالة انتظار أو معلقة:

Terminal window
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" }.

Terminal window
champrep rf pools ls --json | jq -r '.pools[] | "\(.id) \(.state) \(.busy)/\(.max_concurrent)"'

تتبع أرقام الرصيد دورك: يراها المالكون ومديرو الفوترة دائمًا؛ بينما يراها المسؤولون والأعضاء فقط عندما يُظهر الحساب رصيدًا لهم. تظهر الأرقام المخفية على النحو التالي -.

لأغراض الأمان، لا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؛ انظر رموز الخروج.