تخطَّ إلى المحتوى
GitTree
خطوط CI/CD

تشغيل خطوط المعالجة محليًا

يجهّز GitTree أمر act أو gitlab-ci-local المطابق لملف سير عمل أو لمهمة واحدة، ويكتبه في طرفية جديدة لتشغّله بنفسك. تعمل المهام داخل حاويات Docker على حاسوبك قبل الدفع. خطوط المعالجة المحلية جزء من الخطة المجانية ولا تحتاج إلى حساب استضافة.

مجانيآخر تحديث

يعمل في GitTree المجاني: كل ميزات Git المحلية دون حاجة إلى حساب.

في هذه الصفحة
  1. قبل أن تبدأ
  2. أين تجده
  3. الخطوات
  4. النتيجة المتوقعة
  5. تثبيت Docker والمشغّلين
  6. الملفات النموذجية
  7. Bitbucket Pipelines وAzure Pipelines
  8. كيف يختلف التشغيل المحلي عن الاستضافة
  9. إن لم يسر الأمر كما توقعت
  10. أسئلة
  11. ذو صلة

قبل أن تبدأ

  • Docker قيد التشغيل: Docker Desktop أو OrbStack أو Colima أو Docker Engine. يبدأ المشغّلان كل مهمة داخل حاوية.
  • المشغّل المناسب لملفك: act لـ GitHub Actions ‏(.github/workflows/*.yml)، وgitlab-ci-local لـ GitLab CI ‏(.gitlab-ci.yml). ثبّته خارج المستودع في مجلد ضمن PATH.
  • مستودع موثوق (الوثوق بالمستودع): التشغيل المحلي ينفّذ شيفرة المستودع.
  • صدفة طرفية مدعومة: bash أو zsh أو sh أو fish على macOS، وPowerShell على Windows، وbash أو zsh أو sh أو fish على لينكس.

أين تجده

  • زر CI/CD في شريط الأدوات: دون حساب متصل أو خطة Pro يُفتح العرض على خطوط المعالجة المحلية.
  • قسم الأدوات في اللوحة اليسرى: تجهيز مسار محلي.
  • الأدوات في شريط الأدوات (بجانب الطرفية) أو قائمة تبويب المستودع: تجهيز مسار محلي…، وأيضًا في لوحة الأوامر أو بالاختصار Alt+Shift+L.
الإجراءmacOSWindows وLinux
لوحة الأوامر، ثم تجهيز مسار محلي…⌘⇧PCtrl+Shift+P
إظهار CI/CD⌥PAlt+P

الخطوات

  1. تحقّق مما تحتاج إليه

    افتح CI/CD. يعرض خطوط المعالجة المحلية قسم ما تحتاج إليه: Docker وact وgitlab-ci-local مع موجود أو غير موجود ومكان كلٍّ منها، ووثوق المستودع، وصدفة الطرفية. يذكر البرنامج المفقود طريقة تثبيته؛ ثبّته ثم اضغط افحص مجددًا. اطلب من نور إعداد المشغّل المحلي جزء من Pro، المتاح للجميع بلا تكلفة الآن. تجهيز الأمر وتشغيله محليًا لا يحتاج إلى ذلك.

    عرض CI/CD على خطوط المعالجة المحلية، مع العثور على Docker وact وعدم العثور على gitlab-ci-local
    خطوط المعالجة المحلية معلّمة مجاني. التشغيلات المستضافة فوقها ما زالت تحتاج إلى حساب متصل.واجهة GitTree مع مستودع للعرض.

  2. أضف ملف خط معالجة أو استخدم ملفك

    يسرد ملفات خطوط المعالجة في هذا المستودع كل ملف مع جاهز للتشغيل أو سبب تعذّر تشغيله. إن لم يوجد ملف، يكتب إضافة نموذج GitHub Actions الملف .github/workflows/gittree-local.yml ويكتب إضافة نموذج GitLab CI الملف .gitlab-ci.yml، ولكلٍّ منهما مهمتان مشروحتان. لا يكتب GitTree فوق ملف موجود أبدًا. يُفتح الملف في المحرر: ضع فيه أوامر البناء والاختبار.

  3. جهّز الأمر

    اضغط تشغيل محلي…. في تجهيز مسار محلي اختر إعداد المسار والمهمة أو المهام الافتراضية للمشغّل وصدفة الطرفية، ثم تجهيز الأمر. لا يُشغَّل شيء بعد.

  4. شغّله في الطرفية

    اقرأ الأمر المُجهّز ثم اختر الكتابة في طرفية جديدة. يكتبه GitTree في طرفية جديدة ولا يضغط Enter أبدًا: راجعه واضغط Enter بنفسك. يظهر خرج المهمة في الطرفية.

النتيجة المتوقعة

يسحب المشغّل صورة المهمة في المرة الأولى، ثم ينفّذ كل خطوة داخل حاوية ويطبع نتيجتها في الطرفية. تُستخدم ملفات المستودع كما هي على القرص، أُودعت أم لا.

تثبيت Docker والمشغّلين

ما تثبّته على كل نظام
البرنامجmacOSWindowsلينكس
DockerDocker Desktop أو OrbStack أو ColimaDocker DesktopDocker Engine أو Docker Desktop
act ‏(GitHub Actions)brew install actwinget install nektos.actسكربت التثبيت في nektosact.com
gitlab-ci-local ‏(GitLab CI)npm install -g gitlab-ci-localملف ‎.exe من إصداراته على GitHub في مجلد ضمن PATHnpm install -g gitlab-ci-local

يحتاج gitlab-ci-local إلى Node.js 18 أو أحدث عند تثبيته بـ npm. يبحث GitTree عن البرامج في PATH فقط ولا يشغّلها للتحقق، لذا لا يعرف إن كان محرك Docker يعمل.

الملفات النموذجية

يشغّل نموذج GitHub Actions مهمة build ثم مهمة test على ubuntu-latest. في التشغيل الأول يسأل act عن صورة المشغّل؛ يناسب Medium معظم المشاريع. ويشغّل نموذج GitLab CI المهمتين نفسيهما داخل حاويات alpine. استبدل أسطر echo بأوامرك، ثم أودِع الملف عندما يصبح جاهزًا. إن كان المستودع على GitHub أو GitLab فستشغّل الاستضافة الملف أيضًا.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: npm ci && npm run build
  test:
    runs-on: ubuntu-latest
    needs: build
    steps:
      - uses: actions/checkout@v4
      - name: Test
        run: npm test

Bitbucket Pipelines وAzure Pipelines

لا يوجد مشغّل محلي مدعوم لـ bitbucket-pipelines.yml أو azure-pipelines.yml، لذا تظهر هذه الملفات بحالة لا مشغّل محلي. لتشغيل الخطوات نفسها على حاسوبك، أضف نموذج GitHub Actions أو GitLab CI وانسخ أوامرك إليه. ويستمر خط المعالجة المستضاف في العمل من ملفه.

كيف يختلف التشغيل المحلي عن الاستضافة

  • الأسرار والمتغيرات المضبوطة في الاستضافة غير متاحة؛ مرّر ما تحتاج إليه المهمة إلى المشغّل بنفسك.
  • يشغّل act المهام التي يطلقها الدفع افتراضيًا. اختر المهمة لتشغيل واحدة أيًّا كان مُطلقها.
  • لا تُحل التضمينات والقوالب وسير العمل القابل لإعادة الاستخدام عندما يسرد GitTree المهام؛ يحلّها المشغّل عند التشغيل.
  • تستطيع الحاويات الوصول إلى شبكتك واستخدام بيانات الاعتماد التي تمنحها إياها.

إن لم يسر الأمر كما توقعت

لم يُعثر على مشغّل أصلي آمن في PATH.

ثبّت act أو gitlab-ci-local في مجلد ضمن PATH خارج المستودع، ثم اضغط افحص مجددًا أو تحديث. على macOS أغلق GitTree وافتحه مجددًا إن غيّرت PATH في ملف إعداد الصدفة.

لا يوجد مشغّل محلي مدعوم لإعداد هذا المزوّد.

الملف خط معالجة Bitbucket أو Azure. أضف نموذج GitHub Actions أو GitLab CI وانسخ الخطوات إليه.

يجب الوثوق بالمستودع قبل تجهيز أمر مسار محلي.

ثق بالمستودع أولًا (الوثوق بالمستودع)، ثم جهّز الأمر مجددًا.

تقول الطرفية إنها لا تستطيع الاتصال بخادم Docker.

شغّل Docker Desktop أو OrbStack أو Colima أو خدمة Docker، وانتظر حتى يعمل، ثم اضغط Enter على الأمر مجددًا.

أسئلة

هل تحتاج خطوط المعالجة المحلية إلى GitTree Pro أو حساب استضافة؟

لا. خطوط المعالجة المحلية جزء من الخطة المجانية وتقرأ ملفات مستودعك فقط. أما تشغيلات CI/CD المستضافة وإعادة تشغيلها والموافقات فجزء من Pro.

هل يشغّل GitTree خط المعالجة نيابة عني؟

لا. يجهّز GitTree الأمر ويكتبه في طرفية؛ وأنت تضغط Enter. لا يُشغَّل شيء قبل ذلك.

ذو صلة