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

קונסטרוקטורים גלויים לכולם

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)

הפעלה בפועל של 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 logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)

אחזור קובץ מרוחק ממכונה בתצוגת עץ ורישום ביומן.

static void 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()
GceAvdInfo startGce(String ipDevice, MultiMap<String, String> attributes)

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

שיטות מוגנות

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

יוצרים את הפקודה להפעלת GCE ומחזירים אותה.

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

קונסטרוקטורים גלויים לכולם

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)

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

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

cleanUp

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 אם אירעה בעיה.

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 אם אירעה בעיה.

logNestedRemoteFile

public static void 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 של הקובץ ביומן.

logNestedRemoteFile

public static void 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, המערכת תשתמש בשם הקובץ בפועל.

logSerialOutput

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 ()

החזרות
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.
זריקות
TargetSetupError

שיטות מוגנות

buildGceCmd

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

יוצרים את הפקודה להפעלת GCE ומחזירים אותה. חשוף לבדיקה.

פרמטרים
reportFile File

b IBuildInfo

ipDevice String

attributes MultiMap

החזרות

extractInstanceName

protected String extractInstanceName (String bootupLogs)

אחזור שם המכונה מהיומנים של אתחול gce. מחפשים את הדפוס 'name': 'gce-' כדי לחלץ את השם שלו. אנחנו מחלצים מהיומנים במקום מקובץ התוצאה, כי כשהפעלת GCE נכשלת, שם המכונה שנשלחה לא יופיע ב-JSON.

פרמטרים
bootupLogs String

החזרות
String