التجارب
الطرح التدريجي المحمي
في هذه الصفحة
كيف يعمل
- قاعدة واحدة وبيئة واحدة. يتحكم الطرح في نسبة قاعدة طرح في العلم. الوحدات داخل النسبة تحصل على قيمة القاعدة (الطرح)، وبقية وحدات القاعدة تحصل على قيمة «وإلا» وتمثّل مجموعة المقارنة.
- مراجعة واحدة للخطة كلها. تُثبَّت الخطوات ومدد التثبيت والحراس عند إنشاء الطرح، وتُعتمد مرة واحدة عبر تغيير عادي.
- كل خطوة نسخة موقّعة. تُنشر الخطوات التالية تلقائيًا نسخًا جديدة، موقّعة وموزّعة مثل أي نشر، وتُسجَّل في سجل التدقيق خطوةً تلقائية من الطرح الموافق عليه.
- النسبة وحدها تتغيّر. تنشر الخطوة الإعدادات المنشورة للبيئة مع تغيير نسبة تلك القاعدة فقط، ولا تنشر أي عمل معلّق في المسودة.
إنشاء طرح
- أضف إلى مسودة العلم في البيئة قاعدة طرح بنسبة مئوية (يمكن أن تبدأ من 0%).
- من صفحة العلم اختر طرح تدريجي محمي، ثم القاعدة والخطوات ومدد تثبيتها، وأضف الحراس.
- إنشاء الخطة يضبط القاعدة على الخطوة الأولى في المسودة ويفتح تغييرًا للعلم يشرح الخطة في وصفه.
المراجعة والخطوة الأولى
يمر التغيير بالمسار المعتاد: طلب الموافقة، ثم يوافق مراجع مستقل (ليس منشئ الخطة ولا من عدّل المسودة منذ ذلك الحين)، ثم ينشره من يملك صلاحية النشر. هذا النشر هو الخطوة 1 ويبدأ الطرح. لا تُنشر الخطوة 1 أبدًا دون موافقة مستقلة، حتى في بيئة لا تتطلب الموافقة: فالطرح ينشر الخطوات التالية دون سؤال جديد، لذا يجب مراجعة الخطة نفسها.
النسخة المنشورة قبل الخطوة 1 مباشرة هي النسخة الآمنة: يعيد التراجع العلم إلى إعداداته فيها.
الحراس
| الحارس | ما يقرؤه | التجاوز |
|---|---|---|
| معدل الأخطاء | الوحدات التي تعرّضت لأول مرة خلال الخطوة الحالية في كل جانب من القاعدة، وكم منها أرسل حدثًا سيئًا واحدًا على الأقل (اسم حدث تختاره مثل checkout_failed، يُرسل عبر track()) | معدل الأحداث السيئة في الطرح أعلى من مجموعة المقارنة بدلالة إحصائية وبأكثر من الزيادة المسموحة |
| مراقبة Datadog | الحالة العامة للمراقبة، تُقرأ عبر اتصال Datadog من الإعدادات ← التكاملات (مفتاح API ومفتاح التطبيق) | المراقبة في حالة Alert (أو Alert أو Warn حسب اختيارك) |
- صحيح مع تكرار النظر. تُفحص الحراس كل دقيقة. يستخدم حارس معدل الأخطاء اختبارًا تسلسليًا (mSPRT)، فلا يزيد الفحص كل دقيقة من احتمال الإنذار الكاذب داخل الخطوة. تبدأ العينة من جديد في كل خطوة، فلا تخفي الخطوات السابقة مشكلةً عند نسبة أعلى.
- الحد الأدنى للعينة. إلى أن يبلغ الجانبان الحد الأدنى من الوحدات، يُظهر الحارس «بانتظار عينات كافية» وتنتظر الخطوة.
- التعرّضات. يعتمد حارس معدل الأخطاء على مسار التعرّض في التجارب: يبدأ NanoFlags تجربة حارسة على القاعدة مع الطرح (أو يعيد استخدام التجربة الجارية عليها) ويوقفها عند انتهاء الطرح. تُحتسب الأحداث من رصيد أحداث التجارب.
- عند 100% لا توجد مجموعة مقارنة: لا تنطبق حراس معدل الأخطاء على الخطوة الأخيرة، بينما تبقى حراس Datadog فعّالة.
- حراس رابط الصحة (نقطة HTTPS تستضيفها) مخطط لها وغير متاحة بعد.
الخطوات التلقائية
يفحص NanoFlags كل دقيقة كل طرح قيد التنفيذ. ترتفع الخطوة عندما تنقضي مدة تثبيتها ويكون كل الحراس ضمن الحدود. إذا تعذّرت قراءة أحد الحراس تنتظر الخطوة، وبعد 15 دقيقة متتالية يتوقف الطرح مؤقتًا ويُبلغك. إذا غيّر أحدٌ القاعدة خارج الطرح أو أوقف العلم أو استخدم مفتاح الإيقاف الطارئ، لا يُنشر شيء آخر ويتوقف الطرح مؤقتًا. بعد انقضاء مدة تثبيت الخطوة الأخيرة يكتمل الطرح.
التراجع
يؤدي تجاوز أي حارس إلى التراجع فورًا، في أي خطوة وحتى أثناء مدة التثبيت. ينشر التراجع نسخة جديدة يُعاد فيها هذا العلم وحده إلى إعداداته في النسخة الآمنة (وتبقى الأعلام الأخرى كما نُشرت)، ويعيد ضبط نسبة القاعدة في المسودة. تُوقف التجربة الحارسة. لإعادة المحاولة، عالج السبب ثم أنشئ طرحًا تدريجيًا محميًا جديدًا.
لا يستخدم التراجع مفتاح الإيقاف الطارئ: فذاك يقدّم قيمة الإيقاف للجميع، أما التراجع فيعيد الحالة التي رُوجعت قبل الطرح. ويمكنك استخدام مفتاح الإيقاف الطارئ في أي وقت.
لا يلغي التراجع أبدًا ما فعله شخص. إذا أُطفئ العلم أو استُخدم مفتاح الإيقاف الطارئ، فلا يُنشر شيء ويبقى العلم مطفأً. وإذا نشر أحدهم تعديلًا آخر على العلم أثناء الطرح، يبقى ذلك التعديل وتعود نسبة القاعدة وحدها إلى قيمتها الآمنة. وتوضّح صفحة الطرح أي الحالتين انطبقت.
الإيقاف المؤقت والاستئناف والإيقاف
- الإيقاف المؤقت يوقف الخطوات التلقائية ولا تُفحص الحراس. الاستئناف يعيد بدء مدة تثبيت الخطوة الحالية وعيّنتها.
- التراجع الآن يعيد الإعدادات الآمنة كما يفعل التراجع التلقائي. التوقف هنا ينهي الطرح ويُبقي النسبة الحالية.
- تتطلب هذه الإجراءات صلاحية النشر في البيئة. ويمكن إلغاء خطة لم تبدأ بعد، فيُغلق تغييرها.
الإشعارات والتدقيق
- يُرسل التراجع أو الإيقاف المؤقت التلقائي بريدًا إلى منشئ الطرح ومالك العلم، وإلى المالكين والمسؤولين (ما لم يوقفوا رسائل إخفاق الإصدارات).
- Slack: الحدث
rollout.rolled_back. Webhooks: rollout.rolled_back، وrollout.updatedلكل خطوة أو تغيير حالة آخر. - يسجّل سجل التدقيق الخطة وموافقتها وكل خطوة (بوصفها
revision.publishedمعkind: "rollout") وكل إيقاف مؤقت واستئناف وتراجع والنهاية. وتعرض صفحة الطرح خطًا زمنيًا حيًا لكل فحص مع قراءات كل حارس.
مع وكلاء الذكاء الاصطناعي والتوقيع المشترك
- وكلاء الذكاء الاصطناعي. تنشر الخطوات والتراجعات التلقائية النسبة الجديدة للقاعدة فقط فوق ما هو منشور. ولا تنشر المسودة أبدًا، لذا تبقى التعديلات التي اقترحها وكيل ذكاء اصطناعي معلّقة: فهي ما زالت تحتاج إلى تغيير خاص بها يوافق عليه شخص، ولا ينتظرها الطرح أبدًا.
- التوقيع المشترك من العميل. لا يمكن أن تحمل الخطوات والتراجعات التلقائية توقيعك المشترك، لذا لا يتوفر الطرح التدريجي المحمي في بيئة تتطلب التوقيع المشترك من العميل، ولا يمكن تفعيل التوقيع المشترك ما دام فيها طرح تدريجي محمي لم ينتهِ. ويظل مفتاح الإيقاف الطارئ يعمل في البيئات ذات التوقيع المشترك.
الخطط
الطرح التدريجي المحمي متاح في خطتي Scale وEnterprise. في الخطط الأخرى تعرض الصفحة ما يقدّمه، وتبقى عمليات الطرح الحالية قابلة للقراءة ويمكن دائمًا إيقافها مؤقتًا أو التراجع عنها أو إيقافها. إذا لم تعد الخطة تتضمنه، تتوقف الخطوات التلقائية ويتوقف الطرح مؤقتًا. انظر الخطط والحدود.