أوامر Runner
كل أمر هو champrep-code-runner <command>. أضف -h إلى أي أمر لمعرفة خياراته، على سبيل المثال champrep-code-runner service -h.
الأوامر اليومية
Section titled “الأوامر اليومية”| المهمة | الأمر |
|---|---|
| قم بتوصيل هذا الجهاز ببرنامج التشغيل | 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 |
التشغيل في محطة طرفية
Section titled “التشغيل في محطة طرفية”champrep-code-runner runيستمر المشغل في العمل ويستقبل المهام حتى تقوم بإيقافه. اضغط على Ctrl+C مرة واحدة لإيقافه بعد انتهاء المهام الجارية؛ اضغط عليه مرة أخرى لمقاطعتها.
التشغيل كخدمة
Section titled “التشغيل كخدمة”تقوم إحدى الخدمات بتشغيل المشغل عند بدء التشغيل وإعادة تشغيله بعد حدوث أي فشل. قم بتسجيل الجهاز أولاً: service install يرفض التكوين الذي لا يحتوي على برامج تشغيل.
sudo champrep-code-runner service install # install, enable at boot and startchamprep-code-runner service status # running, stopped or not installedsudo champrep-code-runner service stop # running jobs finish firstsudo champrep-code-runner service startsudo champrep-code-runner service uninstall # stop and remove the serviceservice status يُطبع running, stopped أو not installed. ويخرج برمز 3 عندما لا تكون الخدمة قيد التشغيل، لذا يمكن للبرامج النصية التحقق من ذلك.
| خيار | المعنى |
|---|---|
--config PATH | التكوين الذي تستخدمه الخدمة. |
--name NAME | اسم الخدمة. استخدم أسماء مختلفة لتشغيل عدة برامج تشغيل بتكوينات مختلفة على جهاز واحد. |
--user USER | قم بتشغيل الخدمة باسم هذا المستخدم بدلاً من root أو LocalSystem. |
بصفته مستخدم «root»، يقوم المشغل بتثبيت خدمة systemd باسم champrep-code-runner. كـ مستخدم آخر، يقوم بتثبيت خدمة مستخدم، والتي تعمل أثناء تسجيل دخولك (استخدم loginctl enable-linger للحفاظ على تشغيله). يمكنك أيضًا استخدام systemd مباشرةً:
systemctl status champrep-code-runnerjournalctl -u champrep-code-runner -f # follow the logsبالنسبة لمُنفِّذ Docker، يحتاج مستخدم الخدمة إلى الوصول إلى مقبس Docker، وهو ما يعادل صلاحيات الجذر على ذلك الجهاز. استخدم جهازًا مخصصًا للبناء.
بصفته مستخدمًا جذر، يقوم المشغل بتثبيت LaunchDaemon (com.champrep.code-runner) الذي يبدأ عند الإقلاع. وبصفتك مستخدمًا آخر، يقوم بتثبيت LaunchAgent الذي يعمل أثناء تسجيل دخولك، وهو ما يناسب المهام التي تتطلب سلسلة المفاتيح أو المحاكي أو توقيع الكود. السجلات:
tail -f /Library/Logs/champrep-code-runner.log # LaunchDaemontail -f ~/Library/Logs/champrep-code-runner.log # LaunchAgent
ويندوز
Section titled “ويندوز”من موجه PowerShell ذي الصلاحيات المرتفعة:
champrep-code-runner.exe service installGet-Service champrep-code-runnerتقوم الخدمة بتشغيل الملف الثنائي من مكانه الحالي، لذا انسخه إلى مكان ثابت أولاً. تذهب السجلات إلى champrep-code-runner.log بجوار ملف التكوين (%ProgramData%\champrep-runner\).
جميع الأوامر
Section titled “جميع الأوامر”| الأمر | ماذا يفعل |
|---|---|
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 “فحوصات الحالة والمقاييس”ابدأ تشغيل المشغل بعنوان استماع لإظهار نقاط نهاية الحالة والمقاييس:
champrep-code-runner run --listen-address 127.0.0.1:9252| المسار | المعنى |
|---|---|
/healthz | 200 أثناء تشغيل العملية. |
/readyz | 200 عندما يتم التحقق من كل مشغل ويطلب المهام. |
/metrics | مقاييس Prometheus: المهام قيد التشغيل، والمنتهية، والفاشلة، والمزيد. |
السجلات هي ملفات JSON منظمة ولا تحتوي أبدًا على الرموز المميزة أو المتغيرات أو مخرجات المهام.