أساسيات استخدام الوسوم (Tags) في Git

تُعد إدارة الإصدارات من أبرز الوظائف التي تجعل أنظمة التحكم في الإصدارات مثل Git من الأدوات الضرورية في تطوير البرمجيات الحديثة. واحدة من أهم ميزات Git التي تُستخدم لإدارة الإصدارات بشكل أكثر تنظيماً ودقة هي خاصية “الوسوم” أو “Tags”. تلعب الوسوم دورًا أساسيًا في تحديد نقاط معينة في تاريخ المشروع، مثل إصدار نسخة مستقرة أو إطلاق تحديث مهم، مما يسهل الرجوع إليها لاحقًا بدقة وسرعة. هذا المقال يستعرض بأسلوب علمي وتفصيلي أساسيات استخدام الوسوم في Git، من تعريفها وأنواعها إلى طرق إنشائها وإدارتها وأفضل الممارسات المرتبطة بها.

تعريف الوسوم (Tags) في Git

الوسوم في Git هي مؤشرات ثابتة تُرفق مع نسخة معينة من المشروع، وغالبًا ما تُستخدم لتسمية إصدارات معينة (مثل الإصدار 1.0 أو 2.5.1) أو أي نقطة مرجعية مهمة. على عكس الفروع (Branches) التي يمكن تحديثها وتغيير مكانها عبر الزمن، فإن الوسوم تمثل لحظة محددة في تاريخ المشروع بشكل دائم وغير قابل للتغيير، مما يجعلها مثالية لتحديد نقاط إطلاق إصدارات أو لحفظ نسخة من الكود في حالة معينة.

الفرق بين الوسوم والفروع

• الفروع (Branches): تمثل خطوط تطوير متوازية ومستقلة، يمكن الانتقال بينها، تعديلها، والاندماج معها، وهي تشير إلى آخر التزام (commit) على ذلك الفرع.

• الوسوم (Tags): تمثل نقاط ثابتة لا تتغير بعد إنشائها، وغالبًا ما تُستخدم كعلامات على إصدارات ذات أهمية مثل الإصدارات الرسمية.

أنواع الوسوم في Git

يمكن تصنيف الوسوم في Git إلى نوعين رئيسيين:

1. الوسوم الخفيفة (Lightweight Tags)

• تُعتبر بمثابة مجرد مؤشر أو علامة على التزام معين.

• لا تحتوي على معلومات إضافية سوى مرجع الالتزام.

• لا تُخزن معلومات عن الشخص الذي أنشأ الوسم أو توقيت إنشائه.

• تُستخدم عادةً للاستخدامات البسيطة أو المؤقتة.

2. الوسوم المُعتمدة (Annotated Tags)

• تحتوي على بيانات كاملة، مثل اسم المُنشئ، تاريخ الإنشاء، رسالة وصفية مرفقة.

• تُخزن في قاعدة بيانات Git بشكل منفصل عن الالتزام نفسه.

• تدعم التوقيعات الرقمية (GPG) للتحقق من صحة الوسم.

• تُستخدم لتوثيق الإصدارات الرسمية التي يجب أن تحمل معلومات دقيقة وواضحة.

كيف تنشئ الوسوم في Git

إنشاء وسم خفيف

يمكن إنشاء وسم خفيف باستخدام الأمر التالي:

bash
CopyEdit
git tag 

مثال:

bash
CopyEdit
git tag v1.0

هذا الأمر يضع وسمًا خفيفًا على آخر التزام في الفرع الحالي.

إنشاء وسم مُعتمد

لإنشاء وسم معتمد مع رسالة، يمكن استخدام الأمر:

bash
CopyEdit
git tag -a  -m "رسالة وصفية عن الوسم"

مثال:

bash
CopyEdit
git tag -a v1.0 -m "الإصدار الأول المستقر"

هذا النوع من الوسوم يحتوي على معلومات مفصلة ويساعد في توثيق الإصدارات بشكل أفضل.

إنشاء وسم على التزام محدد

يمكن أيضًا إنشاء وسم لأي التزام باستخدام رقم التعريف الخاص به (commit hash):

bash
CopyEdit
git tag -a v1.0  -m "رسالة"

إدارة الوسوم: عرضها، حذفها، ونقلها

عرض الوسوم

لعرض جميع الوسوم في المستودع، يستخدم الأمر:

bash
CopyEdit
git tag

يمكن أيضًا البحث عن وسوم باستخدام نمط معين:

bash
CopyEdit
git tag -l "v1.*"

حذف وسم محلي

لحذف وسم معين من المستودع المحلي:

bash
CopyEdit
git tag -d 

حذف وسم من المستودع البعيد (Remote)

بعد حذف الوسم محليًا، يجب حذفه من المستودع البعيد باستخدام الأمر:

bash
CopyEdit
git push origin --delete 

نقل وسم إلى التزام مختلف

لنقل وسم إلى التزام مختلف، أولًا يجب حذف الوسم محليًا ثم إعادة إنشائه على الالتزام الجديد:

bash
CopyEdit
git tag -d 
git tag -a   -m "رسالة جديدة"
git push --force origin 

دفع الوسوم إلى المستودع البعيد (Remote Repository)

بشكل افتراضي، لا يتم دفع الوسوم إلى المستودع البعيد عند تنفيذ git push الاعتيادي. لدفع الوسوم يجب استخدام الأمر التالي:

دفع وسم محدد

bash
CopyEdit
git push origin 

دفع جميع الوسوم دفعة واحدة

bash
CopyEdit
git push origin --tags

هذه الطريقة تضمن أن تكون جميع الوسوم المحلية متزامنة مع المستودع البعيد.

استخدامات الوسوم في بيئة التطوير

تلعب الوسوم دورًا مهمًا في دورة حياة تطوير البرمجيات، حيث تُستخدم في:

• تحديد الإصدارات: تُستخدم الوسوم لتعيين إصدارات معينة من المشروع، مما يسهل عملية الإصدار والتوزيع.

• التوثيق: يوفر وسم معتمد مع رسالة وصفية تاريخًا واضحًا لنقطة الإصدار مع معلومات عن من أنشأ الوسم ومتى.

• التكامل المستمر (CI) والتوصيل المستمر (CD): يمكن تكوين أنظمة البناء والتوزيع التلقائي لتتبع الوسوم وتقوم ببناء أو نشر الإصدارات عندما يتم إنشاء وسم جديد.

• الاسترجاع (Rollback): تتيح الوسوم إمكانية العودة إلى إصدار سابق بسهولة عند ظهور أخطاء أو مشكلات.

أمثلة عملية على استخدام الوسوم

مثال 1: إصدار نسخة مستقرة

عند الانتهاء من تطوير نسخة مستقرة من البرنامج، يمكن إنشاء وسم معتمد يحدد هذه النسخة:

bash
CopyEdit
git tag -a v2.0 -m "إصدار النسخة المستقرة 2.0"
git push origin v2.0

هذا يضمن أن الجميع يستخدمون نفس النسخة من الكود عند الإشارة إلى هذا الوسم.

مثال 2: استرجاع نسخة باستخدام وسم

للتبديل إلى إصدار معين محدد بواسطة وسم:

bash
CopyEdit
git checkout v2.0

يتم تحميل نسخة المشروع كما كانت عند إنشاء الوسم.

التواقيع الرقمية للوسوم (GPG Signing)

لزيادة الأمان والمصداقية، تدعم Git إمكانية توقيع الوسوم رقمياً باستخدام GPG، وهي وسيلة للتحقق من أن الوسم أصدره شخص موثوق به.

لإنشاء وسم معتمد وموقع:

bash
CopyEdit
git tag -s v2.0 -m "توقيع وسم الإصدار 2.0"

يتطلب هذا إعداد GPG مسبقًا على الجهاز، ويُعتبر التوقيع الرقمي معيارًا مهمًا خاصة في المشاريع مفتوحة المصدر.

جدول مقارنة بين أنواع الوسوم

أفضل الممارسات في استخدام الوسوم

• الاعتماد على الوسوم المعتمدة للإصدارات الرسمية: لأنها تحمل معلومات موثقة ورسائل وصفية تساعد في توثيق المشروع.

• استخدام نظام تسمية موحد للوسوم: كأن تكون تبدأ بحرف “v” متبوعًا برقم الإصدار مثل v1.0.0، فهذا يسهل التعرف على الإصدارات.

• دفع الوسوم إلى المستودع البعيد دائمًا: لضمان توافر العلامات لجميع أعضاء الفريق والمستخدمين.

• توقيع الوسوم الرقمية: خصوصًا في المشاريع المفتوحة أو التي تتطلب درجة عالية من الأمان والموثوقية.

• عدم تعديل الوسوم القديمة: لتجنب التشويش، عند الحاجة إلى تغيير يجب حذف الوسم القديم وإنشاء وسم جديد.

الخلاصة

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

المراجع

1. Pro Git Book, Scott Chacon & Ben Straub, 2nd Edition, 2014 — https://git-scm.com/book/en/v2/Git-Basics-Tagging

2. Git Documentation – Tagging — https://git-scm.com/docs/git-tag