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

تسجيل برنامج تشغيل

يؤدي التسجيل إلى ربط جهاز بمشغل قمت بإنشائه في CodeCHAMPREP. أنت بحاجة إلى مشغل رمز المصادقة، والتي تبدأ بـ ccrt_.

1. إنشاء المشغل في CHAMPREPCode

Section titled “1. إنشاء المشغل في CHAMPREPCode”
  1. افتح مشروعك (أو مجموعتك) وانتقل إلى الإعدادات > CI/CD > المشغلات.
  2. اختر مشغل جديد.
  3. اختر المهام التي سيقوم بها:
    • العلامات: المهام التي تحتوي على tags: التشغيل فقط على المشغلات التي تمتلكها جميعًا.
    • تشغيل المهام غير الموسومة: ما إذا كان يقبل أيضًا المهام التي لا تحتوي على علامات.
    • محمي: تشغيل المهام الخاصة بالفروع والعلامات المحمية فقط.
  4. اختر إنشاء مشغل وانسخ الرمز المميز. يتم عرضه مرة واحدة فقط.

تعامل مع الرمز ككلمة مرور. يمكن لأي شخص يمتلكه الاستيلاء على مهامك.

الطريقة الأبسط، في محطة طرفية على الجهاز:

Terminal window
champrep-code-runner register --url https://code.champrep.com

يطلب المشغل الرمز (دون إظهاره) والمُنفِّذ. ويقوم بالتحقق من الرمز، ثم يحفظ المشغل في ملف التكوين الخاص به.

لكتابة برنامج نصي لذلك، قم بتمرير الرمز المميز عبر المدخلات القياسية أو من ملف، بحيث لا يظهر أبدًا في سجل شل الخاص بك أو قائمة العمليات:

Terminal window
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \
--url https://code.champrep.com --token-stdin \
--name build-01 --executor shell
Terminal window
champrep-code-runner register --url https://code.champrep.com \
--token-file /root/runner-token --executor docker --docker-image alpine:3.24

في نظام Windows، من موجه PowerShell بامتيازات عالية:

Terminal window
$env:RUNNER_TOKEN | champrep-code-runner.exe register `
--url https://code.champrep.com --token-stdin --name win-build-01 `
--executor shell --shell pwsh

خيارالمعنى
--urlعنوان CodeCHAMPREP الخاص بك، على سبيل المثال https://code.champrep.com.
--token-stdin / --token-file PATHقراءة الرمز المميز من المدخلات القياسية أو من ملف.
--name NAMEاسم المشغل على هذا الجهاز (الافتراضي: اسم المضيف).
--executorshell, docker أو kubernetes.
--shellبالنسبة لمُنفِّذ shell: bash, sh, pwsh أو powershell.
--docker-image IMAGEصورة المهمة الافتراضية لمُنفِذي Docker و Kubernetes.
--kubernetes-namespace NSتشغيل مهام Kubernetes في مساحة الأسماء هذه.
--limit Nما لا يزيد عن N مهام في وقت واحد لهذا المشغل.
--non-interactiveلا تطلب تأكيدًا أبدًا؛ افشل المهمة في حالة فقدان قيمة ما.
--config PATHاستخدم ملف التكوين هذا (انظر أدناه).

CHPCODE_RUNNER_URL و CHPCODE_RUNNER_TOKEN يمكن استبدال --url و خيارات الرمز المميز.

عند تشغيله كـالملف
root (Linux، macOS)/etc/champrep-runner/config.toml
موجه أوامر بامتيازات عالية أو الخدمة (Windows)%ProgramData%\champrep-runner\config.toml
أي مستخدم آخر~/.champrep-runner/config.toml

CHPCODE_RUNNER_CONFIG أو --config اختر ملفًا آخر. الملف تم إنشاؤه بصورة قابلة للقراءة فقط من قبل مالكه. يمكن لجهاز واحد استيعاب عدة مشغلات: قم بالتسجيل مرة أخرى باستخدام --name.

Terminal window
champrep-code-runner run # in this terminal
champrep-code-runner service install # or as a service that starts at boot

انظر أوامر المشغل للتحقق من حالته، وإيقافه، وغير ذلك.