Cloud Orchestration في نظام OmniLab ATS

يوفّر تطبيق Cloud Orchestration طريقة عالية الأداء وقابلة للتوسّع لإدارة مثيلات Cuttlefish، خاصةً للأجهزة الافتراضية المستندة إلى ARM (CHD). تتيح أداة OmniLab ATS إمكانية "التنسيق عبر السحابة الإلكترونية"، ما يتيح لك إجراء الاختبارات على الأجهزة الافتراضية. قبل البدء في استخدام الأجهزة الافتراضية، اتّبِع الخطوات الواردة في محطة اختبار Android في OmniLab لتثبيت OmniLab ATS.

نظرة عامة

تتيح أداة Cloud Orchestration لـ OmniLab ATS تفويض إدارة مثيلات Cuttlefish إلى خدمة Cloud Orchestrator مخصّصة. يوفّر هذا النهج العديد من المزايا مقارنةً بالوضعَين المحلي وعن بُعد الحاليَين، مع الحفاظ على تجربة مستخدم مألوفة:

• تشغيل مثيلات متوازية: يسمح بتشغيل عدة مثيلات من Cuttlefish في الوقت نفسه، ما يقلّل بشكل كبير من الوقت الإضافي قبل بدء الاختبارات.
• قابلية التوسّع: تناسب بيئات الاختبار على نطاق واسع.
• عزل الموارد: يتم فصل بيئة تنفيذ الاختبار (العامل في "خدمة اختبار التطبيقات") عن بيئة محاكاة الجهاز.

المتطلبات الأساسية

• جهاز مضيف يمكنه تشغيل Docker
• الوصول إلى صور Docker الخاصة بتنظيم Cuttlefish

إعداد خدمة Cloud Orchestrator

تتولّى خدمة Cloud Orchestrator إدارة مراحل نشاط مثيلات Cuttlefish. يمكنك نشر الخدمة في بيئات مختلفة، وهي تتوافق مع بنية x86 وARM:

• المضيف نفسه الذي يعمل عليه ATS: يتم تشغيله في حاوية Docker على الجهاز نفسه
• جهاز منفصل: يتم تشغيله على خادم داخل المؤسسة يمكنه تشغيل Docker
• الجهاز الافتراضي على السحابة الإلكترونية: يعمل على جهاز افتراضي في بيئة سحابية، مثل Google Compute Engine

تثبيت الخدمة وإعدادها

اتّبِع التعليمات الواردة في ملف Cloud Android Orchestration README لتشغيل الخدمة.

المصادقة والأذونات

إذا كانت خدمة Cloud Orchestrator تعمل على جهاز بعيد، تأكَّد من أنّ مضيف ATS worker لديه الأذونات اللازمة للوصول إليها من خلال طلبات HTTP. إذا لم يكن مسموحًا بالاتصال عبر HTTP، قد تحتاج إلى إعداد إعادة توجيه منفذ SSH. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة تجربة أداة تنسيق السحابة الإلكترونية.

الحالة المتوقّعة

بعد بدء خدمة Cloud Orchestrator بنجاح، من المفترض أن يكون من الممكن الوصول إليها باستخدام HTTP. يمكنك التحقّق من حالتها من خلال طلب بيانات من واجهة برمجة التطبيقات الخاصة بها:

• إرسال إشارة إلى الخدمة: يجب أن تتمكّن من الوصول إلى نقطة نهاية الخدمة من مضيف عامل OmniLab ATS. على سبيل المثال، يجب أن يؤدي تنفيذ curl -I http://localhost:8080/v1/zones/local/hosts إلى عرض ردّ HTTP ناجح (إما HTTP/1.1 200 OK أو عملية إعادة توجيه 302 Found إلى /username)، ما يؤكّد أنّ الخدمة نشطة ويمكن الوصول إليها.

ضبط إعدادات OmniLab ATS لتنظيم السحابة الإلكترونية

قبل بدء OmniLab ATS، تأكَّد من إيقاف جميع مثيلات Cuttlefish على مضيف عامل OmniLab ATS. تُشغّل أداة OmniLab ATS الأجهزة الافتراضية وتوقفها تلقائيًا أثناء دورة الاختبار، وتتعارض مثيلات Cuttlefish الحالية مع المثيلات التي تديرها أداة OmniLab ATS. للحصول على تفاصيل حول إيقاف مثيلات Cuttlefish، يُرجى الاطّلاع على إيقاف Cuttlefish.

لتفعيل Cloud Orchestration في OmniLab ATS، عليك تمرير علامات معيّنة عند بدء OmniLab ATS:

mtt start --use_cloud_orchestrator \
  --orchestration_service_url=http://HOST:PORT \
  --max_local_virtual_devices N \
  --use_host_network \
  --force_ats_version 2 \
  --force_update

• --use_cloud_orchestrator: تفعّل ميزة "التنسيق على السحابة الإلكترونية".
• ‫--orchestration_service_url: تحدّد عنوان URL الذي تستمع إليه خدمة Cloud Orchestration، على سبيل المثال، http://localhost:8080.
• --max_local_virtual_devices: يضبط هذا الحقل الحد الأقصى لعدد الأجهزة الافتراضية التي يمكن أن يخصّصها نظام OmniLab ATS في الوقت نفسه. العدد التلقائي هو 0.
• ‫--use_host_network: تستخدم مساحة اسم شبكة المضيف للحاوية. هذه الخطوة مطلوبة للوصول إلى خدمة "تنظيم السحابة الإلكترونية".
• ‫--force_ats_version 2: يفرض استخدام OmniLab ATS 2.0، وهو أمر مطلوب لخدمة Cloud Orchestration. لمزيد من المعلومات، راجِع دليل ترقية OmniLab ATS 2.0.
• --force_update: يجلب أحدث إصدار من الحاوية مع ميزات ATS 2.0 وCloud Orchestration.

إجراء اختبار باستخدام أجهزة تتم إدارتها من السحابة الإلكترونية

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

أجهزة محددة

في قائمة الأجهزة، يعرض OmniLab ATS الأجهزة الافتراضية التي يتم تنسيقها على السحابة الإلكترونية كعناصر نائبة بدلاً من أرقامها التسلسلية الفعلية. تظهر العناصر النائبة بالتنسيق HOSTNAME:PORT (على سبيل المثال، thehostname:6520). وتكون الحالات إما متوفّرة أو مخصّصة. يشير العنصر النائب في الحالة متاح إلى أنّ الجهاز الافتراضي لا يعمل ويمكن تخصيصه للاختبار.

الشكل 1: اختيار الأجهزة الافتراضية التي تتم إدارتها من السحابة الإلكترونية

إضافة إجراءات الجهاز

عند تحديد موعد لإجراء اختبار على هذه الأجهزة، يضيف نظام ATS تلقائيًا إجراءات الجهاز المطلوبة لتوفير مثيلات Cuttlefish وإدارتها أثناء دورة الاختبار.

الشكل 2: إجراءات الجهاز التلقائية

ضبط موارد الاختبار

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

• اربط حزمة أدوات المضيف، مثل cvd-host_package.tar.gz، بالاسم cvd_host_package.
• اربط ملف zip الخاص بنسخة الجهاز بالاسم cvd_device_image.

الشكل 3: ربط موارد الاختبار

عرض عمليات الاختبار والسجلّات

بعد اكتمال الاختبار، يمكنك الاطّلاع على السجلات في قسم ملفات الإخراج. تشمل السجلات المحدّدة التي يتم جمعها للآلات الافتراضية المُدارة من خلال Cloud Orchestrator ما يلي:

• launcher.log: السجلات من مشغّل Cuttlefish
• ‫kernel.log: سجلّ نواة Android العادي