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)

ה-constructor הזה הוצא משימוש. צריך להשתמש ב-constructors אחרים. אנחנו משאירים את זה באופן זמני לצורך תאימות לאחור.

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)

כדי למנוע בעיות אפשריות בחיבור adb, צריך לקבל bugreportz מהמכשיר באמצעות ssh.

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

קריאת התוכן הנוכחי של היומן הטורי של מכונה של GCE Avd.

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

איך מקבלים דוח באגים באמצעות ssh למכונה בתצוגת עץ.

static void logAndDeleteFile(File tempFile, String dataName, ITestLogger logger)
static void logDirectory(File remoteDirectory, String baseName, ITestLogger logger, LogDataType type)
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, MultiMap<String, String> attributes)

ניסיון להפעיל מכונה של GCE עם כמה מכשירים באמצעות Oxygen.

שיטות מוגנות

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

אחזור שם המכונה מהיומנים של אתחול gce.

שדות

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 שמתאר את ה-build של gce שרוצים להתחיל.

GceManager

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

ה-constructor הזה הוצא משימוש.
שימוש ב-constructors אחרים. אנחנו משאירים את זה באופן זמני לצורך תאימות לאחור.

פרמטרים
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 שמתאר את ה-build של gce שרוצים להתחיל.
gceInstanceName String: שם המכונה שבה רוצים להשתמש.
gceHost String: שם המארח או כתובת ה-IP של המכונה שבה רוצים להשתמש.

שיטות ציבוריות

AcloudShutdown

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

הפעלה בפועל של Acloud כדי לכבות את המכשיר הווירטואלי.

פרמטרים
options TestDeviceOptions: TestDeviceOptions לאפשרויות של Acloud
runUtil IRunUtil: ה-IRunUtil להפעלת Acloud
instanceName String: המכונה שרוצים לכבות.
hostname String: שם המארח של המכונה, משמש רק לדיונון חמצן.
isIpPreconfigured boolean: האם ה-AVD נוצר במכשיר מרוחק עם כתובת IP מוגדרת מראש
החזרות
boolean True אם הפעולה הושלמה בהצלחה

ניקוי

public void cleanUp ()

getBugreportzWithSsh

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

כדי למנוע בעיות אפשריות בחיבור adb, צריך לקבל bugreportz מהמכשיר באמצעות ssh.

פרמטרים
gceAvd GceAvdInfo: ה-GceAvdInfo שמתארים את המכשיר.
options TestDeviceOptions: TestDeviceOptions שמתאר את האפשרויות לשימוש במכשיר ה-GCE.
runUtil IRunUtil: IRunUtil להפעלת פקודות.
החזרות
File קובץ שמצביע על קובץ ה-zip של דוח הבאג, או null אם אירעה בעיה.
זריקות
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: IRunUtil להפעלת פקודות.
החזרות
String הפלט של היומן הסידורי או null אם משהו משתבש.

getNestedDeviceSshBugreportz

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

קבלת דוח על באג באמצעות SSH למכונה פנימית. לשם כך צריך לבקש את adb במכונה הווירטואלית בתצוגת עץ.

פרמטרים
gceAvd GceAvdInfo: ה-GceAvdInfo שמתארים את המכשיר.
options TestDeviceOptions: TestDeviceOptions שמתאר את האפשרויות לשימוש במכשיר ה-GCE.
runUtil IRunUtil: IRunUtil להפעלת פקודות.
החזרות
File קובץ שמצביע על קובץ ה-zip של דוח הבאג, או null אם אירעה בעיה.
זריקות
IOException

logAndDeleteFile

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

פרמטרים
tempFile File

dataName String

logger ITestLogger

logDirectory

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

פרמטרים
remoteDirectory File

baseName String

logger ITestLogger

type LogDataType

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: 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: IRunUtil להפעלת פקודות.
remoteFilePath String: הנתיב המרוחק שבו נמצא הקובץ.
type LogDataType: ה-LogDataType של הקובץ ביומן.
baseName String: שם הבסיס שבו יש להשתמש כדי לתעד את הקובץ ביומן. אם הערך יהיה null, המערכת תשתמש בשם הקובץ בפועל.
החזרות
boolean אם הקובץ נרשם ביומן בהצלחה.

LogSeriesOutput (פלט טורי)

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: IRunUtil להפעלת פקודות.
timeoutMs long: זמן הקצאת הזמן הקצוב לביצוע הפקודה באלפיות השנייה. הערך 0 משמעו שאין זמן קצוב לתפוגה.
command String: הפקודה מרחוק שרוצים להריץ.
החזרות
CommandResult CommandResult שמכיל את תוצאת ההרצה.

shutdownGce

public boolean shutdownGce ()

מכבים את המכונה ב-GCE שמשויכת ל-startGce().

החזרות
boolean מחזירה True אם התבקשה כיבוי של gce ללא חסימה.

startGce

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

צריך לנסות להפעיל מכונת gce עם Acloud או עם חמצן.

פרמטרים
ipDevice String: כתובת ה-IP הראשונית של מכונת GCE שבה יופעל AVD, null אם לא רלוונטי
user String: המשתמש שמפעיל את המארח של AVD, null אם לא רלוונטי
offset Integer: ההיסט של מספר המכשיר של ה-AVD במארח, null אם לא רלוונטי
attributes MultiMap: מאפיינים שמשויכים להפעלה הנוכחית, המשמשים להעברת המידע הרלוונטי למכונה של GCE כדי להוסיף אותו כמטא-נתונים של המכונה הווירטואלית
logger ITestLogger: ה-ITestLogger שבו יופיעו יומני ההשקה של המכשיר.
החזרות
GceAvdInfo GceAvdInfo שמתאר את המכונה ב-GCE. יכול להיות מופע BOOT_FAIL.
זריקות
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

החזרות
GceAvdInfo

קליעות
TargetSetupError

startGce

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

מנסים להפעיל מכונה של GCE.

פרמטרים
ipDevice String: כתובת ה-IP הראשונית של מכונה ב-GCE שבה מריצים את AVD, או null אם היא לא רלוונטית
attributes MultiMap: מאפיינים שמשויכים להפעלה הנוכחית, ומשמשים להעברת מידע רלוונטי אל מכונת ה-GCE להוספה כמטא-נתונים של מכונה וירטואלית
החזרות
GceAvdInfo GceAvdInfo שמתאר את המכונה ב-GCE. יכול להיות מופע של BOOT_FAIL.
זריקות
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

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

צריך לנסות להפעיל מכונת gce עם Acloud או עם חמצן.

פרמטרים
ipDevice String: כתובת ה-IP הראשונית של מכונת GCE שבה יופעל AVD, null אם לא רלוונטי
user String: המשתמש שמפעיל את המארח של AVD, null אם לא רלוונטי
offset Integer: ההיסט של מספר המכשיר של ה-AVD במארח, null אם לא רלוונטי
attributes MultiMap: מאפיינים שמשויכים להפעלה הנוכחית, המשמשים להעברת המידע הרלוונטי למכונה של GCE כדי להוסיף אותו כמטא-נתונים של המכונה הווירטואלית
החזרות
GceAvdInfo GceAvdInfo שמתאר את המכונה ב-GCE. יכול להיות מופע BOOT_FAIL.
זריקות
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDeviceGce

public  startMultiDevicesGce ( buildInfos)

השיטה הזו הוצאה משימוש.
צריך להסיר את השורה הזו אחרי שההסתעפות הראשית מתעדכנת.

פרמטרים
buildInfos

החזרות
זריקות
TargetSetupError

startMultiDevicesGce

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

ניסיון להפעיל מכונה של GCE עם כמה מכשירים באמצעות Oxygen.

פרמטרים
buildInfos : ERROR(/List)
attributes MultiMap: מאפיינים המשויכים להפעלה הנוכחית
החזרות
ERROR(/List) שמתאר את המידע ב-GCE Avd.
זריקות
TargetSetupError

שיטות מוגנות

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. צריך לחפש את הדפוס 'name': 'gce-' כדי לחלץ את השם שלו. אנחנו מחלצים מהיומנים במקום מקובץ התוצאה, כי כשהפעלת GCE נכשלת, שם המכונה שנשלחה לא יופיע ב-JSON.

פרמטרים
bootupLogs String

החזרות
String