Gce Manager

public class GceManager
extends Object

java.lang.Object
com.android.tradefed.device.cloud.GceManager


Helper che gestisce le chiamate GCE per avviare/arrestare e raccogliere i log da GCE.

Riepilogo

Campi

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

Costruttori pubblici

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Rettore

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

Questo costruttore è deprecato. Usa altri costruttori, lo manteniamo temporaneamente per la compatibilità con le versioni precedenti.

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)

Ctor, variazione che può essere utilizzata per fornire il nome dell'istanza GCE da utilizzare direttamente.

Metodi pubblici

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

Acloud effettivo eseguito per spegnere il dispositivo virtuale.

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

Ottieni un bugreportz dal dispositivo usando ssh per evitare qualsiasi potenziale problema di connessione adb.

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

Legge il contenuto corrente del registro seriale dell'istanza Gce Avd.

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

Ottieni una segnalazione di bug tramite ssh per un'istanza nidificata.

static boolean logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)

Recupera un file remoto da un'istanza nidificata e registralo.

static boolean logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)

Recupera un file remoto da un'istanza nidificata e registralo.

void logSerialOutput ( GceAvdInfo infos, ITestLogger logger)

Registra l'uscita seriale di un dispositivo descritto da GceAvdInfo .

static CommandResult remoteSshCommandExecution ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)

Esegui il comando remoto tramite ssh su un'istanza.

boolean shutdownGce ()

Arresta l'istanza Gce associata a startGce() .

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

Tentativo di avviare un'istanza gce con Acloud o Oxygen.

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

Tentativo di avviare un'istanza gce.

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Tentativo di avviare l'istanza gce di più dispositivi con Oxygen.

Metodi protetti

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

Compila e restituisci il comando per avviare GCE.

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

Recupera il nome dell'istanza dai log di avvio di gce.

Campi

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

Costruttori pubblici

Gce Manager

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

Rettore

Parametri
deviceDesc DeviceDescriptor : DeviceDescriptor che sarà associato al dispositivo GCE.

deviceOptions TestDeviceOptions : un TestDeviceOptions associato al dispositivo.

buildInfo IBuildInfo : un IBuildInfo che descrive la build gce da avviare.

Gce Manager

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

Questo costruttore è deprecato.
Usa altri costruttori, lo manteniamo temporaneamente per la compatibilità con le versioni precedenti.

Parametri
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

Gce Manager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                String gceInstanceName, 
                String gceHost)

Ctor, variazione che può essere utilizzata per fornire il nome dell'istanza GCE da utilizzare direttamente.

Parametri
deviceDesc DeviceDescriptor : DeviceDescriptor che sarà associato al dispositivo GCE.

deviceOptions TestDeviceOptions : un TestDeviceOptions associato al dispositivo

buildInfo IBuildInfo : un IBuildInfo che descrive la build gce da avviare.

gceInstanceName String : il nome dell'istanza da utilizzare.

gceHost String : il nome host o l'ip dell'istanza da utilizzare.

Metodi pubblici

Arresto di una nuvola

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

Acloud effettivo eseguito per spegnere il dispositivo virtuale.

Parametri
options TestDeviceOptions : Il TestDeviceOptions per le opzioni Acloud

runUtil IRunUtil : IRunUtil per eseguire Acloud

instanceName String : l'istanza da chiudere.

hostname String : hostname dell'istanza, utilizzato solo per le seppie Oxygen.

isIpPreconfigured boolean : se l'AVD è stato creato su un dispositivo remoto con IP preconfigurato

ritorna
boolean Vero in caso di successo

pulire

public void cleanUp ()

getBugreportzWithSsh

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

Ottieni un bugreportz dal dispositivo usando ssh per evitare qualsiasi potenziale problema di connessione adb.

Parametri
gceAvd GceAvdInfo : GceAvdInfo che descrive il dispositivo.

options TestDeviceOptions : un TestDeviceOptions che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.

runUtil IRunUtil : un IRunUtil per eseguire comandi.

ritorna
File Un file che punta alla segnalazione di bug zip o null se si è verificato un problema.

getInstanceSerialLog

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

Legge il contenuto corrente del registro seriale dell'istanza Gce Avd.

Parametri
infos GceAvdInfo : GceAvdInfo che descrive l'istanza.

avdConfigFile File : il file di configurazione avd

jsonKeyFile File : il file della chiave json dell'account di servizio.

runUtil IRunUtil : un IRunUtil per eseguire comandi.

ritorna
String L'output del registro seriale o null se qualcosa va storto.

getNestedDeviceSshBugreportz

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

Ottieni una segnalazione di bug tramite ssh per un'istanza nidificata. Ciò richiede la richiesta di adb nell'istanza virtuale nidificata.

Parametri
gceAvd GceAvdInfo : GceAvdInfo che descrive il dispositivo.

options TestDeviceOptions : un TestDeviceOptions che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.

runUtil IRunUtil : un IRunUtil per eseguire comandi.

ritorna
File Un file che punta alla segnalazione di bug zip o null se si è verificato un problema.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type)

Recupera un file remoto da un'istanza nidificata e registralo.

Parametri
logger ITestLogger : ITestLogger in cui registrare il file.

gceAvd GceAvdInfo : GceAvdInfo che descrive il dispositivo.

options TestDeviceOptions : un TestDeviceOptions che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.

runUtil IRunUtil : un IRunUtil per eseguire comandi.

remoteFilePath String : il percorso remoto in cui trovare il file.

type LogDataType : il LogDataType del file registrato.

ritorna
boolean se il file è stato registrato correttamente.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName)

Recupera un file remoto da un'istanza nidificata e registralo.

Parametri
logger ITestLogger : ITestLogger in cui registrare il file.

gceAvd GceAvdInfo : GceAvdInfo che descrive il dispositivo.

options TestDeviceOptions : un TestDeviceOptions che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.

runUtil IRunUtil : un IRunUtil per eseguire comandi.

remoteFilePath String : il percorso remoto in cui trovare il file.

type LogDataType : il LogDataType del file registrato.

baseName String : il nome di base da utilizzare per registrare il file. Se null verrà utilizzato il nome del file effettivo.

ritorna
boolean se il file è stato registrato correttamente.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Registra l'uscita seriale di un dispositivo descritto da GceAvdInfo .

Parametri
infos GceAvdInfo : GceAvdInfo che descrive l'istanza.

logger ITestLogger : ITestLogger in cui registrare il registro seriale.

RemoteSshCommandExecution

public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                long timeoutMs, 
                String... command)

Esegui il comando remoto tramite ssh su un'istanza.

Parametri
gceAvd GceAvdInfo : GceAvdInfo che descrive il dispositivo.

options TestDeviceOptions : un TestDeviceOptions che descrive le opzioni del dispositivo da utilizzare per il dispositivo GCE.

runUtil IRunUtil : un IRunUtil per eseguire comandi.

timeoutMs long : il timeout in millisecondi per il comando. 0 significa nessun timeout.

command String : il comando remoto da eseguire.

ritorna
CommandResult CommandResult contenente il risultato dell'esecuzione.

shutdownGce

public boolean shutdownGce ()

Arresta l'istanza Gce associata a startGce() .

ritorna
boolean restituisce true se l'arresto di gce è stato richiesto come non bloccante.

startGce

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

Tentativo di avviare un'istanza gce con Acloud o Oxygen.

Parametri
ipDevice String : l'IP iniziale dell'istanza GCE in cui eseguire AVD, null se non applicabile

user String : l'host che esegue l'utente di AVD, null se non applicabile

offset Integer : l'offset del numero di dispositivo dell'AVD nell'host, null se non applicabile

attributes MultiMap : attributi associati alla chiamata corrente, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM

ritorna
GceAvdInfo un GceAvdInfo che descrive l'istanza GCE. Potrebbe essere un'istanza BOOT_FAIL.

Tiri
TargetSetupError

startGce

public GceAvdInfo startGce ()

ritorna
GceAvdInfo

Tiri
TargetSetupError

startGce

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

Tentativo di avviare un'istanza gce.

Parametri
ipDevice String : l'IP iniziale dell'istanza GCE in cui eseguire AVD, null se non applicabile

attributes MultiMap : attributi associati alla chiamata corrente, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM

ritorna
GceAvdInfo un GceAvdInfo che descrive l'istanza GCE. Potrebbe essere un'istanza BOOT_FAIL.

Tiri
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Tentativo di avviare l'istanza gce di più dispositivi con Oxygen.

Parametri
buildInfos : ERROR(/List ) ERROR(/List )

ritorna
a ERROR(/List ) ERROR(/List ) che descrive il GCE Avd Info.

Tiri
TargetSetupError

Metodi protetti

buildGceCmd

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

Compila e restituisci il comando per avviare GCE. Esposto per test.

Parametri
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

ritorna

buildShutdownCommand

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

Parametri
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

ritorna

estrarreInstanceName

protected String extractInstanceName (String bootupLogs)

Recupera il nome dell'istanza dai log di avvio di gce. Cerca il 'nome': 'gce- ' pattern per estrarne il nome. Estraiamo dai registri anziché dal file dei risultati perché in caso di errore di avvio di gce, il nome dell'istanza tentata non verrà visualizzato in json.

Parametri
bootupLogs String

ritorna
String