الإصدارات الدلالية باستخدام الوسوم
طبّق مبادئ الإصدارات الدلالية على مشروعك، واستخدم وسوم Git لتمييز المحطات المهمة في سجلك
الإصدارات الدلالية باستخدام الوسوم درس مجاني في DevOps Bootcamp على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في DevOps Bootcamp، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة DevOps Bootcamp 4 دروس في المجموع.
ما المقصود بإصدارات البرمجيات؟
تخيّلوا أنكم تبنون منزلًا. لن ترغبوا في استخدام مخططات قديمة ممزوجة بأخرى جديدة، أليس كذلك؟
- تساعد إصدارات البرمجيات على تتبّع التغييرات في الشيفرة البرمجية.
- وتمنح كل إصدار معرّفًا فريدًا، مثل رقم الإصدار.
- وهذا يساعد المطوّرين والمستخدمين على فهم ما هو جديد، وما تم إصلاحه، وما قد يتعطّل.
وتُعدّ هذه الإصدارات ضرورية لإدارة التبعيات والتواصل بشأن التغييرات بفعالية.
التعرّف إلى الإصدار الدلالي (SemVer)
يُعدّ الإصدار الدلالي (أو SemVer) معيارًا شائع الاستخدام لتعيين أرقام الإصدارات.
ويستخدم تنسيقًا بسيطًا هو MAJOR.MINOR.PATCH:
- MAJOR: للتغييرات الكبيرة التي تكسر التوافق.
- MINOR: لإضافة ميزات جديدة متوافقة مع الإصدارات السابقة.
- PATCH: لإصلاح الأخطاء البسيطة، مع الحفاظ أيضًا على التوافق مع الإصدارات السابقة.
يوضّح هذا النظام بوضوح تأثير الإصدار الجديد.
فهم إصدار MAJOR
يُزاد رقم إصدار MAJOR عند إجراء تغييرات غير متوافقة على API.
وهذا يعني أن ترقية مستخدم لبرنامجكم إلى إصدار MAJOR جديد قد تؤدي إلى تعطّل شيفرته الحالية.
- مثال: من
1.0.0إلى2.0.0. - احرصوا دائمًا على توضيح التغييرات التي تكسر التوافق في ملاحظات الإصدار.
ويشير ذلك إلى تحديث مهم يتطلب انتباه المستخدمين.
فهم إصدار MINOR
يُزاد إصدار MINOR عند إضافة وظائف جديدة بطريقة تحافظ على التوافق مع الإصدارات السابقة.
يمكن للمستخدمين الترقية إلى إصدار MINOR جديد دون القلق من تعطل شيفرتهم الحالية.
- مثال: من
1.2.0إلى1.3.0. - تُضاف ميزات جديدة، بينما تظل الميزات القديمة تعمل كما هو متوقع.
عند زيادة إصدار MINOR، يُعاد ضبط إصدار PATCH إلى 0 (مثلًا، تتحول 1.2.5 إلى 1.3.0).
فهم إصدار PATCH
يُزاد إصدار PATCH عند إجراء إصلاحات للأخطاء مع الحفاظ على التوافق مع الإصدارات السابقة.
وتكون هذه عادةً تغييرات داخلية صغيرة لا تضيف ميزات جديدة ولا تؤدي إلى تعطّل الميزات الحالية.
- مثال: من
1.2.3إلى1.2.4. - يمكن للمستخدمين الترقية بثقة للحصول على إصلاحات الأخطاء.
وغالبًا ما تكون إصدارات PATCH مهمة لاستقرار البرنامج وأمانه.
لماذا يُعدّ SemVer مهمًا؟
يوفّر اعتماد الإصدار الدلالي فوائد عديدة:
- الوضوح: يفهم المطوّرون فورًا تأثير التحديث.
- إمكانية التنبؤ: يساعد على تجنّب الأعطال غير المتوقعة في المشاريع التي تعتمد على المشروع.
- إدارة التبعيات: يمكن للأدوات التحديث تلقائيًا إلى إصدارات آمنة.
- التواصل: يوفّر لغة مشتركة لمناقشة الإصدارات.
وهذا يعزّز الثقة ويجعل تطوير البرمجيات أكثر متانة.
استخدام علامات Git لإدارة الإصدارات
يتضمن Git ميزة تُسمى العلامات، وتتيح لكم تحديد نقاط معينة في سجل مستودعكم بوصفها نقاطًا مهمة.
وهذا مناسب تمامًا لتحديد إصدارات البرنامج، مثل v1.0.0 أو v2.1.5.
- تشبه العلامة إشارة مرجعية دائمة إلى commit محدد.
- وتساعدكم على الرجوع بسهولة إلى إصدار منشور من شيفرتكم لاحقًا.
وغالبًا ما تُستخدم العلامات للإشارة إلى نقاط الإصدار الرسمية في الجدول الزمني للمشروع.
العلامات المشروحة مقابل العلامات الخفيفة
يوفّر Git نوعين رئيسيين من العلامات:
- العلامات الخفيفة: مؤشرات بسيطة إلى commit، وهي مجرد اسم.
- العلامات المشروحة: كائنات Git كاملة، وتحتوي على اسم منشئ العلامة وبريده الإلكتروني وتاريخه ورسالة.
تُفضَّل العلامات المشروحة للإصدارات؛ لأنها تخزّن بيانات وصفية قيّمة، ويمكن توقيعها للتحقق من أصالتها.
فكّروا في العلامة المشروحة على أنها commit صغير للإصدار بحد ذاته.
إنشاء علامة مشروحة
لإنشاء علامة مشروحة، استخدموا الأمر git tag -a، متبوعًا باسم العلامة ورسالة.
إليكم طريقة تحديد أول إصدار مستقر لكم:
git init
echo "Initial content" > README.md
git add README.md
git commit -m "First commit"
git tag -a v1.0.0 -m "Initial stable release"
git log --oneline --decorateعرض العلامات وفحصها
بعد إنشاء العلامات، يمكنكم عرض قائمة بها أو الاطلاع على تفاصيلها.
- استخدموا
git tagلعرض جميع العلامات في مستودعكم. - استخدموا
git show <tagname>لعرض commit المرتبط بعلامة وبياناتها الوصفية.
جرّبوا تشغيل المثال لمعرفة الطريقة:
git init
echo "Feature A" > a.txt
git add a.txt
git commit -m "Add feature A"
git tag -a v0.1.0 -m "First feature release"
echo "Bug Fix B" > b.txt
git add b.txt
git commit -m "Fix bug B"
git tag -a v0.1.1 -m "Bug B fixed"
git tag
git show v0.1.0تحقّق سريع: تأثير SemVer
افترضوا أن مشروعًا ما يعمل حاليًا بالإصدار 1.5.2. قرّر الفريق إضافة ميزة جديدة متوافقة مع الإصدارات السابقة وإصلاح خطأ بسيط.
ما رقم الإصدار التالي وفقًا للإصدار الدلالي؟
مراجعة: SemVer وعلامات Git
أحسنتم! لقد تعلّمتم أساسيات الإصدار الدلالي وكيفية استخدام علامات Git لتحديد إصداراتكم.
- يوفّر SemVer (MAJOR.MINOR.PATCH) طريقة واضحة للتواصل بشأن التغييرات.
- MAJOR: تغييرات تكسر التوافق.
- MINOR: ميزات جديدة متوافقة مع الإصدارات السابقة.
- PATCH: إصلاحات أخطاء متوافقة مع الإصدارات السابقة.
- علامات Git: تعمل كإشارات مرجعية دائمة إلى commits محددة، وهي مثالية لتحديد إصدارات البرنامج.
- العلامات المشروحة: مفضّلة للإصدارات بفضل بياناتها الوصفية.
تُعدّ هذه المعرفة أساسية لإدارة الإصدارات والتعاون بفعالية!
الأسئلة الشائعة
هل درس «الإصدارات الدلالية باستخدام الوسوم» مجاني؟
نعم — نص درس «الإصدارات الدلالية باستخدام الوسوم» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة DevOps Bootcamp، انتقل إلى CoddyKit PRO. تتضمن دورة DevOps Bootcamp 4 دروس في المجموع.
ماذا ستتعلم في «الإصدارات الدلالية باستخدام الوسوم»؟
طبّق مبادئ الإصدارات الدلالية على مشروعك، واستخدم وسوم Git لتمييز المحطات المهمة في سجلك تتمرن على DevOps Bootcamp مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ DevOps Bootcamp؟
لا تُشترط خبرة سابقة. DevOps Bootcamp على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «الإصدارات الدلالية باستخدام الوسوم»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس DevOps Bootcamp هذا؟
نعم. كل درس في DevOps Bootcamp يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- الإصدارات الدلالية باستخدام الوسوم
- إنشاء الإصدارات وإدارتها
- فروع الإصدارات والإصلاحات العاجلة
- إنشاء سجلات التغييرات وملاحظات الإصدارات