تشغيل عادي - عبر الإنترنت في السحابة

برنامج:

اسم

عادي-تشغيل - تشغيل اختبار المهمة

موجز

تشغيل صندوق عادي [-h] [- غير تفاعلي] [-n] [- عدم-منع-إخراج]
[-f FORMAT] [-p OPTIONS] [-o FILE] [-t TRANSPORT]
[- النقل حيث أين] [- خيارات خيارات النقل]
[-معرف خطة اختبار T] [-نمط i] [-نمط x] [-قائمة بيضاء]

الوصف

قم بتشغيل وظيفة اختبارية

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

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

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

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

إذا لم يتم استئناف الجلسة (تم إنشاء جلسة جديدة) ، فقم بتعيين غير مكتمل
العلم.

3. استخدم اختيار الوظيفة (انظر الانتقاء وظائف أدناه) لاشتقاق قائمة التشغيل. هذه الخطوة
يتضمن حل تبعيات الوظيفة وإعادة ترتيب الوظائف إذا لزم الأمر.

4. اتبع قائمة التشغيل ، وتنفيذ كل وظيفة بالتسلسل إن أمكن. يمكن منع الوظائف
من التنفيذ عن طريق التبعيات الفاشلة أو الفاشلة (التقييم إلى نتيجة غير صحيحة)
تعبيرات الموارد.

في حالة إعادة إدخال وظيفة جديدة في أي وقت في النظام (انظر ولدت وظائف
أدناه) ، ثم يتم إحباط الحلقة وانتقال التحكم إلى الخطوة 3 لإعادة تحديد المهام.
لا يتم تجاهل النتائج الحالية لذلك لا يتم تجاهل الوظائف التي لها بالفعل بعض النتائج
أعدم مرة أخرى.

قبل وبعد تنفيذ أي مهمة ، يتم حفظ حالة الجلسة على القرص للسماح بالاستئناف
من وظيفة تعطل النظام بطريقة ما أو تعطل Plainbox نفسه.

5. قم بإزالة غير مكتمل العلم.

6. قم بتصدير حالة الجلسة إلى التنسيق المطلوب (انظر تصدير النتائج) والاستخدام
النقل المطلوب لإرسال النتائج (انظر النقل النتائج).

7. تعيين المقدمة العلم.

الانتقاء وظائف
يقدم Plainbox آليتين لاختيار الوظائف. يمكن استخدام كلاهما في نفس الوقت
يمكن استخدامها عدة مرات.

اختيار وظائف مع أنماط
يتم الكشف عن الآلية الأولى من خلال --تضمن النمط نمط خيار سطر الأوامر.
يرشد Plainbox إلى حدد أي وظيفة يتطابق معرّفها المؤهل بالكامل مع
تعبير عادي نمط.

سيتم ترتيب الوظائف المختارة بهذه الطريقة ، إن أمكن ، وفقًا لترتيب الأمر
حجج الخط. على سبيل المثال ، سيؤدي وجود سطر الأوامر التالي إلى تشغيل الوظيفة فو
قبل تشغيل الوظيفة شريط:
تشغيل عادي -i '. * :: foo' -i '. * :: bar'

اختيار وظائف مع قوائم بيضاء
الآلية الثانية هي - القائمة البيضاء القائمة البيضاء خيار سطر الأوامر. القوائم البيضاء (أو
خطط الاختبار ، والتي يسهل ربطها إلى حد ما). القوائم البيضاء هي ملفات نصية بسيطة
يتألف من قائمة من التعبيرات النمطية ، مماثلة لتلك التي يمكن تمريرها مع
-i الخيار.

وخلافا لل -i مع ذلك ، هناك نوعان من القوائم البيضاء. القوائم البيضاء المستقلة هي
غير مرتبط بأي مزود Plainbox. يمكن توزيع هذه القوائم البيضاء بالكامل
بشكل منفصل عن أي مكون آخر وبالتالي ليس له ارتباط بأي مساحة اسم.

لذلك ، يجب أن يتضمن كل نمط مساحة الاسم وملف
مكونات المعرف الجزئي. على سبيل المثال ، هذه قائمة بيضاء صالحة ومُؤهلة بالكامل:

2013.com.canonical.plainbox :: كعب /.*

سيحدد بشكل لا لبس فيه بعض الوظائف من مزود StubBox الداخلي الخاص
تم تضمينه في Plainbox. يمكن حفظه تحت أي اسم ملف وتخزينه في أي ملف
الدليل وسيحدد دائمًا نفس مجموعة الوظائف.

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

على سبيل المثال ، يمكن اختصار نفس النمط "كعب / .*" إلى:

كعب /. *

عادةً ما يتم استخدام بناء الجملة هذا في جميع القوائم البيضاء الخاصة بموفر معين ما لم يكن
يريد مشرف المزود صراحةً تضمين وظيفة من مساحة اسم أخرى (لـ
على سبيل المثال ، أحد تعريفات وظيفة Checkbox المعروفة).

ولدت وظائف
يوفر Plainbox طريقة لإنشاء وظائف في وقت التشغيل. هناك نوعان من الدوافع لهذا
ميزة.

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

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

قيد آخر هو أن الوظائف لا يمكن أن تتجاوز التعريفات الحالية.

خلق بين الوالدين والطفل جمعية
من السمات الملائمة والقديمة نسبيًا للوظائف التي تم إنشاؤها طباعة نسخة حرفية من
تعريفات الوظائف الموجودة من أ محلي يسمى تعريف الوظيفة بعد موضوع اختبار عام أو
الفئة. على سبيل المثال تعريف مهمة Checkbox __السلكي__ المطبوعات بمساعدة
قط (1) ، جميع تعريفات الوظائف المحددة في الملف wireless.txt.

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

استئناف
يوفر Plainbox وظيفة استئناف الجلسة بينما تمت مقاطعة الجلسة
(إما عن قصد أو بسبب عطل) يمكن استئنافها واستمرارها بشكل فعال
حيث توقفت.

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

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

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

تصدير النتائج
يوفر Plainbox طريقة لتصدير الحالة الداخلية للجلسة إلى ملف أكثر إفادة
شكل لمزيد من المعالجة.

اختيار مصدرين
يمكن تحديد المصدر باستخدام ملف --تنسيق الإخراج FORMAT خيار سطر الأوامر. قائمة
من المصدرين المتاحين (والتي قد تشمل مصدرين من أطراف ثالثة) يمكن الحصول عليها بالمرور
هيه --تنسيق الإخراج ? الخيار.

بعض التنسيقات مفيدة أكثر من غيرها من حيث قدرتها على نقل المزيد من
الدولة الداخلية. بناءً على طلبك ، قد ترغب في اختيار الأكثر عمومية
بتنسيق (json) ومعالجته بشكل أكبر باستخدام أدوات إضافية ، اختر التنسيق الأساسي
(نص) فقط للحصول على ملخص بسيط للنتائج أو أخيرًا اختر أحدهما
التنسيقات المتخصصة (xml و html) الخاصة بسير عمل Checkbox.

من خارج الصندوق ، يتم دعم المصدرين التاليين:

أتش تي أم أل
يقوم هذا المُصدّر بإنشاء صفحة HTML ثابتة بتقرير اختبار يمكن قراءته بواسطة الإنسان. انه مفيد
للتواصل مع البشر الآخرين ولأنه مستقل تمامًا وغير متصل بالإنترنت
يمكن إرسالها بالبريد الإلكتروني أو أرشفتها.

جسون
يقوم هذا المصدر بتكوين وثيقة JSON مع التمثيل الداخلي للجلسة
حالة. إنه المصدر الأكثر تنوعًا وهو مفيد وسهل لمزيد من المعالجة.
إنه ليس مقروءًا من قبل الإنسان بشكل خاص ولكن يمكن أن يكون مفيدًا جدًا لتصحيح الأخطاء على مستوى عالٍ
دون الحاجة إلى استخدام pdb ومعرفة العناصر الداخلية لـ Plainbox.

rfc822
يقوم هذا المصدر بإنشاء مستندات شبه RFC822. إنه محدود نوعًا ما ولا يستخدم كثيرًا.
ومع ذلك ، يمكن أن يكون مفيدًا في بعض الظروف.

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

XLSX
يقوم هذا المُصدّر بإنشاء ملف .xlsx مستقل (تنسيق XML لبرنامج Microsoft Excel)
يحتوي على تقرير اختبار يمكن قراءته من قبل الإنسان. إنه مشابه لتقرير HTML ولكنه كذلك
أسهل في التعديل. إنه مفيد للتواصل مع البشر الآخرين ولأنه كذلك تمامًا
مستقل وغير متصل يمكن إرسالها بالبريد الإلكتروني أو أرشفتها.

يعتمد ذلك على حزمة python3-xlsxwriter

عرافة
يقوم هذا المُصدّر بإنشاء مستند XML مسمى بشكل مربك إلى حد ما قابل للتطبيق على المستوى الداخلي فقط
سير عمل فريق Canonical Hardware Certification.

إنه ليس تمثيل XML عامًا لنتائج الاختبار وبدلاً من ذلك يحمل عددًا قليلاً
التركيبات القديمة التي يتم الاحتفاظ بها فقط للتوافق مع الأدوات الداخلية الأخرى. لو
تريد معالجة عامة ابحث عن JSON بدلاً من ذلك.

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

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

خيارات المصدر المعروفة موثقة أدناه:

جسون
مع سجل io:
ستتضمن البيانات التي تم تصديرها سجل الإدخال / الإخراج المرتبط بكل نتيجة وظيفة.
يتم تضمين البيانات في شكلها الأصلي المكون من ثلاث مجموعات ما لم يكن أحد الاسكواش io- سجل
or تتسطح io- سجل يتم استخدام الخيارات كذلك.

سجلات IO هي تمثيلات للبيانات التي تنتجها العملية التي تم إنشاؤها من
أمر shell المرتبط ببعض الوظائف.

الاسكواش io- سجل:
عند استخدامها مع ملفات مع- io- سجل الخيار يجعل Plainbox لتجاهل الدفق
الاسم والطابع الزمني وقم فقط بتضمين قائمة من السلاسل الثنائية بترميز base64. هذه
الخيار أكثر فائدة لإعادة بناء "ملفات السجل" البسيطة

تتسطح io- سجل:
عند استخدامها مع ملفات مع- io- سجل الخيار يتسبب في قيام Plainbox بربط جميع ملفات
السجلات المنفصلة بترميز base64 في سلسلة ثنائية كبيرة بترميز base64
تمثل كل الاتصالات التي حدثت.

مع قائمة التشغيل:
ستتضمن البيانات المصدرة قائمة التشغيل (تسلسل المهام المحسوبة من الملف المطلوب
قائمة الوظائف).

مع قائمة الوظائف:
ستتضمن البيانات المصدرة القائمة الكاملة للوظائف المعروفة للنظام

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

مع شاغلي الوظيفة:
ستتضمن البيانات المصدرة بعض خصائص كل تعريف وظيفة. حاليا
تتضمن هذه المجموعة الحقول التالية: المساعد, يتطلب, يعتمد, أمر
وصف.

مع المرفقات:
ستتضمن البيانات المصدرة المرفقات. يتم إنشاء المرفقات من المعياري مجرى
لكل وظيفة لها نوع البرنامج المساعد التعلق. المرفقات الفعلية هي
ترميز base64.

مع التعليقات:
ستتضمن البيانات التي تم تصديرها التعليقات التي أضافها عامل الاختبار إلى كل نتيجة مهمة
التي لديها منهم.

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

مع وظيفة التجزئة:
ستتضمن البيانات المصدرة ملف مزيج السمة بجانب كل نتيجة وظيفة. التجزئة
السمة هي المجموع الاختباري لبيانات تعريف الوظيفة. يمكن أن يكون مفيدًا جنبًا إلى جنب
مع مع وظيفة عن طريق.

آلة json:
سيكون مستند JSON الذي تم إنشاؤه في حده الأدنى (خاليًا من أي مسافة بيضاء اختيارية).
يُفضل استخدام هذا الخيار إذا لم تكن النتيجة أن يقرأها البشر
لأنه يوفر بعض المساحة.

rfc822
جميع الخيارات لها نفس المعنى الخاص بامتداد جسون مصدر: مع- io- سجل,
الاسكواش io- سجل, تتسطح io- سجل, مع قائمة التشغيل, مع قائمة الوظائف, مع خريطة الموارد,
مع وظيفة defs, مع المرفقات, مع التعليقات, مع وظيفة عن طريق, مع وظيفة التجزئة. الوحيد
الاستثناء هو آلة json الخيار الذي لا يوجد لهذا المصدر.

نص
كما هو الحال مع rfc822.

XLSX
مع معلومات النظام:
سيتضمن جدول البيانات الذي تم تصديره ورقة عمل توضح بالتفصيل الأجهزة القائمة على الأجهزة
على lspci و lsusb و udev وما إلى ذلك.

مع ملخص:
سيتضمن جدول البيانات المُصدَّر أرقام الاختبار. يتضمن هذا النسبة المئوية من
الاختبارات التي تم اجتيازها وفشلها وتم تخطيها والعدد الإجمالي.

مع الوصف الوظيفي:
سيتضمن جدول البيانات المُصدَّر أوصاف الوظائف في ورقة منفصلة

مع مرفقات النص:
سيتضمن جدول البيانات المُصدَّر مرفقات نصية في ورقة منفصلة

XML
اسم العميل:
يتيح هذا الخيار للعملاء تجاوز اسم التطبيق الذي يُنشئ ملف
مستند XML. افتراضيا هذا الاسم هو عادي. لاستخدام هذا الخيار يمر
- خيارات الإخراج اسم العميل = اسم آخر خيار سطر الأوامر.

النقل النتائج
يمكن حفظ النتائج التي تم تصديرها في ملف (هذا هو النقل الأساسي الأساسي)
أو يمكن تسليمها إلى أحد أنظمة النقل لمزيد من المعالجة. الفكرة هي أن
يمكن للمستخدمين المتخصصين توفير أنظمة النقل الخاصة بهم (غالبًا ما يقترن بـ
مصدر) لنقل نتائج الاختبار من النظام قيد الاختبار إلى نتيجة اختبار مركزية
مستودع.

يمكن تحديد النقل باستخدام ملف --المواصلات اختيار. مرة أخرى ، كما هو الحال مع المصدرين ، قائمة
يمكن الحصول على وسائل النقل المعروفة عن طريق تمرير --المواصلات ? اختيار. وسائل النقل تحتاج
عنوان URL المقصود الذي يمكن تحديده بامتداد - النقل - أين = اختيار. بناء جملة
يختلف عنوان URL حسب نوع النقل.

يأتي Plainbox مزودًا بوسائل النقل التالية:

منصة الإطلاق
يمكن لهذا النقل إرسال النتائج التي تم تصديرها باستخدام XML المصدر إلى أجهزة Launchpad
قاعدة البيانات. هذه ميزة غير معروفة يقدمها https://launchpad.net/ موقع الكتروني.

شهادة
يمكن لهذا النقل إرسال النتائج التي تم تصديرها باستخدام ملف XML المصدر إلى Canonical
موقع الشهادة (https://certification.canonical.com).

هذا النقل قليل الفائدة لأي شخص ما عدا فريق Canonical Hardware Certification
التي تحافظ أيضًا على Plainbox و Checkbox ولكن تم ذكرها هنا للتأكد من اكتمالها.

OPTIONS

اختياري الحجج:

- غير تفاعلي
تخطي الاختبارات التي تتطلب التفاعل

-n, --ركض جاف
لا تدير معظم الوظائف حقًا

- لا تقمع-الإخراج
لا تقمع إخراج أنواع معينة من المكونات الإضافية للوظائف

-f, --تنسيق الإخراج
حفظ نتائج الاختبار في الشكل المحدد (اجتياز؟ للحصول على قائمة من الاختيارات)

-p, - خيارات الإخراج
قائمة خيارات مفصولة بفواصل لآلية التصدير (تمرير؟ للحصول على قائمة
اختيارات)

-o, --ملف إلاخراج
حفظ نتائج الاختبار إلى FILE المحدد (أو stdout إذا كان FILE -)

-t, --المواصلات
استخدم النقل لإرسال النتائج إلى مكان ما (تمرير؟ للحصول على قائمة الخيارات)

الخيارات الممكنة:؟

- مكان النقل
مكان إرسال البيانات باستخدام وسيلة النقل المحددة

- خيارات النقل
قائمة مفصولة بفواصل لخيارات قيمة المفتاح (k = v) ليتم تمريرها إلى النقل

-T, --خطة اختبار
تحميل خطة الاختبار المحددة

-i, --تضمن النمط
تضمين الوظائف المطابقة للتعبير العادي المحدد

-x, - استبعاد النمط
استبعاد الوظائف المطابقة للتعبير العادي المحدد

-w, - القائمة البيضاء
تحميل القائمة البيضاء التي تحتوي على أنماط التشغيل

استخدم نظام التشغيل العادي عبر الإنترنت باستخدام خدمات onworks.net