إنشاء وسوم وصفية للنسخ المحفوظة في مستودع Git

مفهوم الوسوم الوصفية في Git

عند العمل على مشروع برمجي باستخدام نظام التحكم بالإصدارات Git، يقوم المطورون بإجراء تعديلات مستمرة على الملفات، و يتم حفظ هذه التعديلات على شكل نسخ ( Commits ) في المستودع الخاص بالمشروع. مع مرور الوقت و خصوصاً في المشاريع الكبيرة، قد يحتوي المستودع على مئات أو آلاف النسخ، كل واحد منها تمثل نقطة زمنية مختلفة من تطور المشروع.

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

• إصدار النسخة الأولى من البرنامج.
• نسخة مستقرة جاهزة للاستخدام.
• نسخة تجريبية تحتوي على ميزة جديدة.
• نقطة نريد الرجوع إليها لاحقاً عند حدوث مشكلة.

إضافة وسم للنسخة

لإضافة وسم لنسخة موجودة في مستودع المشروع يمكنك استخدام الأمر git tag كما يلي:

• git tag <tagname> لإضافة وسم لآخر نسخة تم إضافتها في المستودع.
• git tag -a <tagname> -m "message" لإضافة وسم لآخر نسخة تم إضافتها في المستودع و تتضمن معلومات تفصيلية كإسم منشئ النسخة، تاريخ إنشاءها بالإضافة إلى الوصف الذي يتم تمريره لها كنص.
• git tag <tagname> <commit-hash> لإضافة وسم لنسخة محددة في المستودع بالإعتماد على الهاش كود الخاص بها.

عرض أسماء الوسوم

يمكنك استخدام الأمر git tag لعرض جميع أسماء الوسوم الخاصة بالمستودع من الأقدم إلى الأحدث.

عرض تفاصيل الوسوم

يمكنك استخدام الأمر git show <tagname> لعرض التفاصيل المرفقة مع وسم محدد.

حذف الوسوم الوصفية

يمكنك استخدام الأمر git -d tag <tagname> لحذف الوسم.

تطبيق عملي و شامل لكل ما تعلمته

سنفترض أنه لديك مشروع يتكون من مجلّد إسمه demo و بداخله 3 ملفات إسمهم file1.txt و file2.txt و file3.txt.
الآن، إفتح موجّه الأوامر و توجه إلى المجلد demo لتبدأ التجربة عليه.

1- فيما يلي قمنا باستخدام الأمر git init لإنشاء مستودع .git بداخل مجلد المشروع demo.

2- فيما يلي قمنا باستخدام الأمر git add لتجهيز جميع الملفات ليتم إضافتها في النسخة القادمة التي يتم إنشاؤها من المشروع demo.

3- فيما يلي قمنا باستخدام الأمر git commit لحفظ نسخة من المشروع.

4- فيما يلي قمنا باستخدام الأمر git tag لإضافة وسم للنسخة السابقة التي تم إنشاؤها.

5- فيما يلي قمنا باستخدام الأمر git tag لعرض جميع الوسوم الخاصة بالمشروع.

6- فيما يلي قمنا باستخدام الأمر git show لعرض معلومات تفصيلية حول النسخة المرتبطة بالوسم v1.0.0.

7- فيما يلي قمنا باستخدام الأمر git tag لحذف الوسم v1.0.0.

8- فيما يلي قمنا باستخدام الأمر git tag لإنشاء الوسم v1.0.0 من جديد مع إرفاق رسالة توضيحية معه.

9- فيما يلي قمنا باستخدام الأمر git show لعرض معلومات تفصيلية حول النسخة المرتبطة بالوسم v1.0.0.

10- فيما يلي قمنا بإضافة وسم آخر إسمه v1.0.1 لنفس النسخة بالإعتماد على الهاش كود الخاص بها.

11- فيما يلي قمنا بإضافة وسم آخر إسمه v1.0.2 لنفس النسخة بالإعتماد على الهاش كود الخاص بها مع إرفاق رسالة توضيحية أيضاً.