GceManager

public class GceManager
extends Object

java.lang.Object
com.android.tradefed.device.cloud.GceManager


المساعد الذي يدير مكالمات GCE لبدء / إيقاف وجمع السجلات من GCE.

ملخص

مجالات

public static final String GCE_HOSTNAME_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_NAME_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

المنشئون العامة

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)

هذا المنشئ مهمل. استخدم المنشئات الأخرى ، نحتفظ بهذا مؤقتًا للتوافق مع الإصدارات السابقة.

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)

Ctor ، تباين يمكن استخدامه لتوفير اسم مثيل GCE لاستخدامه مباشرة.

الطرق العامة

static boolean AcloudShutdown ( TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)

تشغيل Acloud الفعلي لإيقاف تشغيل الجهاز الظاهري.

void cleanUp ()
static File getBugreportzWithSsh ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)

احصل على bugreportz من الجهاز باستخدام ssh لتجنب أي مشكلة محتملة في اتصال adb.

static String getInstanceSerialLog ( GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)

يقرأ المحتوى الحالي للسجل التسلسلي لمثيل Gce Avd.

static File getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)

احصل على تقرير خطأ عبر ssh لمثيل متداخل.

static boolean logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)

قم بإحضار ملف بعيد من مثيل متداخل وقم بتسجيله.

static boolean logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)

قم بإحضار ملف بعيد من مثيل متداخل وقم بتسجيله.

void logSerialOutput ( GceAvdInfo infos, ITestLogger logger)

قم بتسجيل الإخراج التسلسلي لجهاز موصوف بواسطة GceAvdInfo .

static CommandResult remoteSshCommandExecution ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)

نفِّذ الأمر عن بُعد عبر ssh في مثيل.

boolean shutdownGce ()

قم بإيقاف تشغيل مثيل Gce المرتبط بـ startGce() .

GceAvdInfo startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes)

حاول بدء مثيل gce إما باستخدام Acloud أو Oxygen.

GceAvdInfo startGce ()
GceAvdInfo startGce (String ipDevice, MultiMap <String, String> attributes)

محاولة بدء مثيل gce.

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

محاولة بدء تشغيل مثيل gce متعدد الأجهزة باستخدام Oxygen.

الطرق المحمية

buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap <String, String> attributes)

قم ببناء الأمر وإعادته لإطلاق GCE.

static buildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)
String extractInstanceName (String bootupLogs)

استرجع اسم المثيل من سجلات gce boot.

مجالات

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

المنشئون العامة

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo)

Ctor

المعلمات
deviceDesc DeviceDescriptor : هو DeviceDescriptor الذي سيرتبط بجهاز GCE.

deviceOptions TestDeviceOptions : أحد TestDeviceOptions المرتبطة بالجهاز.

buildInfo IBuildInfo : IBuildInfo يصف بنية gce للبدء.

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                 testResourceBuildInfos)

هذا المنشئ مهمل.
استخدم المنشئات الأخرى ، نحتفظ بهذا مؤقتًا للتوافق مع الإصدارات السابقة.

المعلمات
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                String gceInstanceName, 
                String gceHost)

Ctor ، تباين يمكن استخدامه لتوفير اسم مثيل GCE لاستخدامه مباشرة.

المعلمات
deviceDesc DeviceDescriptor : هو DeviceDescriptor الذي سيرتبط بجهاز GCE.

deviceOptions TestDeviceOptions : أحد TestDeviceOptions المرتبطة بالجهاز

buildInfo IBuildInfo : IBuildInfo يصف بنية gce للبدء.

gceInstanceName String : اسم المثيل المراد استخدامه.

gceHost String : اسم المضيف أو عنوان IP للمثيل المراد استخدامه.

الطرق العامة

AcloudShutdown

public static boolean AcloudShutdown (TestDeviceOptions options, 
                IRunUtil runUtil, 
                String instanceName, 
                String hostname, 
                boolean isIpPreconfigured)

تشغيل Acloud الفعلي لإيقاف تشغيل الجهاز الظاهري.

المعلمات
options TestDeviceOptions : The TestDeviceOptions لخيارات Acloud

runUtil IRunUtil : إن IRunUtil لتشغيل Acloud

instanceName String : المثيل المراد إيقاف تشغيله.

hostname String : اسم مضيف المثال ، يُستخدم فقط لحبار الأكسجين.

isIpPreconfigured قيمة boolean : ما إذا كان قد تم إنشاء AVD على جهاز بعيد باستخدام IP تم تكوينه مسبقًا

عائدات
boolean صحيح إذا نجح

تنظيف

public void cleanUp ()

getBugreportzWithSsh

public static File getBugreportzWithSsh (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

احصل على bugreportz من الجهاز باستخدام ssh لتجنب أي مشكلة محتملة في اتصال adb.

المعلمات
gceAvd GceAvdInfo : GceAvdInfo الذي يصف الجهاز.

options TestDeviceOptions : TestDeviceOptions يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.

runUtil IRunUtil : a IRunUtil لتنفيذ الأوامر.

عائدات
File ملف يشير إلى ملف zip bugreport ، أو فارغ إذا حدثت مشكلة.

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

يقرأ المحتوى الحالي للسجل التسلسلي لمثيل Gce Avd.

المعلمات
infos GceAvdInfo : يصف GceAvdInfo المثيل.

avdConfigFile File : ملف التكوين avd

jsonKeyFile File : ملف مفتاح json لحساب الخدمة.

runUtil IRunUtil : a IRunUtil لتنفيذ الأوامر.

عائدات
String إخراج السجل التسلسلي أو فارغ إذا حدث خطأ ما.

getNestedDeviceSshBugreportz

public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

احصل على تقرير خطأ عبر ssh لمثيل متداخل. هذا يتطلب طلب adb في المثيل الظاهري المتداخل.

المعلمات
gceAvd GceAvdInfo : GceAvdInfo الذي يصف الجهاز.

options TestDeviceOptions : TestDeviceOptions يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.

runUtil IRunUtil : a IRunUtil لتنفيذ الأوامر.

عائدات
File ملف يشير إلى ملف zip bugreport ، أو فارغ إذا حدثت مشكلة.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type)

قم بإحضار ملف بعيد من مثيل متداخل وقم بتسجيله.

المعلمات
logger ITestLogger : ITestLogger مكان تسجيل الملف.

gceAvd GceAvdInfo : GceAvdInfo الذي يصف الجهاز.

options TestDeviceOptions : TestDeviceOptions يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.

runUtil IRunUtil : a IRunUtil لتنفيذ الأوامر.

remoteFilePath String : المسار البعيد حيث يمكن العثور على الملف.

type LogDataType : نوع LogDataType .

عائدات
boolean ما إذا كان الملف قد تم تسجيله بنجاح.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName)

قم بإحضار ملف بعيد من مثيل متداخل وقم بتسجيله.

المعلمات
logger ITestLogger : ITestLogger مكان تسجيل الملف.

gceAvd GceAvdInfo : GceAvdInfo الذي يصف الجهاز.

options TestDeviceOptions : TestDeviceOptions يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.

runUtil IRunUtil : a IRunUtil لتنفيذ الأوامر.

remoteFilePath String : المسار البعيد حيث يمكن العثور على الملف.

type LogDataType : نوع LogDataType .

baseName String : الاسم الأساسي الذي سيتم استخدامه لتسجيل الملف. إذا كانت فارغة ، فسيتم استخدام اسم الملف الفعلي.

عائدات
boolean ما إذا كان الملف قد تم تسجيله بنجاح.

الإخراج التسلسلي

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

قم بتسجيل الإخراج التسلسلي لجهاز موصوف بواسطة GceAvdInfo .

المعلمات
infos GceAvdInfo : يصف GceAvdInfo المثيل.

logger ITestLogger : ITestLogger مكان تسجيل السجل التسلسلي.

remoteSshCommandExecution

public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                long timeoutMs, 
                String... command)

نفِّذ الأمر عن بُعد عبر ssh في مثيل.

المعلمات
gceAvd GceAvdInfo : GceAvdInfo الذي يصف الجهاز.

options TestDeviceOptions : TestDeviceOptions يصف خيارات الجهاز التي سيتم استخدامها لجهاز GCE.

runUtil IRunUtil : a IRunUtil لتنفيذ الأوامر.

timeoutMs long : المهلة بالمللي ثانية للأمر. 0 يعني عدم وجود مهلة.

command String : الأمر البعيد المطلوب تنفيذه.

عائدات
CommandResult CommandResult يحتوي على نتيجة الإعدام.

الاغلاق

public boolean shutdownGce ()

قم بإيقاف تشغيل مثيل Gce المرتبط بـ startGce() .

عائدات
boolean يعود صحيحًا إذا تم طلب إيقاف تشغيل gce باعتباره غير محظور.

بداية

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

حاول بدء مثيل gce إما باستخدام Acloud أو Oxygen.

المعلمات
ipDevice String : عنوان IP الأولي لمثيل GCE لتشغيل AVD فيه ، null إن لم يكن قابلاً للتطبيق

user String : المستخدم المضيف الذي يقوم بتشغيل AVD ، null إذا لم يكن قابلاً للتطبيق

offset Integer : رقم إزاحة الجهاز لـ AVD في المضيف ، null إن لم يكن قابلاً للتطبيق

attributes MultiMap : السمات المرتبطة بالاستدعاء الحالي ، تُستخدم لتمرير المعلومات القابلة للتطبيق إلى مثيل GCE لإضافتها كبيانات وصفية لـ VM

عائدات
GceAvdInfo GceAvdInfo يصف مثيل GCE. يمكن أن يكون نسخة BOOT_FAIL.

رميات
TargetSetupError

بداية

public GceAvdInfo startGce ()

عائدات
GceAvdInfo

رميات
TargetSetupError

بداية

public GceAvdInfo startGce (String ipDevice, 
                MultiMap<String, String> attributes)

محاولة بدء مثيل gce.

المعلمات
ipDevice String : عنوان IP الأولي لمثيل GCE لتشغيل AVD فيه ، null إن لم يكن قابلاً للتطبيق

attributes MultiMap : السمات المرتبطة بالاستدعاء الحالي ، تُستخدم لتمرير المعلومات القابلة للتطبيق إلى مثيل GCE لإضافتها كبيانات وصفية لـ VM

عائدات
GceAvdInfo GceAvdInfo يصف مثيل GCE. يمكن أن يكون نسخة BOOT_FAIL.

رميات
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

محاولة بدء تشغيل مثيل gce متعدد الأجهزة باستخدام Oxygen.

المعلمات
buildInfos : ERROR(/List ) ERROR(/List )

عائدات
a ERROR(/List ) ERROR(/List ) وصف GCE Avd Info.

رميات
TargetSetupError

الطرق المحمية

بناء

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

قم ببناء الأمر وإعادته لإطلاق GCE. يتعرض للاختبار.

المعلمات
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

عائدات

buildShutdownCommand

protected static  buildShutdownCommand (File config, 
                TestDeviceOptions options, 
                String instanceName, 
                String hostname, 
                boolean isIpPreconfigured)

المعلمات
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

عائدات

extractInstanceName

protected String extractInstanceName (String bootupLogs)

استرجع اسم المثيل من سجلات gce boot. ابحث عن "الاسم": "gce- "نمط لاستخراج اسمه. نقوم بالاستخراج من السجلات بدلاً من ملف النتائج لأنه في حالة فشل gce boot ، لن يظهر اسم المثيل الذي تمت محاولة استخدامه في json.

المعلمات
bootupLogs String

عائدات
String