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

Costruttori pubblici
GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo) attore
GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) Questo costruttore è deprecato. Usa 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) Esecuzione effettiva di Acloud 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 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 di Gce Avd.
static File	getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Ottieni un bugreport tramite ssh per un'istanza nidificata.
static void	logNestedRemoteFile (ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type) Recupera un file remoto da un'istanza nidificata e registralo.
static void	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) Registrare 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 () Shutdown l'istanza Gce associato al startGce() .
GceAvdInfo	startGce ()
GceAvdInfo	startGce (String ipDevice, MultiMap<String, String> attributes) Tentativo di avviare un'istanza gce

Metodi protetti
	buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, MultiMap<String, String> attributes) Compila e restituisci il comando per avviare GCE.
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

Costruttori pubblici

GceManager

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

attore

Parametri
deviceDesc	DeviceDescriptor : Il DeviceDescriptor che sarà associato con il dispositivo GCE.
deviceOptions	TestDeviceOptions : A TestDeviceOptions associate al dispositivo.
buildInfo	IBuildInfo : Un IBuildInfo che descrive la costruzione GCE per iniziare.

GceManager

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

Questo costruttore è deprecato.
Usa 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 sarà associato con il dispositivo GCE.
deviceOptions	TestDeviceOptions : A TestDeviceOptions associati al dispositivo
buildInfo	IBuildInfo : Un IBuildInfo che descrive la costruzione GCE per iniziare.
gceInstanceName	String : Il nome di istanza da utilizzare.
gceHost	String : Il nome host o IP dell'istanza per l'uso.

Metodi pubblici

AcloudShutdown

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

Esecuzione effettiva di Acloud per spegnere il dispositivo virtuale.

Parametri
options	TestDeviceOptions : I TestDeviceOptions per le opzioni Acloud
runUtil	IRunUtil : IRunUtil per eseguire Acloud
instanceName	String : L'istanza di arresto.
hostname	String : hostname dell'istanza, utilizzato solo per le seppie di ossigeno.

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 potenziali problemi di connessione adb.

Parametri
gceAvd	GceAvdInfo : Il GceAvdInfo che descrivono il dispositivo.
options	TestDeviceOptions : a TestDeviceOptions che descrivono le opzioni del dispositivo da utilizzare per il dispositivo GCE.
runUtil	IRunUtil : un IRunUtil di eseguire comandi.

ritorna
File	Un file che punta al bugreport 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 di Gce Avd.

Parametri
infos	GceAvdInfo : Il GceAvdInfo descrive l'istanza.
avdConfigFile	File : il file di configurazione avd
jsonKeyFile	File : il file di chiave JSON account di servizio.
runUtil	IRunUtil : un IRunUtil di 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 un bugreport tramite ssh per un'istanza nidificata. Ciò richiede la richiesta dell'adb nell'istanza virtuale nidificata.

Parametri
gceAvd	GceAvdInfo : Il GceAvdInfo che descrivono il dispositivo.
options	TestDeviceOptions : a TestDeviceOptions che descrivono le opzioni del dispositivo da utilizzare per il dispositivo GCE.
runUtil	IRunUtil : un IRunUtil di eseguire comandi.

ritorna
File	Un file che punta al bugreport zip o null se si è verificato un problema.

logNestedRemoteFile

public static void 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 dove per accedere al file.
gceAvd	GceAvdInfo : Il GceAvdInfo che descrivono il dispositivo.
options	TestDeviceOptions : a TestDeviceOptions che descrivono le opzioni del dispositivo da utilizzare per il dispositivo GCE.
runUtil	IRunUtil : un IRunUtil di eseguire comandi.
remoteFilePath	String : Il percorso remoto dove trovare il file.
type	LogDataType : la LogDataType del file Logged.

logNestedRemoteFile

public static void 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 dove per accedere al file.
gceAvd	GceAvdInfo : Il GceAvdInfo che descrivono il dispositivo.
options	TestDeviceOptions : a TestDeviceOptions che descrivono le opzioni del dispositivo da utilizzare per il dispositivo GCE.
runUtil	IRunUtil : un IRunUtil di eseguire comandi.
remoteFilePath	String : Il percorso remoto dove trovare il file.
type	LogDataType : la LogDataType del file Logged.
baseName	String : Il nome di base da utilizzare per accedere al file. Se null verrà utilizzato il nome del file effettivo.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

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

Parametri
infos	GceAvdInfo : Il GceAvdInfo descrive l'istanza.
logger	ITestLogger : 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 descrivono il dispositivo.
options	TestDeviceOptions : a TestDeviceOptions che descrivono le opzioni del dispositivo da utilizzare per il dispositivo GCE.
runUtil	IRunUtil : un IRunUtil di eseguire comandi.
timeoutMs	long : il timeout in millisecondi per il comando. 0 significa nessun timeout.
command	String : Il comando remoto di eseguire.

ritorna
CommandResult	CommandResult contenente il risultato dell'esecuzione.

spegnimentoGce

public boolean shutdownGce ()

Shutdown l'istanza Gce associato al startGce() .

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

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 a correre AVD in, null se non applicabile
attributes	MultiMap : attributi associati invocazione corrente, utilizzato per passare informazioni applicabili verso l'istanza GCE essere aggiunto come metadati VM

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

tiri
TargetSetupError

Metodi protetti

buildGceCmd

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

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

Parametri
reportFile	File
b	IBuildInfo
ipDevice	String
attributes	MultiMap

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 di risultato perché in caso di errore di avvio di gce, il nome dell'istanza tentata non verrà visualizzato in json.

Parametri
bootupLogs	String

ritorna
String