تنزيل Chappy - تنزيل رمز المصدر Chappy

Chappy

شفرة المصدر الأخرى

1.0.0

تنزيل

تشابي

Chappy هي أبسط طريقة لنشر مواقع الويب باستخدام Withub Webhooks.

حدد البرنامج النصي للمشروع والنشر لتشغيله وسيستمع Chappy للتغييرات في GitHub Repo الخاص بك ونشرها تلقائيًا. إنه مثالي للنشرات الصغيرة مثل خادم DigitalOcean واحد ❄

دليل البدء السريع

تحميل

نظام التشغيل
Linux X64
ماكسوس (10.7 وما فوق)
Windows X64
Windows X32

هناك المزيد من الخيارات لأنواع مختلفة من نظام التشغيل في مجلد build .

تثبيت

للبدء ، قم بتنزيل القابل للتنفيذ الصحيح لنظام التشغيل الخاص بك ، ونقله إلى دليل في $PATH الخاص بك. على سبيل المثال على Linux X64:

$ mv chappy-linux-amd64 chappy
$ chmod +x chappy
$ sudo mv chappy /usr/local/bin/chappy

أسئلة؟ يمكنك قراءة تعليمات تثبيت الخطوة بخطوة لـ Linux و Mac و Windows.

إنشاء مشروع

والخطوة التالية هي إنشاء ملف مشاريع سيحدد Webhooks التي ترغب في تقديمها لعملية واحدة أو أكثر. أولاً ، قم بإنشاء ملف projects.json فارغ في دليل منزلك أو WWW. دعنا نحدد مشروعًا يدعى MyWebsite الذي سيقوم بتشغيل برنامج نصي نشر يقع في /var/www/MyWebsite/deploy.sh .

[
  {
    "name" : " MyWebsite " ,
    "branch" : " master " ,
    "script" : " /var/www/MyWebsite/deploy.sh " ,
    "secret" : " <SECRET> "
  }
]

؟ للتأكد من أنه يمكن لـ GitHub فقط تشغيل webhook ، يجب أن يكون لكل مشروع سلسلة سرية فريدة. يمكنك إنشاء سلسلة أحرف عشوائية 32 بسرعة عن طريق تشغيل chappy secret ، أو استخدام مولد كلمة مرور عشوائية - في كلتا الحالتين ، تأكد من استبدال <SECRET> .

إنشاء برنامج نصي نشر

يجب أن يكون البرنامج النصي الخاص بك هو برنامج نصي قابل للتنفيذ (تأكد من chmod +x deploy.sh ). في شكله الأساسي ، يجب تشغيل git pull ، لتحديث الريبو بأحدث التغييرات. يثبت المثال أدناه أي تبعيات جديدة مع أصول الملحن و NPM وإعادة بناء الأصول باستخدام Gulp.

 #! /bin/bash
git pull
composer install
npm install
gulp --production

يتم تمرير الوسائط التي تحتوي على تفاصيل الحدث إلى البرنامج النصي ، والذي يمكن استخدامه لتشغيل الأوامر ديناميكيًا. هناك بعض أمثلة Script الأكثر تقدمًا على صفحة SPOIND SCRPRIM التي توضح كيفية استخدام هذه الميزة.

يمكنك الآن البدء في استخدام chappy

$ chappy start

⚙ تحقق من صفحة CLI لمشاهدة قائمة بالأوامر المتاحة ، وكيفية تكوين IP والمنفذ الذي يعمل عليه Chappy وتمكين إعدادات أخرى مثل إعادة تحميل ملف المشاريع أو التقديم عبر HTTPS.

إنشاء webhook

أضف Webhook جديدًا إلى Github Repo ، والذي يمكن العثور عليه في الإعدادات -> WebHooks -> إضافة WebHook.

بشكل افتراضي ، سيكون عنوان URL لـ Payload هو IP الخاص بك ، المنفذ 9000 ثم اسم مشروعك. IE http://123.456.0.1:9000/MyWebsite .
ينصح نوع محتوى application/json ولكن يمكن أن يكون أي شيء.
يجب أن يكون السر السلسلة السرية التي حددتها في projects.json .
الحدث الذي تحتاجه للاستماع إليه هو مجرد حدث push .

الاختبار

⏰ سيأتي قريبًا - سيقوم Chappy بتسجيل الدخول إلى ملف يتيح لك معرفة ما إذا كان أي شيء خاطئ - والاستماع إلى حدث Github ping لتخطي الاضطرار إلى التزام الاختبار.

لاختبار كل شيء يتم تشغيله بنجاح ، قم بإجراء اختبار التزام أو سحب إلى الفرع الرئيسي ( "Beep, Boop! - Testing Chappy ?" هل ستعمل بشكل جيد).

إذا انتهى Webhook بدون أخطاء ويتم تشغيل البرنامج النصي بشكل صحيح ، فهناك تهانينا؟! إذا كانت هناك أخطاء ، يرجى قراءة صفحة استكشاف الأخطاء وإصلاحها أو إرسال مشكلة. ؟