GceManager

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)

Direttore

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

Questo costruttore è deprecato. Utilizza altri costruttori, lo conserviamo 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'effettiva esecuzione di Acloud per spegnere il dispositivo virtuale.

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

Ottieni una segnalazione di bug dal dispositivo utilizzando ssh per evitare potenziali problemi 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)

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

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

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

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

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)

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

GceManager

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

Direttore

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.

GceManager

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

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

Parametri
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

AcloudSpegnimento

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

L'effettiva esecuzione di Acloud per spegnere 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 le seppie Oxygen.

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 una segnalazione di bug dal dispositivo utilizzando ssh per evitare potenziali problemi 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 comandi.

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

Lancia
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 di avd

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

runUtil IRunUtil : un IRunUtil per eseguire comandi.

ritorna
String L'output del log 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 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.

Lancia
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 : ITestLogger in cui 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 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 : 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 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 file effettivo.

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 : 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 : 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 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 vero 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)

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

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

logger ITestLogger : ITestLogger in cui registrare i registri di avvio del dispositivo.

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

Lancia
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

ritorna
GceAvdInfo

Lancia
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 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.

Lancia
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

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

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

attributes MultiMap : attributi associati all'invocazione 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.

Lancia
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

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

Parametri
buildInfos

ritorna

Lancia
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
un ERROR(/List ) ERROR(/List ) che descrive il GCE Avd Info.

Lancia
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

extractInstanceName

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 invece che 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