كيفية إنشاء مهمة بناء جديدة في Jenkins مشروع حرة
فريق التحرير
⚡ ملخص ذكي
Jenkins مشروع Freestyle هو مهمة بناء قابلة للتكرار تجمع بين استخراج شفرة المصدر وخطوات البناء والإجراءات اللاحقة للبناء في مهمة واحدة قابلة للتكوين، يتم إنشاؤها بالكامل من خلال Jenkins واجهة ويب بدون كتابة كود برمجي.
ما هو Jenkins مشروع ارتجالي؟
Jenkins مشروع حرة هي مهمة بناء أو نص برمجي أو مسار عمل قابل للتكرار يتضمن خطوات وإجراءات ما بعد البناء. وهي مهمة محسّنة يمكن أن تشمل عمليات متعددة. تتيح لك هذه المهمة تكوين مشغلات البناء وتوفر أمانًا قائمًا على المشروع لـ Jenkins المشروع. كما يوفر إضافات لمساعدتك في إنشاء الخطوات والإجراءات اللاحقة للبناء.
أنواع الإجراءات التي يمكنك القيام بها في Jenkins تُعدّ خطوات البناء أو الإجراءات اللاحقة للبناء محدودة للغاية. تتوفر العديد من الإضافات القياسية ضمن Jenkins مشروع حر لمساعدتك في التغلب على هذه المشكلة.
يوضح الرسم البياني أدناه وضع وظيفة النمط الحر داخل نطاق أوسع التكامل المستمر حلقة، من استخراج المصدر وحتى إجراءات ما بعد البناء التي تُبلغ عن النتيجة.
المتطلبات الأساسية لإنشاء Jenkins وظيفة حرة
قبل أن تنجح الخطوات العشر التالية بشكل كامل، يجب توفر أربعة عناصر. إن إغفال أي منها هو السبب المعتاد لفشل أول محاولة بناء كرة حرة باستخدام كرة حمراء بدلاً من كرة زرقاء.
- الجري Jenkins وحدة تحكم. Jenkins يستمع على المنفذ 8080 افتراضيًا. إذا Jenkins لم يتم تشغيله بعد، اتبع التعليمات دليل التثبيت لأول مرة.
- JDK على الجهاز الذي يقوم بتشغيل عملية البناء. يتم تجميع المثال العملي Java، وبالتالي
javacيجب أن يكون موجودًا في مسار وحدة التحكم أو الوكيل الذي ينفذ المهمة. تأكد من ذلك بسطر واحد.java -versionقم بتنفيذ خطوة البناء قبل إضافة أي شيء آخر. - إضافة Git. استخدم بوابة يظهر هذا الخيار فقط ضمن المصدر Code تتم الإدارة بمجرد تثبيت الملحق، من خلال إدارة Jenkins > الإضافات.
- مستودع يمكن الوصول إليه. بروتوكول HTTPS عام URL لا يتطلب بيانات اعتماد. يحتاج المستودع الخاص إلى بيانات اعتماد مخزنة في Jenkins أولاً، وإلا سيفشل التحقق أثناء عملية البناء الأولى.
حساب لدى إنشاء وظيفة يلزم الحصول على إذن أيضًا - على حساب مستخدم واحد جديد Jenkins الحساب الإداري يمتلكها بالفعل.
كيفية إنشاء مهمة بناء جديدة في Jenkins
تعد مهمة البناء الحر خيارًا مرنًا وسهل الاستخدام للغاية. يمكنك استخدامه لأي نوع من المشاريع؛ فمن السهل إعداده، وتظهر العديد من خياراته في وظائف البناء الأخرى. فيما يلي عملية خطوة بخطوة لإنشاء وظيفة Jenkins.
الخطوة 1) تسجيل الدخول إلى Jenkins
لخلق Jenkins وظيفة حرة، سجل الدخول إلى حسابك Jenkins يمكنك الوصول إلى لوحة التحكم الخاصة بك من خلال زيارة Jenkins مسار التثبيت. عادةً ما يتم استضافته على الخادم المحلي (localhost) على العنوان التالي: http://localhost:8080 إذا كان لديك تثبيت Jenkins في مسار آخر، استخدم المناسب URL للوصول إلى لوحة التحكم الخاصة بك كما هو موضح أدناه Jenkins مثال على خلق فرص عمل.
الخطوة 2) إنشاء عنصر جديد
انقر على "جديدنا ستجد الرابط في أعلى الجانب الأيسر من لوحة التحكم. توضح لقطة الشاشة أدناه مكان وجود هذا الرابط.
الخطوة 3) أدخل تفاصيل العنصر
في الشاشة التالية ،
- أدخل اسم العنصر الذي تريد إنشاءه. يجب علينا استخدام "Hello World" لهذا العرض التوضيحي.
- حدد مشروع حرة
- انقر فوق موافق
الخطوة 4) أدخل تفاصيل المشروع
أدخل تفاصيل المشروع الذي ترغب في اختباره. ستظهر صفحة الإعدادات التي ستفتح أدناه.
الخطوة 5) الدخول إلى المستودع URL
بموجب المصدر Code الإدارة، أدخل مستودعك URLلدينا مستودع اختبار موجود في https://github.com/kriru/firstJava.git
من الممكن أيضًا استخدام مستودع محلي.
إذا كان مستودع GitHub الخاص بك خاصًا، Jenkins سيقوم النظام أولاً بالتحقق من بيانات اعتماد تسجيل الدخول الخاصة بك مع GitHub، وبعد ذلك فقط سيقوم بسحب شفرة المصدر من مستودع GitHub الخاص بك.
الخطوة 6) تعديل الإعدادات
الآن وقد قدمت جميع التفاصيل، حان وقت بناء الكود. اضبط الإعدادات ضمن نساعدك في بناء قسم لإنشاء الكود في الوقت الذي تريده. يمكنك أيضًا جدولة عملية الإنشاء بشكل دوري، في أوقات محددة.
قيد الإنشاء،
- انقر على "أضف خطوة البناء"
- انقر على "تنفيذ Windows أمر دفعة"وأضف الأوامر التي تريد تنفيذها أثناء عملية الإنشاء.
تبدو القائمة المنسدلة التي تسرد خطوات البناء المتاحة على هذا النحو.
⚠️ ملاحظة حول الإصدار: الأخيرة Jenkins تُصدر هذه المنطقة خطوات البناء بدلا من نبنيهاوعلى نظام لينكس أو macOS الخيار المكافئ للوكلاء هو تنفيذ قذيفةلا يزال الزر يُسمى أضف خطوة البناء.
لقد قمت هنا بإضافة أوامر جافا لتجميع كود جافا.
لقد أضفت أوامر الويندوز التالية:
javac HelloWorld.java java HelloWorld
يظهر أدناه مربع الأوامر الذي يحتوي على هذين السطرين المدخلين.
الخطوة 7) احفظ المشروع
وبعد ادخال كافة البيانات
- انقر تطبيق
- التوفير المشروع.
الخطوة 8) بناء كود المصدر
الآن، في الشاشة الرئيسية، انقر فوق الزر Build Now الموجود على الجانب الأيسر لإنشاء الكود المصدري.
الخطوة 9) التحقق من الحالة
بعد النقر على Build now، يمكنك رؤية حالة الإصدار الذي تقوم بتشغيله ضمن Build History.
الخطوة 10) راجع إخراج وحدة التحكم
انقر على رقم الإصدار، ثم انقر على مخرجات وحدة التحكم لعرض حالة الإصدار الذي قمت بتشغيله. من المفترض أن تظهر لك رسالة نجاح، بشرط أن تكون قد اتبعت خطوات الإعداد بشكل صحيح كما هو موضح أدناه. Jenkins إنشاء مثال لوظيفة جديدة.
باختصار، لقد قمنا بتنفيذ برنامج HelloWorld المستضاف على GitHub. Jenkins يقوم بسحب الكود من المستودع البعيد وبنائه باستمرار بتردد تحدده أنت.
Jenkins شرح أقسام تكوين مشروع Freestyle
لا تتناول هذه الخطوات سوى الحقول التي يحتاجها مثال "HelloWorld". تنقسم صفحة الإعدادات إلى ستة أقسام، ومعرفة محتوى كل قسم منها يُسهّل العثور على الخيارات المتبقية.
| القسم | ما الذي يتحكم فيه | الإعداد النموذجي |
| General | وصف المهمة، والتخلص من الإصدارات القديمة، والمعلمات، وما إذا كانت المهمة تعمل على وكيل محدد | Descriptأيون بالإضافة إلى حد الاحتفاظ بالتراكم |
| مصدر Code الإدارة | أي مستودع يجب التحقق منه وبأي بيانات اعتماد وفرع | جيت، بروتوكول HTTPS URL، فرع شجرة */master or */main |
| بناء المشغلات | ما الذي يبدأ عملية البناء تلقائيًا؟ | استطلاع نظام إدارة الإصدارات، أو البناء بشكل دوري، أو استخدام رابط ويب من GitHub |
| بناء البيئة | تم تطبيق أغلفة حول البنية بأكملها | احذف مساحة العمل قبل بدء عملية البناء؛ وأضف الطوابع الزمنية إلى سجل وحدة التحكم. |
| خطوات البناء | الأوامر التي تقوم بالعمل، تعمل من الأعلى إلى الأسفل | تنفيذ Windows أمر دفعي، أو تنفيذ shell |
| إجراءات ما بعد البناء | مهما كانت النتيجة، فإن ما يحدث بعد انتهاء الخطوات | Archiقم بتسليم القطع الأثرية، وانشر تقرير اختبار، وأرسل بريدًا إلكترونيًا. |
هناك عادتان توفران الكثير من الوقت والجهد في تصحيح الأخطاء لاحقًا. أضف خطوات البناء بالترتيب الذي يجب أن تُنفذ به، لأن Jenkins يقوم النظام بمعالجة جميع العمليات من البداية إلى النهاية ويتوقف عند أول فشل. ثم يقوم بأرشفة كل ما ينتج عن عملية البناء كإجراء لاحق، لأن مساحة العمل يُعاد استخدامها في عملية البناء التالية، بينما تُحفظ الملفات المؤرشفة لكل رقم بناء.
مشروع حر مقابل خط أنابيب: أيهما يجب أن تستخدم؟
لا يُعدّ نمط التصميم الحرّ النوع الوحيد للمشاريع في شاشة "عنصر جديد"، وليس هو النوع المناسب دائمًا. يوضح الجدول أدناه الفرق بينه وبين... وظيفة خط الأنابيب حول النقاط التي تحدد معظم الخيارات الحقيقية.
| نقطة المقارنة | مشروع حر | خط أنابيب |
| كيف يتم تعريفها | نماذج الويب المخزنة في ملف الوظيفة config.xml على وحدة التحكم |
A Jenkinsتم إرسال الملف مع رمز التطبيق |
| تغيير التاريخ | ممسوك ب Jenkins، خارج مستودعك | Revتمت معاينته وتحديد إصداراته مثل أي ملف مصدر آخر |
| المراحل والعمل المتوازي | قائمة واحدة مسطحة لخطوات البناء | مراحل مُسماة، وفروع متوازية، وعرض للمرحلة |
| منحنى التعلم | لا حاجة لكتابة أي نص برمجي | يتطلب ذلك صيغة خط الأنابيب التصريحية |
| أفضل ملاءمة | تجميع واحد، نص برمجي واحد، مهمة مجدولة واحدة، أو تعلم Jenkins | عمليات بناء واختبار ونشر متعددة المراحل عبر البيئات |
قاعدة عملية: استخدم أسلوب الكتابة الحر عندما تكون المهمة واحدة وما زلت تتعلم الأداة، ثم انقل العمل إلى خط أنابيب CI/CD بمجرد أن يتطور إلى مرحلة ثانية أو يحتاج إلى مراجعة جنبًا إلى جنب مع الكود. فرق تعمل بشكل ثنائي Jenkins غالباً ما تصل أدوات البناء إلى تلك النقطة بسرعة — أ مافن و Selenium الإعداد يُعدّ هذا سببًا شائعًا لتشغيل المفتاح، وينطبق المنطق نفسه على أي شيء آخر. اختبار الأتمتة مجموعة برامج تعمل على عدة مراحل.
