إصدارات Orbit

The Releases tab turns your git tags into a version history you can read: every tagged deployment, in order, with its commit, its author, its status and a link straight to the tag in your repository.

تحول علامة التبويب Releases علامات git الخاصة بك إلى سجل إصدارات يمكنك قراءته: كل نشر مع علامة، بالترتيب، مع عملية الالتزام الخاصة به، ومؤلفه، وحالته، ورابط مباشر إلى العلامة في المستودع الخاص بك.

حيث يوجد Releases

افتح Orbit، انقر على المشروع، واختر Releases ضمن مجموعة Deployments في شريط علامات المشروع. تُسمى الصفحة Releases وتصف نفسها بأنها نشرات مستندة إلى العلامات: يتم إنشاء إصدار عندما تطابق علامة git نمط العلامة الخاص بك.

تسرد علامة التبويب Deployments المجاورة كل بناء، سواء كان مع علامة أم لا. Releases هي العرض المُصفّى: فقط تلك التي وضعت علامة عليها كإصدار.

تعيين نمط العلامة

يبدأ Releases بنمط. افتح Settings، ابحث عن بطاقة Git tag deploys، وأدخل glob مثل v* أو release-*. سيؤدي تركها فارغة إلى تعطيل نشرات العلامات بالكامل، وهذا هو السبب في أن نص العنصر النائب في الحقل يقرأ v* (disabled).

مع وجود نمط محدد، يؤدي دفع علامة مطابقة إلى النشر في الإنتاج وتسجيل النتيجة كإصدار. بدون ذلك، تعرض علامة التبويب Releases حالة فارغة تطلب منك دفع علامة وتعيين نمط في Settings.

يمنحك نمط العلامة مسارًا ثانيًا صريحًا للإنتاج إلى جانب الدفع إلى فرع الإنتاج. الفرق التي تريد أن تكون النشرات عملاً متعمدًا بدلاً من كونها آثارًا جانبية للدمج غالبًا ما تطفئ الدفع التلقائي للفرع وتقود الإنتاج من العلامات فقط.

قطع إصدار

كل سير العمل من جانبك هو أمران git:

git tag -a v1.4.0 -m "Checkout flow rebuild"
git push origin v1.4.0

يتلقى Orbit العلامة، ويطابقها مع نمطك، وينشر الالتزام المميز إلى الإنتاج، ويسجل إصدارًا. يظهر على هذه العلامة مع شارة Building وينتقل إلى Deployed عند وصوله، أو Failed إذا فشل البناء.

استخدم العلامات المشروحة بدلاً من الخفيفة. تحمل العلامة المشروحة رسالة ومؤلفًا وتاريخًا، كل ذلك ينتهي به الحال في الإصدار.

وضع علامة على نشر موجود

لا يتعين عليك دفع علامة git للحصول على إصدار. يمكن وضع علامة على أي نشر من صفحة التفاصيل الخاصة به، وتُلتقط العلامة التي تبدو وكأنها رقم إصدار هنا.

العلامة ذات الشكل الإصدار هي مثل 1.4، 1.4.0، v1.4.0 أو v2.0.0-rc1. أي شيء آخر يبقى كعلامة نشر عادية ولا ينشئ إدخال إصدار.

هذا هو مخرج الطوارئ للحالة التي خرج فيها إصدار قبل أن تعد النمط، أو حيث تم نشر hotfix يدويًا وتريده في سجل الإصدارات على أي حال.

قراءة إصدار

يعرض كل صف إصدار:

العلامة، كعنوان الإصدار.
الالتزام ورسالته.
المؤلف، معروضًا بـ by name.
البيئة التي ذهب إليها، مشفرة بالألوان حسب النوع.
شارة الحالة: Deployed، Building أو Failed.
رابط View on إلى العلامة في المستودع الخاص بك.
رابط إلى النشر الأساسي.

يشير رابط View on إلى المكان الصحيح لكل موفر: صفحة الإصدارات على GitHub، أو صفحة العلامة على GitLab، أو المصدر في تلك العلامة على Bitbucket.

ملاحظات الإصدار

إذا نشرت إصدارًا في المستودع الخاص بك لعلامة ما، يتم سحب الملاحظات وإرفاقها بالنشر، بحيث تحمل علامة التبويب Releases نفس النص الذي كتبته في المستودع الخاص بك بدلاً من إجبارك على الاحتفاظ بنسختين.

هذا يجعل المستودع المكان الوحيد لكتابة ملاحظات الإصدار. اكتبها مرة واحدة، حيث يوجد المساهمون لديك بالفعل، وستظهر هنا.

إصدار واحد لكل علامة

يتم إلغاء تكرار القائمة حسب العلامة: إذا تم نشر علامة أكثر من مرة، على سبيل المثال لأن البناء الأول فشل وأعدت المحاولة، فسيتم عرض نشر واحد فقط الأخير لتلك العلامة.

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

استخدام Releases بشكل جيد

ضع علامة على الدمج، وليس على الفرع. ضع علامة على الالتزام الموجود بالفعل في فرع الإنتاج الخاص بك. وضع علامة على التزام فرع الميزة الذي لم يتم دمجه ينتج عنه إصدار لا يتوافق مع أي شيء على main.

استخدم الإصدارات الدلالية. تم فرزها بشكل صحيح، ويتم التعرف عليها كإصدارات مشكلة، والجميع يعرفون بالفعل كيفية قراءتها.

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

يؤدي دفع العلامة إلى النشر مباشرة في الإنتاج إذا كان مطابقًا لنمطك. لا يتجاوز أي شيء آخر: تجميد النشر ومتطلبات الموافقة وفترات التجميد تنطبق على النحو المكون. لكنه يعني أن علامة مُدفوعة بالخطأ هي نشر إنتاج، وليست مسودة. راجع Deploying Your Project للحصول على الأبواب المتاحة.

استرجاع إصدار

الإصدارات هي نشرات، لذا فإن استرجاع واحد هو سير العمل العادي للاسترجاع: افتح النشر واستعد الإصدار الناجح السابق. راجع Rolling Back a Deployment.

بعد ذلك، قطع علامة جديدة للإصلاح بدلاً من حذف العلامة السيئة. الإصدار الفاشل الذي يبقى مرئيًا في السجل معلومات مفيدة، وليس فوضى.

استكشاف الأخطاء

تم دفع علامة لكن لم يظهر أي إصدار. تحقق من النمط في Settings، ثم تحقق من أن العلامة وصلت فعلاً إلى الجهاز البعيد. git push origin v1.4.0 يدفع علامة واحدة؛ git push وحده لا يدفع أيًا.

يظهر الإصدار Failed. فشل البناء، تماما كما سيحدث لدفع الفرع. افتح النشر واقرأ السجل: Reading Build Logs.

رابط View on مفقود. المشروع لا يحتوي على مستودع متصل، لذا لا يوجد مكان للربط إليه. قم بتوصيل واحد: راجع Connecting a GitHub Repository.

نشر مع علامة يدويًا غير مدرج. العلامة لا تكون مشكلة الإصدار. أعد تسميتها إلى شيء مثل v1.4.0.

ملاحظات الإصدار فارغة. يتم سحب الملاحظات من إصدار منشور في المستودع الخاص بك. علامة عادية بدون كائن إصدار لا توجد ملاحظات لسحبها.

أين تذهب بعد ذلك

Deploying Your Project بالنسبة لدورة النشر الكاملة وأبوابها.
Rolling Back a Deployment عند حدوث خطأ في الإصدار.
Orbit Timeline Annotations لتسجيل ما تغيره الإصدار.