تسجيل برنامج تشغيل
يؤدي التسجيل إلى ربط جهاز بمشغل قمت بإنشائه في CodeCHAMPREP. أنت بحاجة إلى مشغل رمز المصادقة، والتي تبدأ بـ ccrt_.
1. إنشاء المشغل في CHAMPREPCode
Section titled “1. إنشاء المشغل في CHAMPREPCode”- افتح مشروعك (أو مجموعتك) وانتقل إلى الإعدادات > CI/CD > المشغلات.
- اختر مشغل جديد.
- اختر المهام التي سيقوم بها:
- العلامات: المهام التي تحتوي على
tags:التشغيل فقط على المشغلات التي تمتلكها جميعًا. - تشغيل المهام غير الموسومة: ما إذا كان يقبل أيضًا المهام التي لا تحتوي على علامات.
- محمي: تشغيل المهام الخاصة بالفروع والعلامات المحمية فقط.
- العلامات: المهام التي تحتوي على
- اختر إنشاء مشغل وانسخ الرمز المميز. يتم عرضه مرة واحدة فقط.
تعامل مع الرمز ككلمة مرور. يمكن لأي شخص يمتلكه الاستيلاء على مهامك.
2. تسجيل الجهاز
Section titled “2. تسجيل الجهاز”الطريقة الأبسط، في محطة طرفية على الجهاز:
champrep-code-runner register --url https://code.champrep.comيطلب المشغل الرمز (دون إظهاره) والمُنفِّذ. ويقوم بالتحقق من الرمز، ثم يحفظ المشغل في ملف التكوين الخاص به.
لكتابة برنامج نصي لذلك، قم بتمرير الرمز المميز عبر المدخلات القياسية أو من ملف، بحيث لا يظهر أبدًا في سجل شل الخاص بك أو قائمة العمليات:
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \ --url https://code.champrep.com --token-stdin \ --name build-01 --executor shellchamprep-code-runner register --url https://code.champrep.com \ --token-file /root/runner-token --executor docker --docker-image alpine:3.24في نظام Windows، من موجه PowerShell بامتيازات عالية:
$env:RUNNER_TOKEN | champrep-code-runner.exe register ` --url https://code.champrep.com --token-stdin --name win-build-01 ` --executor shell --shell pwsh
خيارات شائعة
Section titled “خيارات شائعة”| خيار | المعنى |
|---|---|
--url | عنوان CodeCHAMPREP الخاص بك، على سبيل المثال https://code.champrep.com. |
--token-stdin / --token-file PATH | قراءة الرمز المميز من المدخلات القياسية أو من ملف. |
--name NAME | اسم المشغل على هذا الجهاز (الافتراضي: اسم المضيف). |
--executor | shell, 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 و خيارات الرمز المميز.
مكان حفظ التكوين
Section titled “مكان حفظ التكوين”| عند تشغيله كـ | الملف |
|---|---|
| root (Linux، macOS) | /etc/champrep-runner/config.toml |
| موجه أوامر بامتيازات عالية أو الخدمة (Windows) | %ProgramData%\champrep-runner\config.toml |
| أي مستخدم آخر | ~/.champrep-runner/config.toml |
CHPCODE_RUNNER_CONFIG أو --config اختر ملفًا آخر. الملف تم إنشاؤه بصورة قابلة للقراءة فقط من قبل مالكه. يمكن لجهاز واحد استيعاب عدة مشغلات: قم بالتسجيل مرة أخرى باستخدام --name.
3. قم بتشغيلها
Section titled “3. قم بتشغيلها”champrep-code-runner run # in this terminalchamprep-code-runner service install # or as a service that starts at bootانظر أوامر المشغل للتحقق من حالته، وإيقافه، وغير ذلك.