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, ITestLogger logger)

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

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

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

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

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

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

هذه الطريقة مهملة. قم بإزالة هذا بعد تحديث الفرع الرئيسي.

startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes) startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes)

محاولة بدء تشغيل مثيل 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 ، أو فارغ إذا حدثت مشكلة.

رميات
IOException

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 ، أو فارغ إذا حدثت مشكلة.

رميات
IOException

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, 
                ITestLogger logger)

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

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

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

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

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

logger ITestLogger : ITestLogger مكان تسجيل سجلات تشغيل الجهاز.

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

رميات
com.android.tradefed.targetprep.TargetSetupError
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.

رميات
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

بداية

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.

رميات
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

هذه الطريقة مهملة.
قم بإزالة هذا بعد تحديث الفرع الرئيسي.

حدود
buildInfos

عائدات

رميات
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos, 
                MultiMap<String, String> attributes)

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

حدود
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : السمات المرتبطة بالاستدعاء الحالي

عائدات
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