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)

רופא

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)

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

שיטות מוגנות

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.

שדות

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 הזה הוצא משימוש.
תוכלו להשתמש ב-constructor אחרים, אבל אנחנו שומרים אותה באופן זמני לצורך תאימות לאחור.

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

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

startMultiDeviceGce

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

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

פרמטרים
buildInfos :‏ ERROR(/List)

attributes MultiMap: מאפיינים שמשויכים להפעלה הנוכחית

החזרות
ERROR(/List) שמתאר את המידע ב-GCE Avd.

קליעות
TargetSetupError

שיטות מוגנות

buildGceCmd

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

פרמטרים
bootupLogs String

החזרות
String