Gestore Gce

public class GceManager
extends Object

java.lang.Oggetto
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 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)

L'effettivo funzionamento di Acloud per arrestare 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'output 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, ITestLogger logger)

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.

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

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

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Questo metodo è deprecato. Rimuovilo dopo l'aggiornamento del ramo principale.

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

Tentativo di avviare un'istanza gce multidispositivo con Oxygen.

Metodi protetti

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

Crea 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_NOMEHOST_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

Gestore Gce

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

rettore

Parametri
deviceDesc DeviceDescriptor : il DeviceDescriptor che verrà associato al dispositivo GCE.

deviceOptions TestDeviceOptions : un TestDeviceOptions associato al dispositivo.

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

Gestore Gce

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

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

Parametri
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

Gestore Gce

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 : il DeviceDescriptor che verrà 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

AcloudShutdown

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

L'effettivo funzionamento di Acloud per arrestare il dispositivo virtuale.

Parametri
options TestDeviceOptions : TestDeviceOptions per le opzioni Acloud

runUtil IRunUtil : IRunUtil per eseguire Acloud

instanceName String : l'istanza da arrestare.

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

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

ritorna
boolean Vero in caso di successo

ripulire

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 : il 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 i comandi.

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

Getta
IOException

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 chiave json dell'account di servizio.

runUtil IRunUtil : un IRunUtil per eseguire i 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 : il GceAvdInfo che descrive il dispositivo.

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

runUtil IRunUtil : un IRunUtil per eseguire i comandi.

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

Getta
IOException

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 : L' ITestLogger dove registrare il file.

gceAvd GceAvdInfo : il GceAvdInfo che descrive il dispositivo.

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

runUtil IRunUtil : un IRunUtil per eseguire i comandi.

remoteFilePath String : Il percorso remoto dove 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 : L' ITestLogger dove registrare il file.

gceAvd GceAvdInfo : il 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 i comandi.

remoteFilePath String : Il percorso remoto dove 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 effettivo del file.

ritorna
boolean se il file è stato registrato correttamente.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

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

Parametri
infos GceAvdInfo : GceAvdInfo che descrive l'istanza.

logger ITestLogger : L' ITestLogger dove 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 : il GceAvdInfo che descrive il dispositivo.

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

runUtil IRunUtil : un IRunUtil per eseguire i 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, 
                ITestLogger logger)

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 del dispositivo dell'AVD nell'host, null se non applicabile

attributes MultiMap : attributi associati all'invocazione corrente, utilizzati per passare le informazioni applicabili all'istanza GCE da aggiungere come metadati VM

logger ITestLogger : L' ITestLogger in cui registrare i log di avvio del dispositivo.

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

Getta
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

ritorna
GceAvdInfo

Getta
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 all'invocazione corrente, utilizzati per passare le informazioni applicabili all'istanza GCE da aggiungere come metadati VM

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

Getta
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

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 del dispositivo dell'AVD nell'host, null se non applicabile

attributes MultiMap : attributi associati all'invocazione corrente, utilizzati per passare le informazioni applicabili all'istanza GCE da aggiungere come metadati VM

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

Getta
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Questo metodo è deprecato.
Rimuovilo dopo l'aggiornamento del ramo principale.

Parametri
buildInfos

ritorna

Getta
TargetSetupError

startMultiDevicesGce

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

Tentativo di avviare un'istanza gce multidispositivo con Oxygen.

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

attributes MultiMap : attributi associati all'invocazione corrente

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

Getta
TargetSetupError

Metodi protetti

buildGceCmd

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

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

Parametri
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

ritorna

comando buildShutdown

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

estrarreNomeIstanza

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 log 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