وثائق

الهدف

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

الـ الهدف هو المكان الذي تحدد فيه ما يمكن لـ CoRoid أن يفعله دون الحاجة إلى طلب إذن من شخص. يحتوي على قسم خاص به في التنقل، بجوار ضبط الجودة، ويتكون من جزأين: نظرة عامة يخبرك بما تم تحديده، و إعدادات هو المكان الذي تغيّر فيه ذلك.

ما تخبرك به نظرة عامة

تجيب نظرة عامة عن سؤال واحد: ما الذي يفعله CoRoid دون أن يطلب منك إذنًا؟

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

خطوةمعناها
بدء العمليبدأ CoRoid في تنفيذ مهمة لم يطلبها أحد، ضمن أحد أهدافك.
دمجيقوم CoRoid بدمج pull request.
نشرينشر CoRoid التغييرات في بيئة العمل.
التراجعيُلغي CoRoid عملية النشر الفاشلة.

تذكر كل خطوة أحد هذه الأمور:

  • يطلب منك التدخل. لا يوجد إذن ممنوح لذلك، لذا يتولاه شخص.
  • يتعلم في الخلفية. يوجد إذن ممنوح لذلك، لكنه يسجل فقط ما كان سيحدث. تذكر الخطوة متى بدأ الإذن وما الذي كان سيتم تنفيذه حتى الآن.
  • ينفذه بنفسه. يوجد إذن نشط ممنوح لذلك، وتوضح الخطوة أي عمل يتم تنفيذه وكيف يتم إبلاغك به.
  • أوقفه CoRoid. أوقف CoRoid تنفيذ الإذن بنفسه. افتحه لتعرف السبب.
  • إصلاحات الأمان فقط (بدء العمل). يبدأ CoRoid في إصلاح مشاكل الأمان وفقًا لإعدادات الأمان، بينما يتولى الشخص تنفيذ باقي المهام.

تفتح كل خطوة إذنها في إعدادات، أو إذنًا جديدًا لتلك الخطوة.

أسفل الخطوات:

  • دائمًا قرار بشري: المسارات المحمية وأكبر عدد من طلبات السحب التي يحتفظ بها CoRoid مفتوحة في مشروع ما. لا يتم دمج أي تغيير في مسار محمي أو نشره بواسطة CoRoid، بغض النظر عما ينص عليه الإذن.
  • الأهداف: ما الذي يعمل من أجله CoRoid وما الذي يمكنه إنفاقه، وما الذي يحدث لتلك المهام.
  • المشاريع: أي مشروع متوقف أو يحد من نطاق الإذن، له صف خاص به؛ والباقي يتبع إعدادات المؤسسة.

يمكن للمالكين والمشرفين إيقاف الاستقلالية من أعلى صفحة نظرة عامة.

إعداد الإعدادات

  1. افتح الهدف → إعدادات واختر البدء من إعداد مسبق، أو إذن جديد لخطوة واحدة.
  2. يبدأ الإذن في العمل في الخلفية. دعه يعمل لفترة على مهامك الحقيقية.
  3. افتح الإذن واقرأ ما كان سيحدث. عندما يقنعك السجل، اختر جعله نشطًا.
  4. إذا أردت تلقي إشعارات عبر Slack أو Telegram، أضف مسارًا لـ ما يفعله CoRoid تحت إعدادات → اتصالات → مسارات الإشعارات.

يمكنك إعادة الإذن إلى الخلفية، أو إيقاف الاستقلالية، في أي وقت.

إعدادات

تحتوي إعدادات على إعدادات المؤسسة أولاً ثم كل مشروع. كل صف يوضح ما تم تحديده؛ وعند النقر عليه، يفتح محرره في لوحة جانبية. لا يتم تحرير أي شيء مباشرة في الصفحة نفسها.

مجموعةصفوف
الاستقلاليةإيقاف، مع أي تعليقات أو توقفات؛ وـ احتياطي الاستعادة
الإذوناتصف لكل إذن، مع البدء من إعداد مسبق و إذن جديد
الأهدافصف لكل هدف، مع هدف جديد
الحدودالمسارات المحمية، إجراءات التسليم، طلبات السحب المفتوحة، الوكلاء
السجلكل تغيير في الهدف وكل قرار يتم اتخاذه بموجبه.

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

الإذونات

إن إذن هو أمر يمكن لـ CoRoid تنفيذه دون تدخل بشري. يسمي الصف الخاص به ذلك، مثل «دمج عمل طلبه شخص»، ويوضح مدى تطبيقه:

مصنف كمنخفض الخطورة، في كل المشاريع. أقصى 5 مرات يوميًا. يخبرك أولاً، وينتظر 10 دقائق قبل التوقف.

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

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

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

  • إصلاح طلبات السحب. عندما تفشل عمليات التحقق في pull request لعمل CoRoid الخاص، تبدأ CoRoid جولة لإصلاحها. بدون منحة لهذا العمل، تترك الفشل للشخص المسؤول عن المراجعة. عند اختيارك خيار "إصلاح عمليات التحقق الفاشلة" بنفسك، لا تكون هناك حاجة إلى منحة.
  • حظر طلبات السحب. عندما تكتشف أداة CoRoid للمراجعة مشكلة يجب إصلاحها، تطلب تغييرات، لذا ينتظر pull request تدخل شخص ما. بدون منحة للمشروع، تظل المراجعة مجرد تعليق ولا تفشل عملية التحقق. تغطي منحة الحظر كل pull request في مشاريعها، بغض النظر عن من فتحها ومدى خطورتها، باستثناء المسارات التي تستثنيها المنحة.

كانت كلتا العمليتين من الأمور التي كانت تقوم بها CoRoid قبل أن تصبحا منحًا. تمتلك كل منظمة هذه المنح كمنح نشطة، لذا لم يتغير شيء عندما أصبحتا قرارات: قم بتضييق نطاق إحداهما على بعض المشاريع، أو ألغِها، وستتوقف CoRoid. كما يتوقف عملهما عند التوقف المؤقت.

تقدم لوحة تحكم المنحة فقط ما تطلبه خطوتها. يتم اتخاذ قرار البدء بالعمل والإصلاح والتراجع قبل حدوث أي تغيير في التقييم، لذا لا تحتوي على مستوى مخاطرة أو مسارات مستثناة. لا تحتوي منحة الحظر على تحديد "لمن يعود العمل": فهي تغطي كل pull request.

لم تعد CoRoid تطلب تفاصيل حول تنفيذ العمل: فالبدء بالعمل هو القرار في تلك اللحظة. تنص منحة التنفيذ على ذلك، ويمكن إلغاؤها.

تبدأ المنحة في الوضع الخفي

لا تسمح المنحة الجديدة بأي شيء. في الوضع الخفي تسجل CoRoid ما كان سيسمح به المنحة، حتى تتمكن من الاطلاع عليه قبل الاعتماد عليه. تفعيل يُطبق المنحة فعليًا.

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

ما كان سيحدث

افتح المنحة لتتصفح:

  • عدد المرات التي طلبت فيها CoRoid منها، وما كان سيسمح به في الوضع الخفي؛
  • بالنسبة لمنحة الدمج، خلال آخر 30 يومًا: عدد طلبات السحب من هذا النوع التي تم دمجها، وعدد الطلبات التي كانت ستدمجها المنحة، وأسباب عدم دمج الباقي، وكل طلب كان سيدمج وتم إلغاؤه لاحقًا أو إصلاحه أو متابعته؛
  • ما تحتاجه المنحة قبل أن تصبح نشطة.

منحة التغييرات ذات التقييم المنخفض لا يتطلب شيئًا إضافيًا؛ فالقواعد تمنح هذه الدرجة. المنحة للتغييرات المصنفة المتوسط يعتمد على نموذج، لذا لا يصبح نشطًا إلا عند توفر سجل: 30 طلب سحب على الأقل جرى تقييمها من فئته من دون أي موافقة خاطئة، و10 تغييرات سيئة أُدخلت عمدًا على الأقل، مع حظرها جميعًا. وحتى ذلك الحين، توضح المنحة ما لا يزال مطلوبًا.

البدء من إعداد مسبق

البدء من إعداد مسبق يملأ قسم الهدف بمجموعة من المنح، كلها في الوضع الخفي:

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

لا يؤدي الإعداد المسبق إلى تفعيل أي منحة، ولا يضيف شيئًا مما لديك بالفعل.

يمكن للمشروع تضييق نطاق المنحة

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

عندما توقف CoRoid المنحة بنفسه

  • معلقة. تغير مراجع CoRoid أو مقيّم المخاطر، ولم يتم قياس أداء المنحة وفق النسخة الجديدة بعد. ستصبح نشطة تلقائيًا عندما يحدث ذلك.
  • معلقة بسبب آلية الإيقاف التلقائي. الطلبات التي سمحت المنحة بدمجها تم إلغاؤها أو إصلاحها أو متابعتها بشكل متكرر أكثر من طلبات الدمج التي قام بها الأشخاص في نفس المشاريع. لا يؤدي فشل واحد إلى ذلك. تعرض المنحة كلا العددين. يقوم شخص ما برفع التعليق ويوضح السبب.

ما يمكن للمنحة دمجه

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

عملما تغطيه
العمل الذي طلبه الأشخاصطلب سحب pull request من CoRoid لعمل طلبه شخص ما
عمل ضمن هدف محددطلب سحب pull request من CoRoid لعمل بدأ ضمن أحد أهدافك
تحديثات التبعياتpull request بواسطة Dependabot أو Renovate (في GitLab، طلب دمج فتحه روبوت يستخدم رمز وصول المشروع أو المجموعة من renovate/ فرع) لتحديث حزم npm، كل منها إلى إصدار تصحيحي أو ثانوي ضمن نفس سلسلة الإصدارات، ونُشر منذ 7 أيام على الأقل، دون وجود سكريبت تثبيت جديد، مع ملف قفل يتطابق package.json، ولا توجد نصيحة أمنية مفتوحة. يتم تصنيف هذا التحديث كـ منخفض بعد مرور 7 أيام.
أشخاص موثوق بهمإنه pull request من قِبل عضو ضمن أسماء التراخيص، حيث تم تأليف كل التزامات منذ النسخة الأساسية وإرسالها عبر حساب GitHub المرتبط بذلك العضو، وقد تحقق GitHub من صحة توقيعها. على GitLab، يفتح طلب الدمج حساب GitLab المرتبط بالعضو، حيث يتحقق GitLab من صحة توقيع كل التزام ويتطابق بريد المؤلف والمرسل مع ما أكده العضو على GitLab. أما الالتزام الذي يتم إنشاؤه في محرر الويب أو إرساله من قبل شخص آخر، فيظل بانتظار تدخل الإنسان.

كيفية دمج الترخيص

تخطيط الدمج في المصنع يضع pull request الذي يغطيه الترخيص تحت CoRoid يمكنه الدمج الآن، ويقوم قطار الدمج بدمجه. عند لحظة الدمج، يطلب CoRoid الهدف مرة أخرى، لذا فإن التوقف أو الحجز أو تجاوز الحد أو وجود التزام جديد منذ وضع التخطيط يوقف عملية الدمج.

يُسمّي التزام الدمج الترخيص ونسخته. يُحتسب الدمج ضمن نطاق الترخيص، للشخص المحدد كمسؤول عنه، في سجل التاريخ وفي حدود الترخيص.

في الخفاء، يحدد تخطيط الدمج أن الترخيص سيدمج pull request، ويتخذ الشخص القرار بشأنه.

الإعلان والتوقف

يحدد الترخيص طريقة إخبارك بعملية الدمج:

  • أولاً، ثم ينتظر أمر التوقف. عندما يأخذ قطار الدمج طلب السحب، يتلقى الشخص المسؤول عن الترخيص والشخص الذي طلب العمل إشعارًا. يقوم CoRoid بدمج الطلب عند انتهاء الفترة المحددة، مثل بعد 10 دقائق، ما لم يضغط أحد على توقف في الإشعار أو في تخطيط الدمج، أو، باستخدام حساب مرتبط، في منشوره على Slack أو Telegram. يظل pull request المتوقف بانتظار تدخل الإنسان.
  • بعد كل عملية. يتم إخطارك عند اكتمال الدمج.

ربط حساباتك

يحتاج ترخيص الأشخاص الموثوق بهم وعمليات الموافقة من CoRoid إلى معرفة حساب GitHub أو GitLab الخاص بك. كما يحتاج توقف Slack أو Telegram إلى معرفة حساب Slack أو Telegram الخاص بك. في ملف التعريف ← الحسابات المرتبطة، قم بربط كل حساب؛ وتؤكد المنصة ذلك. يحتفظ CoRoid بمعرف الحساب واسمه، وليس الرمز المميز. بالنسبة لـ GitLab، يحتفظ أيضًا بملخص لكل بريد إلكتروني أكدته هناك (وليس البريد نفسه)، وهو ما يستخدمه لتحديد أن الالتزام صادر عنك؛ يجب إعادة الربط بعد إضافة بريد إلكتروني جديد. إلغاء الربط يقوم بإزالة كل شيء. عندما تربط مؤسستك GitLab ذاتي الإدارة، يحصل ذلك GitLab على صف خاص به بمجرد قيام مالك أو مسؤول بإعداده (ربط حسابات الأشخاص على GitLab الخاص بك).

أهداف

إن الهدف يحدد الاتجاه الذي يعمل عليه CoRoid بشكل مستقل، والمشاريع التي يغطيها، ومقدار الإنفاق المسموح به. كانت الإصدارات السابقة تسمي الأهداف بالـ هدف؛ أهداف تصفها بالتفصيل.

يوفر الهدف لـ CoRoid غاية وميزانية. تبدأ الطلبات الواردة من أنظمتك التي يتولاها الهدف وفقًا لما هو موضح في عند بدء العمل. يعمل CoRoid على ملفاته بنفسه ضمن إطار هدف، مثل متابعة تنفيذ تغيير لم يحقق النتيجة المرجوة، ويتطلب ذلك ترخيصًا نشطًا لـ بدء العمل؛ وحتى ذلك الحين، يظل بانتظار تدخل الإنسان لبدءه. استثناءً من ذلك، إصلاحات الأمان تبدأ وفق إعدادات الأمان الخاصة بها.

حدود

ما لا يسمح لـ CoRoid القيام به بشكل مستقل، بغض النظر عما ينص عليه الترخيص:

  • مسارات محمية. يتخذ الإنسان قرار كل تغيير في هذه المسارات. يحمي CoRoid عمليات تسجيل الدخول والوصول، والفوترة والمدفوعات، والأسرار وبيانات الاعتماد، والتشفير، وعمليات ترحيل قواعد البيانات، وملفات القفل، وخطوط أنابيب التكامل المستمر، والحاويات والبنية التحتية، ويمكنك إضافة مسارات خاصة بك. ولا يستطيع سوى المالك إزالة أي من مسارات CoRoid، مع تسجيل سبب ذلك.
  • إجراءات التسليم. أقصى ما يسمح به أي ترخيص هنا: الدمج، والنشر، والتراجع، كل منها مسموح به أو مطلوب أو مرفوض.
  • طلبات السحب المفتوحة. عدد طلبات السحب الخاصة بـ CoRoid التي تظل مفتوحة في مشروع ما. عند الوصول للحد الأقصى، تنتظر العمليات التي يبدأها تلقائيًا؛ بينما تبدأ دائمًا طلبات الإنسان.
  • وكلاء مدى عمق تدخل الوكيل، وما إذا كان بالإمكان للتلقائيات والجداول الزمنية إنشاء مهام. وما إذا كان بإمكان CoRoid مراجعة حجب pull request يعتبر ترخيصًا.

سجل التاريخ

كل تغيير في الهدف وكل قرار يُتخذ بموجبه، بترتيب تنازلي من الأحدث إلى الأقدم: من نشر أو غير الترخيص، وما سُمح أو لم يُسمح لـ CoRoid بفعله ولماذا، وما أجاب به الأشخاص عندما طلب منهم CoRoid الرأي.

عندما يطلب منك CoRoid رأيك

بعض الإجراءات تتطلب رد فعل من الإنسان أولاً. كل منها يظهر كصف تحت يحتاج إليك في المصنع: ما يطلب من CoRoid القيام به، وأين، ولماذا. الموافقة مرة واحدة تسمح له باتخاذ ذلك الإجراء مرة واحدة. رفض تمنعه من اتخاذه. انظر المصنع.

من يمكنه تغييره

يقوم المالكون والمشرفون بتعديل الهدف، بينما يمكن للأعضاء قراءة كل تفاصيله. ولا يمكن لوكلاء CoRoid وحسابات الخدمة تغييره بأي شكل من الأشكال.

يتم تسجيل كل قرار يتم اتخاذه ضمن إطار منحة معينة في تدفق التدقيق الخاص بمؤسستك، بالإضافة إلى بيانات المنحة ونسختها، عبر نظام CoRoid.