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

أوامر Runner

كل أمر هو champrep-code-runner <command>. أضف -h إلى أي أمر لمعرفة خياراته، على سبيل المثال champrep-code-runner service -h.

المهمةالأمر
قم بتوصيل هذا الجهاز ببرنامج التشغيلchamprep-code-runner register --url https://code.champrep.com
قم بالتشغيل في محطة العمل هذهchamprep-code-runner run
قم بالتثبيت كخدمة وابدأ تشغيلهاchamprep-code-runner service install
هل يعمل؟champrep-code-runner service status
أوقفها (تنتهي المهام الجارية أولاً)champrep-code-runner service stop
أعد تشغيلهchamprep-code-runner service start
تحقق من رمز المشغلchamprep-code-runner verify
عرض الإصدار المثبتchamprep-code-runner version
تحقق من ملف التكوينchamprep-code-runner check-config

Terminal window
champrep-code-runner run

يستمر المشغل في العمل ويستقبل المهام حتى تقوم بإيقافه. اضغط على Ctrl+C مرة واحدة لإيقافه بعد انتهاء المهام الجارية؛ اضغط عليه مرة أخرى لمقاطعتها.

تقوم إحدى الخدمات بتشغيل المشغل عند بدء التشغيل وإعادة تشغيله بعد حدوث أي فشل. قم بتسجيل الجهاز أولاً: service install يرفض التكوين الذي لا يحتوي على برامج تشغيل.

Terminal window
sudo champrep-code-runner service install # install, enable at boot and start
champrep-code-runner service status # running, stopped or not installed
sudo champrep-code-runner service stop # running jobs finish first
sudo champrep-code-runner service start
sudo champrep-code-runner service uninstall # stop and remove the service

service status يُطبع running, stopped أو not installed. ويخرج برمز 3 عندما لا تكون الخدمة قيد التشغيل، لذا يمكن للبرامج النصية التحقق من ذلك.

خيارالمعنى
--config PATHالتكوين الذي تستخدمه الخدمة.
--name NAMEاسم الخدمة. استخدم أسماء مختلفة لتشغيل عدة برامج تشغيل بتكوينات مختلفة على جهاز واحد.
--user USERقم بتشغيل الخدمة باسم هذا المستخدم بدلاً من root أو LocalSystem.

بصفته مستخدم «root»، يقوم المشغل بتثبيت خدمة systemd باسم champrep-code-runner. كـ مستخدم آخر، يقوم بتثبيت خدمة مستخدم، والتي تعمل أثناء تسجيل دخولك (استخدم loginctl enable-linger للحفاظ على تشغيله). يمكنك أيضًا استخدام systemd مباشرةً:

Terminal window
systemctl status champrep-code-runner
journalctl -u champrep-code-runner -f # follow the logs

بالنسبة لمُنفِّذ Docker، يحتاج مستخدم الخدمة إلى الوصول إلى مقبس Docker، وهو ما يعادل صلاحيات الجذر على ذلك الجهاز. استخدم جهازًا مخصصًا للبناء.

بصفته مستخدمًا جذر، يقوم المشغل بتثبيت LaunchDaemon (com.champrep.code-runner) الذي يبدأ عند الإقلاع. وبصفتك مستخدمًا آخر، يقوم بتثبيت LaunchAgent الذي يعمل أثناء تسجيل دخولك، وهو ما يناسب المهام التي تتطلب سلسلة المفاتيح أو المحاكي أو توقيع الكود. السجلات:

Terminal window
tail -f /Library/Logs/champrep-code-runner.log # LaunchDaemon
tail -f ~/Library/Logs/champrep-code-runner.log # LaunchAgent

من موجه PowerShell ذي الصلاحيات المرتفعة:

Terminal window
champrep-code-runner.exe service install
Get-Service champrep-code-runner

تقوم الخدمة بتشغيل الملف الثنائي من مكانه الحالي، لذا انسخه إلى مكان ثابت أولاً. تذهب السجلات إلى champrep-code-runner.log بجوار ملف التكوين (%ProgramData%\champrep-runner\).

الأمرماذا يفعل
registerتحقق من رمز المُشغِّل وأضف المُشغِّل إلى التكوين.
verify [--name N]تحقق من رموز المشغلات المُهيأة؛ ويُخرج الرقم 1 إذا كان أحدها غير صالح.
runيستمر في التشغيل حتى يتم إيقافه. --log-file PATH يكتب السجلات في ملف.
run-single [--name N] [--max-jobs 1]تشغيل مهام مشغل واحد، ثم الخروج. مفيد للأجهزة ذات العمر الافتراضي القصير.
service install|start|stop|status|uninstallإدارة المشغل كخدمة.
reset-token [--name N]احصل على رمز جديد واحفظه. سيظل الرمز القديم يعمل لفترة سماح قصيرة.
unregister --name N أو --allإزالة برنامج التشغيل الخاص بهذا الجهاز من التكوين ومن CodeCHAMPREP.
check-configالتحقق من صحة ملف التكوين وعرض التحذيرات.
versionاطبع الإصدار والمراجعة والمنصة.

يقبل كل أمر --config PATH لاستخدام ملف تكوين آخر.

فحوصات الحالة والمقاييس

Section titled “فحوصات الحالة والمقاييس”

ابدأ تشغيل المشغل بعنوان استماع لإظهار نقاط نهاية الحالة والمقاييس:

Terminal window
champrep-code-runner run --listen-address 127.0.0.1:9252
المسارالمعنى
/healthz200 أثناء تشغيل العملية.
/readyz200 عندما يتم التحقق من كل مشغل ويطلب المهام.
/metricsمقاييس Prometheus: المهام قيد التشغيل، والمنتهية، والفاشلة، والمزيد.

السجلات هي ملفات JSON منظمة ولا تحتوي أبدًا على الرموز المميزة أو المتغيرات أو مخرجات المهام.