المراجعة والأتمتة

البيئات الدائمة ومراجعة CI

أنشئ بيئات دائمة مشتركة باستخدام معالج الخطوات الأربع، وأعدّ ملفات تعريف مساحات عمل CI، وراجع أحداث الدمج عبر علامات تبويب CI الخمس، ورقِّ المرشحين الذين تم التحقق منهم من Console.

مسؤولو العملاءمشغّلو المنصة

آخر تحديث 18 يونيو 2026

البيئات الدائمة ومراجعة CI هي مهام سير عمل مملوكة لـ Console للتحقق المشترك. استخدمها عندما يحتاج العميل إلى وقت تشغيل طويل الأمد لضمان الجودة أو UAT أو العرض التوضيحي أو التجهيز أو مراجعة العميل، ويريد أن تجتاز التغييرات مراجعة الكود وضمان الجودة قبل ترقيتها.

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

يقع كلا السطحين في الشريط الأيسر لـ Console. تمتلك Environments أوقات التشغيل المشتركة ومرشحيها؛ وتمتلك CI & Review المسارات وأحداث الدمج وعمليات التشغيل وتسليم المزود. يرتبط الاثنان ببعضهما، لذا يمكنك التنقل بين بيئة وسجل مراجعتها دون فقدان السياق.

قبل أن تبدأ

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

إنشاء بيئة دائمة

افتح Environments وحدّد Create environment. يفتح Console معالجًا من أربع خطوات مع شريط خطوات في الأعلى: Source وRuntime وPolicy وReview. تعرض لوحة الإطلاق المباشرة على اليمين التحديدات الحالية وتسرد أي عناصر مطلوبة لا تزال تعيق العملية.

1. Source. اختر نطاق العميل، وسمِّ البيئة، وأكّد عنوان URL للمستودع وفرع المصدر. يتحقق Console من وصول المزود هنا. عندما يعتمد التغيير على أكثر من مستودع واحد، فعّل حزمة المستودعات بحيث يتم سحب مستودع وقت التشغيل ومستودع المنتج بالترتيب.
2. Runtime. اختر ملف تعريف البيئة الدائمة، وعائلة القالب، وهدف مساحة العمل، وحجم وقت التشغيل. يحدد ملف التعريف افتراضات إصدار WebCentral، بما في ذلك Java وGradle وTomcat وحزمة الترخيص المتوقعة لمساحة العمل الداعمة.
3. Policy. اضبط مصدر البذور (النسخة الاحتياطية لقاعدة البيانات) ودرجة الكشف ومحرك ترحيل قاعدة البيانات. اختر محرك الترحيل الذي يطابق الوجهة: Flyway أو ARCHIBUS DUW أو الترحيل المعطّل.
4. Review. أكّد خطة الإطلاق. تلخص شبكة المراجعة ملف التعريف ووضع المستودع والحجم والنسخة الاحتياطية لقاعدة البيانات. عندما يتوفر كل ما هو مطلوب، حدّد Create environment.

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

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

استخدم ملف تعريف إصدار WebCentral الذي يطابق مستودع المصدر أو WAR، خاصة لإصدارات WebCentral الأقدم التي تحتاج إلى Tomcat 8.5 أو Tomcat 9 بدلاً من الافتراضي الحالي. راجع الإعدادات المسبقة لمساحة العمل لمعرفة كيفية تعيين تلك الملفات الشخصية إلى إعدادات وقت التشغيل.

فتح اختصارات وقت تشغيل البيئة

بعد وجود مساحة العمل الدائمة، استخدم إجراءات بطاقة البيئة:

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

تحديث وقت تشغيل البيئة على مرحلتين

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

1. Request environment update. يوافق هذا على تحديث مساحة العمل الدائمة ويضع علامة عليه كمطلوب. يُظهر Console أن التحديث جاهز للبدء لكنه لم يمس البيئة قيد التشغيل بعد.
2. Start environment update. يبدأ هذا تحديث مساحة العمل الدائمة وينتظر نتيجة وقت التشغيل. ينقل Console الحالة إلى قيد التشغيل، ثم إلى مطبّق بمجرد أن يصبح وقت التشغيل الدائم على الإصدار المرقّى.

تعرض بطاقة البيئة حالة التحديث الحالية ووصفًا قصيرًا لكل مرحلة، بالإضافة إلى صفوف أدلة وقت التشغيل حتى تتمكن من تأكيد ما تغيّر.

إنشاء ملف تعريف مساحة عمل CI

افتح CI & Review وحدّد Create CI profile (وهو Create CI/profile في شريط الإجراءات العلوي). يفتح Console معالجًا من أربع خطوات بنفس شكل شريط الخطوات: Source وRuntime وPolicy وReview، يظهر في منطقة العمل كـ Source route وWorkspace runtime وRun policy وReview and create.

1. Source route. اختر العميل والمزود والمستودع والفرع وبيئة هدف اختيارية. تحديد بيئة هدف هو ما يفعّل فحص الوجهة لاحقًا. طبّق ملف تعريف حزمة المستودعات عندما يحتاج التغيير إلى مستودع وقت تشغيل بالإضافة إلى مستودع منتج أو تبعية.
2. Workspace runtime. اختر شكل مساحة العمل: review أو QA أو review plus QA أو destination QA. حدّد قالب CI وهدف مساحة العمل والحجم.
3. Run policy. اضبط الاحتفاظ والعناصر والمراحل التي تعمل ونطاق ضمان الجودة ومحرك ترحيل قاعدة البيانات. حدّد ملف تعريف إصدار WebCentral والنسخة الاحتياطية لقاعدة البيانات. تستخدم المراجعة عادةً استدلالاً عاليًا؛ ويستخدم ضمان الجودة عادةً استدلالاً منخفضًا بعد أن تجمع الفحوصات الحتمية الأدلة.
4. Review and create. أكّد ملف تعريف المسار في شبكة المراجعة، ثم حدّد Create CI profile.

حفظ ملف تعريف مساحة عمل CI لا ينشئ مساحة عمل مطور شخصية. إنه ينشئ البيانات الوصفية للمسار التي يستخدمها Console عندما يحتاج حدث دمج أو تشغيل اختبار إلى مساحة عمل للمراجعة أو ضمان الجودة. لا تزال عمليات التشغيل الخفيفة بإمكانها استخدام مشغّل Console دون مساحة عمل عندما لا تكون أدوات المتصفح وقاعدة البيانات وذكاء الكود مطلوبة.

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

علامات تبويب CI & Review الخمس

تنظَّم منطقة عمل CI & Review في خمس علامات تبويب فوق اللوحة الرئيسية، لكل منها عدّاد مباشر:

فوق علامات التبويب، يعرض شريط سير العمل خط أنابيب المراحل لحدث الدمج المحدد: Intake وReview وQA وTarget QA وMerge. تعرض كل مرحلة حالتها الخاصة، مثل open أو waiting أو skipped أو waiting on checks.

فرع المصدر فقط مقابل البيئة الهدف

تشغّل مسارات فرع المصدر فقط مراجعة الكود وضمان جودة المشغّل دون بيئة دائمة محددة. في هذا الوضع، يتخطى Console فحص البيئة الهدف عمدًا، وتظهر مرحلة Target QA على أنها skipped.

تضيف المسارات ذات البيئة الدائمة المحددة فحص بيئة هدف. بعد اجتياز مراجعة الكود وضمان جودة المشغّل، يتحقق Console من المرشح مقابل افتراضات البيئة المحددة قبل أن يتمكن الدمج أو الترقية من المتابعة.

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

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

إعداد تسليم المزود

افتح علامة التبويب Provider handoff وحمّل مسارًا لتسجيل اتصال المزود المُدار أو التحقق منه. يمتلك Console طبقة المراجعة؛ ويتيح اتصال المزود له نشر تعليقات المراجعة وضمان الجودة وإرسال ملاحظات الحالة واستقبال أحداث الدمج.

من علامة التبويب هذه يمكنك:

• حفظ اتصال مُدار. سجّل تطبيق المزود أو خطاف الخدمة أو مرجع اعتماد معتمد مثل token://... أو k8s://secret/key أو مرجع OpenBao/Vault. يمكن لـ Console أيضًا قبول رمز مزود لمرة واحدة أو كلمة مرور تطبيق وتخزينه في تخزين رموز Console أو Kubernetes Secret أو OpenBao/Vault. بعد الحفظ، يعرض Console معاينة اعتماد فقط.
• تدوير الاعتماد. استخدم Rotate credential عندما ينتهي الرمز أو يُستبدل. شغّل فحص اتصال بعد ذلك.
• إبطال الاعتماد. استخدم Revoke credential للاحتفاظ بسجل الاتصال لكن إيقاف النشر حتى تتم إضافة مرجع اعتماد جديد.
• تثبيت أو مصالحة webhook. استخدم Install webhook بحيث تصل تحديثات أحداث الدمج إلى Console، وReconcile webhook لإصلاح خطاف منحرف، وRemove webhook لإيقاف الأحداث. احفظ مسارًا أو حدّده قبل تثبيت webhook.
• فحص الاتصال. استخدم Check connection لتأكيد السلامة قبل الاعتماد على المسار للمراجعة أو الحالة أو نشر التعليقات.

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

لا تضع رموز المزود أو حمولات الاعتماد الخام أو أسرار النشر الخاصة في أسماء المسارات أو الأوصاف أو ملاحظات ضمان الجودة أو تعليمات المسار.

مراجعة حدث دمج

أحداث الدمج هي وحدة المراجعة العادية في Console. يمكن أن يأتي حدث الدمج من webhook المزود أو تسليم مساحة العمل أو التسجيل اليدوي في Console.

1. افتح CI & Review.
2. اختر حدث الدمج من علامة التبويب Merge events.
3. افتح Review in Console لرؤية فرع المصدر وفرع الهدف ورابط المزود وعناصر الميزة وقائمة المراجعين والتغييرات المكدّسة.
4. عيّن مراجعين أو أضف مراجعًا مخصصًا، وحدّث ملاحظات المراجع.
5. حدّد Start review & QA عندما يكون المسار جاهزًا.
6. راقب شريط سير العمل: Intake وReview وQA وTarget QA وMerge.

عند اكتشاف تغييرات مكدّسة، يعرض Console معاينة المكدّس المحدودة وسياق كل ملف الذي يمكنه عرضه بأمان. استخدم روابط المزود للسياق الثانوي فقط.

يمكن تشغيل مراجعة Archibot وضمان جودة المشغّل بشكل منفصل أو معًا. تركز المراجعة على الكود وسياق الفروق المكدّسة والاختبارات المفقودة والمسارات المحفوفة بالمخاطر وأثر الوثائق. يركز ضمان الجودة على أدلة التنفيذ مثل اختبار المتصفح الأولي وفحوصات قاعدة البيانات وأوامر الاختبار المحددة والتحقق من سلسلة الأدوات وسجلات مساحة العمل. راجع Console Bots لمعرفة كيفية تهيئة روبوتات مراجعة Archibot وضمان الجودة.

إذا احتاجت عملية تشغيل إلى التوقف، استخدم Cancel run على عملية التشغيل في علامة التبويب Evidence and logs. يضع Console علامة على التشغيل كملغى.

الدمج والترقية

يحتفظ Console بالدمج البشري كافتراضي.

قبل أن يصبح Merge in Console متاحًا:

• يجب تسجيل موافقة مراجع.
• يجب أن تجتاز مرحلة مراجعة الكود المطلوبة.
• يجب أن تجتاز مرحلة ضمان جودة المشغّل المطلوبة.
• إذا تم تحديد بيئة هدف، يجب أن يجتاز فحص البيئة الهدف.

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

السجلات والأدلة وShared Drive

تحتفظ CI & Review وEnvironments بسجل الأحداث في Console. استخدم الخط الزمني للتشغيل في علامة التبويب Evidence and logs لرؤية تغييرات المراحل وأسماء الوظائف وحالة البيئة الهدف وسطور السجل المنقّاة.

استخدم Save to Shared Drive عندما يحتاج الدعم إلى أدلة تتجاوز نافذة الاحتفاظ العادية بسجل التشغيل. يحتاج الحساب إلى محرك قابل للكتابة لهذا. حافظ على الأدلة طويلة الأمد منقّاة ومعتمدة من العميل. راجع Archibot لمساحة العمل وShared Drive لمعرفة كيفية عمل وصول المحرك المحدد النطاق.

يجب أن يتمكن المراجعون من الإجابة عن ثلاثة أسئلة من Console قبل الدمج:

• ما الذي تغيّر، بما في ذلك أي فروق مكدّسة؟
• ما فحوصات المراجعة وضمان الجودة والوجهة التي تم تشغيلها؟
• أين الدليل المنقّى إذا احتاجت عملية التشغيل إلى مراجعة الدعم لاحقًا؟

لا تشارك:

• مفاتيح API أو رموز المزود أو أسرار webhook أو ملفات تعريف الارتباط أو روابط الدعوة.
• أسرار Kubernetes أو متغيرات بيئة الجراب أو ملفات kubeconfig أو رموز Coder.
• عناوين URL الخام لقاعدة البيانات أو محتويات النسخ الاحتياطية الخام أو ملفات الترخيص.
• النصوص الخاصة أو عمليات تفريغ بيانات العملاء.

المعوّقات الشائعة

تسليم الدعم

للدعم، قم بتضمين:

• حساب العميل واسم البيئة.
• معرّف حدث الدمج أو معرّف تشغيل CI.
• فرع المصدر وفرع الهدف ورقم طلب الدمج لدى المزود عند ظهوره.
• المرحلة المعوّقة.
• خطأ Console المنقّى أو ملخص السجل.

لا تضمّن اعتمادات خام أو سجلات كاملة بها أسرار أو بيانات قاعدة بيانات خاصة أو روابط لمرة واحدة. راجع تسليم الدعم للحصول على قائمة التحقق الكاملة من الأدلة.