GceManager

public class GceManager
extends Object

JavaScript.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)

רופא

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

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

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)

קבלת דוח על באג מהמכשיר באמצעות 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 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 או עם חמצן.

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 או עם חמצן.

startMultiDevicesGce( buildInfos)

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

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

צריך לנסות להפעיל מופע חמצן בכמה מכשירים.

שיטות מוגנות

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)

רופא

פרמטרים
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 של המכונה שבה רוצים להשתמש.

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

כיבוי Acloud

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)

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

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

getInstanceSeriesLog

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

קריאת התוכן הנוכחי של היומן הסידורי של מכונת Gce Avd.

פרמטרים
infos GceAvdInfo: השדה GceAvdInfo שמתאר את המכונה.
avdConfigFile File: קובץ התצורה הממוצע
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 אם התרחשה בעיה.
קליעות
חריגת IO

ספריית 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 מכילה את תוצאת הביצוע.

כיבויGce

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 שיש להוסיף כמטא-נתונים של VM
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 שיש להוסיף כמטא-נתונים של VM
החזרות
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 שיש להוסיף כמטא-נתונים של VM
החזרות
GceAvdInfo GceAvdInfo שמתאר את מכונת ה-GCE. יכול להיות מופע של BOOT_FAIL.
קליעות
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDeviceGce

public  startMultiDevicesGce ( buildInfos)

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

פרמטרים
buildInfos

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

startMultiDeviceGce

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

צריך לנסות להפעיל מופע חמצן בכמה מכשירים.

פרמטרים
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