وثائق المنتج

هذه الترجمة مُنشأة آليًا (إصدار تجريبي). الدليل الإنجليزي هو المرجع المعتمد.

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

البيئات الدائمة وCI & Review

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

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

آخر تحديث

CI & Review مع ملخص الفريق وشريط مسار Intake وReview وQA وTarget QA وMerge وعلامات تبويب مساحة العمل وطلبي دمج، باستخدام بيانات مثال آمنة.
بيانات مثال آمنة: يتتبع CI & Review كل حدث دمج من الاستلام حتى الدمج.

Environments (/environments) وCI & Review (/ci-review) هما مهارا التحقق المشتركتان في Console. استخدمهما عندما يحتاج الفريق إلى بيئة تشغيل طويلة الأمد لضمان الجودة أو UAT أو العرض التوضيحي أو التجهيز أو مراجعة العميل، ويريد اجتياز التغييرات مراجعة الكود وضمان الجودة قبل ترقيتها.

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

من يمكنه رؤيتهما

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

قبل أن تبدأ

البيئات الدائمة

تسرد Persistent Environments (“أنشئ مساحات عمل دائمة لبيئات الفريق وأدرها”) بيئات الفريق مع قائمة الانتظار والتفاصيل والفاحص. يشرح زر (i) بجانب العنوان الصفحة ويربط بهذا الدليل.

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

اختر Create environment (/environments/new). يتضمن المعالج أربع خطوات: Source وRuntime وPolicy وReview، ولوحة تشغيل تسرد ما لا يزال يحول دون الإنشاء.

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

البيئات الدائمة: قائمة انتظار البيئة بجانب حالة البيئة المحددة والمرشح والترقية وإجراءات مساحة العمل، باستخدام بيانات مثال آمنة.

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

اختصارات وقت التشغيل

الإجراءمتى تستخدمه
Open workspaceعندما تحتاج إلى محرر مساحة العمل المسندة أو صدفتها.
Open Archibusعندما تريد تطبيق Tomcat /archibus.
Restart Tomcatعندما تحتاج إلى إعادة تشغيل Tomcat بضوابط محددة.
Open archibus.logعندما تحتاج إلى أدلة حديثة من سجل التطبيق.
Open CI & Reviewعندما تحتاج إلى سجل المراجعة وضمان الجودة والترقية لهذه البيئة.

تحديث البيئة على مرحلتين

لا تُعاد مطلقًا تهيئة بيئة مشتركة عن طريق الخطأ:

  1. يوافق Request environment update على التحديث لكنه لا يمس البيئة قيد التشغيل بعد.
  2. يبدأ Start environment update التحديث وينتظر. تنتقل الحالة إلى قيد التشغيل ثم إلى مطبّق.

بيئة تتضمن مرشحًا متحققًا منه وتحديثًا مطلوبًا، باستخدام بيانات مثال آمنة.

CI & Review

CI & Review (“تابع أحداث الدمج من الاستلام إلى الموافقة وضمان جودة مساحة العمل والتحقق من البيئة الهدف والدمج البشري”) هو المكان الذي تُراجع فيه التغييرات وتُدمج. يشرح زر (i) بجانب العنوان الصفحة ويربط بهذا الدليل.

يعرض شريط سير العمل مراحل حدث الدمج المحدد: Intake وReview وQA وTarget QA وMerge. وتحته خمس علامات تبويب، لكل منها عدد:

علامة التبويبما تعرضه
Merge eventsقائمة انتظار المراجعة: كل حدث دمج مصدره webhook أو تسليم مساحة عمل أو تسجيل يدوي.
Reviewحدث الدمج المحدد (Review in Console): الفروع والمراجعون والتغييرات المتراكبة وعناصر التحكم لبدء المراجعة وضمان الجودة.
Run detailتفاصيل التشغيل والجدول الزمني للمراحل وأسطر السجل المنقّحة.
Repository routesملفات CI الشخصية المحفوظة لمساحات العمل. حمّل إعداد المزوّد للمسار أو ابدأ تشغيلًا.
Provider handoffاتصال المزوّد وwebhook وتفاصيل المسار المحدد.

إنشاء ملف CI شخصي لمساحة العمل

اختر Create CI profile (/ci-review/workspaces/new). الخطوات هي Source route وWorkspace runtime وRun policy وReview and create.

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

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

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

في Provider handoff، حمّل مسارًا ثم:

  • احفظ اتصالاً مُدارًا باستخدام مرجع بيانات اعتماد معتمد. لا يعرض Console سوى معاينة بعد الحفظ.
  • Rotate credential أو Revoke credential.
  • Install webhook أو Reconcile webhook أو Remove webhook.
  • Check connection قبل الاعتماد على المسار.

لا تضع أبدًا رموز المزوّد في أسماء المسارات أو أوصافها أو ملاحظات ضمان الجودة.

مراجعة التنفيذ

تحوّل مراجعة التنفيذ تغييرًا مخططًا، غالبًا مسألة معتمدة في Design، إلى كود مدمج:

  1. ينفذ المطوّر المسألة في مساحة عمل ويدفع فرعًا إلى Git.
  2. يصل التغيير إلى Merge events من webhook المزوّد أو تسليم مساحة عمل أو تسجيل يدوي.
  3. في Review، افحص فرعي المصدر والهدف ورابط المزوّد والمراجعين والتغييرات المتراكبة. عيّن المراجعين وأضف ملاحظات.
  4. اختر Start review & QA. تفحص مراجعة ArchiBot الكود والفروق المتراكبة والاختبارات المفقودة والمسارات الخطرة. يجمع Runner QA أدلة التنفيذ: اختبارات المتصفح السريعة وفحوصات قواعد البيانات وأوامر الاختبار وسجلات مساحة العمل. راجع روبوتات Console.
  5. تابع شريط سير العمل وRun detail. استخدم Cancel run لإيقاف التشغيل.

لا يتاح Merge in Console إلا عند تحقق ما يلي:

  • تسجيل موافقة مراجع؛
  • اجتياز مراجعة الكود المطلوبة؛
  • اجتياز Runner QA المطلوب؛ و
  • اجتياز فحص البيئة الهدف عند تحديدها.

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

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

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

علامة Review لحدث دمج: بوابة الموافقة وجاهزية الدمج مع المراجعين ومراجعة ArchiBot وRunner QA وضمان جودة الوجهة والدمج اليدوي في Console، باستخدام بيانات مثال آمنة.

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

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

على الهاتف

  • تعرض Environments قائمة الانتظار والتفاصيل والفاحص في صفوف متراكبة. يؤدي اختيار بيئة إلى تمرير تفاصيلها إلى العرض.
  • يظل Create environment وCreate CI profile مثبتين أسفل الشاشة أثناء المعالجين. تُخفى الأزرار المكررة في لوحة التشغيل وبطاقة المراجعة ليبقى زر أساسي واحد.
  • يتحول جدول مزوّدي CI في معالج الملف الشخصي إلى بطاقات معنونة.
  • يمكن تمرير علامات تبويب CI & Review أفقيًا، وتكون روابط المراجعين والتشغيل وطلبات الدمج ذات أهداف لمس كبيرة.
  • تُفتح Build logs ومربعات الحوار الأخرى كلوحات بعرض الشاشة. وتتلاءم نافذة (i) بجوار كل عنوان مع الشاشة.

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

إنشاء ملف CI لمساحة عمل على هاتف: خيارات المزوّد كبطاقات كاملة العرض وزر Create CI profile مثبت في الأسفل، باستخدام بيانات مثال آمنة.

استكشاف الأخطاء وإصلاحها

العائقمعناه المعتادالخطوة التالية
وصول المستودع مفقودلم يتمكن Console من تأكيد وصول Git.حدّث بيانات الاعتماد أو افتح Manage Git access.
الهدف أو القالب مفقودلا يوجد هدف أو اسم مستعار لقالب مطابق.اطلب من مسؤول الفريق أو ISM التحقق من جاهزية الهدف.
لم تُحدَّد نسخة احتياطيةتحتاج البيئة أو ملف QA الشخصي إلى بذرة.اختر نسخة احتياطية معتمدة.
سياسة الترحيل مفقودةلم يُختر محرك ترحيل.اختر المحرك الملائم للوجهة.
فحص البيئة الهدف محظوراجتازت المراجعة وضمان الجودة لكن فشل دليل الوجهة.اقرأ الجدول الزمني للتشغيل قبل الدمج.
زر Promote candidate معطلالمرشح مفقود أو قديم أو لم يتم التحقق منه.أعد تشغيل المراجعة وضمان الجودة أو اختر الفرع الصحيح.

للدعم، أدرج الفريق واسم البيئة وحدث الدمج أو معرّف التشغيل والفروع والمرحلة المحظورة ورسالة خطأ منقّحة. راجع تسليم الدعم.

أدلة ذات صلة

تكتمل المهمة عند

  • يستخدم ملف البيئة وملف CI الشخصي ملف إصدار WebCentral الشخصي نفسه.
  • تظهر حالة Review وQA وفحص البيئة الهدف والدمج في Console قبل أي دمج.
  • لا تحتوي السجلات المحفوظة في Shared Drive على أسرار.