سياسة هي مجموعة مسماة ومُرقّمة من بوابات الجودة. السياسات هي ما تربطه بالمشاريع؛ والبوابات هي التي تعمل فعليًا.
للتعرف على المفاهيم — الحظر مقابل التوصية، ومكان وجود البوابات في عملية التنفيذ — اقرأ بوابات الجودة أولاً. تغطي هذه الصفحة إدارتها.
قم بإدارتها في ضبط الجودة. تعرض القائمة الخاصة به الإعداد الافتراضي للمؤسسة وكل مشروع. اختر أحدها لرؤية كيف يتم فحص العمل الجديد، وما الذي يتحقق منه في كل تغيير، ومستوى ضمان الجودة الخاص به، ومكان تنفيذ الفحوصات، مع وجود مفتاح تشغيل يطبق التغيير فور تفعيله. يتيح لك زر التأكيد إلغاء التغيير، وتغيّر إعدادات الصف تلك طريقة عمل الفحص.
- الإعداد الافتراضي للمؤسسة3 مشاريع تتبع هذا الإعداد.2 من أصل 5
- واجهة المتجرإعداد مخصص4 من أصل 5
- موقع المستنداتيتبع الإعداد الافتراضي2 من أصل 5
- فوترة APIيتبع الإعداد الافتراضي2 من أصل 5
- تطبيق الهاتف المحموليتبع الإعداد الافتراضي2 من أصل 5
- مكافحة الفوضىتُعيد التغيير إلى المصدر إذا أدى إلى إضعاف اختبارات الوحدة، أو إخفاء الأخطاء، أو نشر عناصر نائبة، أو إضافة ديون تقنية.
- اختبارات الوحدةتكتشف اختبارات الوحدة الموجودة في المستودع وتنفذها مع كل تغيير يتم إدخاله.
- اختبارات المتصفح2 من أصل 3يختلف عن الإعداد الافتراضيتشغل سيناريوهات التصفح الخاصة بك لتقييم التغييرات المدخلة.
- الترجماتيختلف عن الإعداد الافتراضيتتحقق من ترجمة النصوص المعدلة والتأكد من تطابق العناصر النائبة وأشكال الجمع فيها.
- عمليات تفتيش المستودعتنفذ الأوامر المخصصة لديك، مثل تنسيق الكود، وقياس حجم الملفات، وتشغيل اختبارات التكامل، وفحوصات الأمان.
- ضمان جودة شاملشاملتجمع أداة ضمان الجودة أدلة ولقطات شاشة حية مقارنةً بالمواصفات المحددة؛ وعند تعطيلها، يتم تطبيق إجراءات ضمان الجودة القياسية.
ضبط الجودة: السياسات المطبقة وآخر عملية تفتيش. بيانات توضيحية.
إنشاء سياسة
السياسة عبارة عن مجموعة من الفحوصات، بالإضافة إلى تحديد ما إذا كان الفشل فيها يؤدي إلى حظر أو توصية لكل فحص.
تحتاج معظم المؤسسات إلى سياستين أو ثلاث، وليس سياسة لكل مشروع:
- سياسة صارمة لخدمات الإنتاج.
- سياسة قياسية لكل ما هو عادي.
- وأحيانًا سياسة خفيفة للأدوات الداخلية والنماذج الأولية.
إذا زاد العدد عن ذلك، لن يتمكن أحد من تذكر أي مشروع يتبع أي سياسة.
الإعداد الافتراضي للمؤسسة وإعدادات المشروع الخاصة.
يتبع المشروع الإعداد الافتراضي للمؤسسة حتى تغيّر أحد مفاتيحه. يؤدي هذا التغيير إلى إنشاء إعدادات خاصة بالمشروع، مأخوذة من الإعداد الافتراضي، ولن تؤثر التغييرات اللاحقة في الإعداد الافتراضي عليه. يمكن لصف أن ينسخ فحصًا واحدًا من الإعداد الافتراضي، ويمكن لقائمة المشروع إعادة تعيين المشروع بأكمله إلى الإعداد الافتراضي للمؤسسة. تظهر السياسة الكاملة وراء المفاتيح، مع المتطلبات والاعتماديات بين الفحوصات وميزانيات الإصلاح والإصدارات، من نفس القائمة التي يحتوي عليها المحرر المتقدم. بالنسبة لمشروع يتبع الإعداد الافتراضي، يبدأ المحرر من نسخة منه، ولا يتغير شيء في المشروع حتى تنشر تلك النسخة.
اضبط الإعداد الافتراضي على فحوصاتك القياسية وهي الفحوصات التي يجب أن تجرى في معظم المشاريع، وليس أشدها صرامة — حيث يجب تفعيل الإعدادات الأكثر صرامة بشكل متعمد، مشروعًا تلو الآخر.
طلبات السحب
تصل طلبات السحب التي يفتحها الأشخاص والأدوات الأخرى إلى Coroid عبر تطبيق Coroid GitHub. طلبات السحب تحدد مجموعة ضبط الجودة ما يحدث لها، سواء بالنسبة للإعداد الافتراضي للمؤسسة أو لكل مشروع:
- Coroid ضبط الجودة تجري الفحوصات المذكورة أعلاه على كل pull request وتُبلغ عن النتيجة كفحص Coroid ضبط الجودة على GitHub.
- Coroid مراجعة يطلب من مُراجع Coroid قراءة كل pull request والتعليق على الأسطر التي يشكك فيها. كما يقرأ طلبات السحب التي تفحصها Coroid ضبط الجودة.
إعدادات Coroid مراجعة:
- ما ينشره. الوضع التوصيلي، وهو الوضع الافتراضي، يضيف تعليقات ولا يفشل أبدًا في فحصه، باستثناء واحد: مشكلة أمنية حرجة أو عالية المستوى مؤكدة تؤدي إلى فشله عندما يفرض أمان مراجعة أمنية (انظر فحص الكود ومراجعة الأمان). أما الطلبات الحابسة فتغير سلوكها عند العثور على مشكلة، فيفشل فحصها. اجعل فحص Coroid مراجعة إلزاميًا في GitHub إذا كان يجب أن توقف المراجعة الحابسة عملية الدمج.
- أي طلبات سحب. بشكل افتراضي، ينتظر حتى يتم تحديد مسودة كـ «جاهزة»، ويتجاهل طلبات السحب التي فتحها Coroid، لأن مُراجع Coroid قد راجعها بالفعل داخل المهمة. كما يمكنه تجاهل طلبات السحب الصادرة عن الروبوتات.
- متى يقوم بالمراجعة. ينتظر فترة هدوء بعد آخر عملية دفع، وهي خمس دقائق بشكل افتراضي. أي عملية دفع جديدة تلغي المراجعة التي لم تبدأ بعد. إعادة التشغيل في GitHub تبدأ مراجعة فورية.
- عمق المراجعة. مدى ما يمكن لمُراجع القراءة والكتابة فيه خلال مراجعة واحدة.
يتبع قواعد مراجعة Coroid وقواعد مستودعك في مجلد
review-rules . يحصل المشروع الذي يتبع الإعداد الافتراضي للمؤسسة على إعدادات الإعداد الافتراضي، مثله مثل أي عنصر تحكم آخر.
عند حدوث خلل ما
ثلاثة مفاتيح تحت الإعداد الافتراضي للمؤسسة تحوّل حالات الفشل إلى مهام متابعة لكل مشروع. كل مفتاح يشغّل أتمتة واحدة، مدرجة في مصنع تحت قسم الأتمتات؛ يقرأ العامل الكود ويفتح مهمة، وتمر المهمة بنفس المواصفات والبناء والتحقق والمراجعة مثل أي مهمة أخرى.
| المفتاح | متى | ما يفعله العامل |
|---|---|---|
| عند فشل مهمة، افتح مهمة إصلاح | تفشل مهمة | يكتشف السبب، وعندما يكون السبب في الكود، يفتح مهمة لإصلاحه. |
| عند فشل عملية النشر، ابدأ التحقيق | تفشل عملية النشر | يقرأ ما تغيّر في تلك النسخة ويفتح مهمة توضح ما حدث وما يجب تغييره. |
| عند تراجع إصدار، خطّط للإصلاح | يتم تراجع الإصدار | يُفتح مهمة واحدة تسجل ما تم التراجع عنه، وسبب ذلك، وما يجب تغييره قبل إصداره مجددًا. |
تفعيل خيار الإيقاف يوقف أتمتته؛ وإعادة تفعيله يستأنفها. كل تغيير يوفر خيار التراجع. صفحة الأتمتة في مصنع تشير إلى أنها تُدار بواسطة ضبط الجودة. إيقافها هنا يعادل تفعيل خيار الإيقاف؛ وتغيير تعليماتها يجعلها خاصة بك بعد تأكيدك، وعندها لن يعود الخيار قادرًا على تفعيلها أو إيقافها.
كانت هذه قوالب في عمل جديد. الأتمتة التي أنشأتها من أحدها تستمر في العمل. إذا لم تغيرها، فإن تفعيل الخيار المطابق يتولى السيطرة عليها بدلاً من بدء نسخة ثانية. أما إذا غيرتها، فتبقى خاصة بك: يسميها صف الخيار باسمها، ويمكنك تبنيها ليقوم الخيار بإدارتها.
الإصدار الآمن
مشكلة أوضاع الفشل المتعلقة بالحواجز ليست في ضعفها، بل في أن حاجزًا حظرًا نابعًا عن حسن نية قد يوقف كل المهام في المؤسسة دفعة واحدة.
تسلسل آمن:
- أضف الحاجز كـ توصية.
- دعه يعمل على مهام حقيقية لمدة أسبوع أو اثنين. اقرأ ما يسلط الضوء عليه.
- عدّله بناءً على ما تعلمته.
- ارقِه إلى حظر في مشروع واحد.
- قم بإصداره على نطاق أوسع بمجرد أن يعمل بشكل سليم.
- 1إضافة البوابةاستشاري
- 2مراقبتها لمدة أسبوع أو اثنيناستشاري
- 3ضبطها وفقاً لما رصدتهاستشاري
- 4جعلها عائقاً على مشروع واحدعائقمشروع واحد
- 5تطبيقها على نطاق أوسععائقمشاريع أكثر
التحكم في الإصدارات والتراجع
السياسات تُحفظ بإصداراتها. كل خيار ينشر إصدارًا جديدًا، ويمكن التراجع عن تأكيده بالعودة إلى الإصدار السابق؛ كما يمكن استعادة الإصدارات القديمة من سجل الإصدارات في المحرر المتقدم.
التراجع هو السبب الذي يسمح لك باتخاذ قرارات حاسمة بشأن النشر. إذا تبين أن حاجزًا جديدًا غير مضبوط، فإن التراجع عنه يستغرق خطوة واحدة بدلاً من أن يكون عملية تنقيب معقدة.
التجاوزات
يمكن لشخص ذي صلاحيات تجاوز حاجز حظر. يتم تسجيل التجاوز — من قام به، ومتى، وضد أي مهمة.
راقب معدل التجاوزات لديك. حاجز يتم تجاوزه في معظم المرات التي يُفعّل فيها لا يفرض أي قيود؛ بل يخلق عوائق وأوراقًا رسمية. إما أن تصلح الحاجز أو تتخلى عنه.