Gestore Gce

public class GceManager
extends Object

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

---

Assistente che gestisce le chiamate GCE per l'avvio/l'interruzione e la raccolta dei 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) Ctor
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) Questo costruttore è deprecato. Se utilizzi altri costruttori, lo manteniamo temporaneamente per garantire la compatibilità con le versioni precedenti.
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost) Ctor, variante che può essere utilizzata per fornire il nome istanza GCE da utilizzare direttamente.

Metodi pubblici
static boolean	AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured) Esecuzione Acloud effettiva per arrestare 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 attuale del log 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 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) 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) Eseguire il comando remoto tramite SSH su un'istanza.
boolean	shutdownGce() Arresta l'istanza di 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 Ossigeno.
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 Ossigeno.
	startMultiDevicesGce( buildInfos) Questo metodo è deprecato. Rimuovila dopo l'aggiornamento del ramo master.
	startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes) Tentativo di avviare l'istanza GCE di più dispositivi con Ossigeno.

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 istanza dai log di avvio di GKE.

Campi

Chiave GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Chiave GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Chiave GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

CHIAVE_IP_ GCE_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Costruttori pubblici

Gestore Gce

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

Ctor

Parametri
deviceDesc	DeviceDescriptor: il valore DeviceDescriptor che verrà associato al dispositivo GCE.
deviceOptions	TestDeviceOptions: un elemento TestDeviceOptions associato al dispositivo.
buildInfo	IBuildInfo: un elemento IBuildInfo che descrive l'inizio della build di GCE.

Gestore Gce

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

Questo costruttore è deprecato.
Se utilizzi altri costruttori, lo manteniamo temporaneamente per garantire la 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, variante che può essere utilizzata per fornire il nome istanza GCE da utilizzare direttamente.

Parametri
deviceDesc	DeviceDescriptor: il valore DeviceDescriptor che verrà associato al dispositivo GCE.
deviceOptions	TestDeviceOptions: una TestDeviceOptions associata al dispositivo
buildInfo	IBuildInfo: un elemento IBuildInfo che descrive l'inizio della build di GCE.
gceInstanceName	String: il nome dell'istanza da utilizzare.
gceHost	String: il nome host o l'indirizzo IP dell'istanza da utilizzare.

Metodi pubblici

Arresto

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

Esecuzione Acloud effettiva per arrestare il dispositivo virtuale.

Parametri
options	TestDeviceOptions: TestDeviceOptions per le opzioni Acloud
runUtil	IRunUtil: il IRunUtil per eseguire Acloud
instanceName	String: l'istanza da arrestare.
hostname	String: nome host dell'istanza, utilizzato solo per le seppie all'ossigeno.
isIpPreconfigured	boolean: indica se la durata di visualizzazione media è stata creata su un dispositivo remoto con IP preconfigurato

Ritorni
boolean	True in caso di esito positivo

pulizia

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 valore 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 l'esecuzione dei comandi.

Ritorni
File	Un file che rimanda alla segnalazione di bug ZIP o nullo se si è verificato un problema.

Lanci
	Eccezione IO

getInstanceSerialLog

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

Legge il contenuto attuale del log seriale dell'istanza Gce Avd.

Parametri
infos	GceAvdInfo: il valore 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 l'esecuzione dei comandi.

Ritorni
String	L'output del log seriale o nullo in caso di problemi.

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 dell'adb nell'istanza virtuale nidificata.

Parametri
gceAvd	GceAvdInfo: il valore 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 l'esecuzione dei comandi.

Ritorni
File	Un file che rimanda alla segnalazione di bug ZIP o nullo se si è verificato un problema.

Lanci
	Eccezione IO

Directory log

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

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

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

Parametri
logger	ITestLogger: ITestLogger dove registrare il file.
gceAvd	GceAvdInfo: il valore 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 l'esecuzione dei comandi.
remoteFilePath	String: il percorso remoto in cui trovare il file.
type	LogDataType: LogDataType del file registrato.

Ritorni
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 dove registrare il file.
gceAvd	GceAvdInfo: il valore 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 l'esecuzione dei comandi.
remoteFilePath	String: il percorso remoto in cui trovare il file.
type	LogDataType: LogDataType del file registrato.
baseName	String: il nome di base da utilizzare per registrare il file. Se il valore è null, verrà utilizzato il nome effettivo del file.

Ritorni
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: il valore GceAvdInfo che descrive l'istanza.
logger	ITestLogger: il ITestLogger dove registrare il log seriale.

RemoteSshCommandExecution

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

Eseguire il comando remoto tramite SSH su un'istanza.

Parametri
gceAvd	GceAvdInfo: il valore 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 l'esecuzione dei comandi.
timeoutMs	long: il timeout in millisecondi per il comando. 0 significa nessun timeout.
command	String: il comando remoto da eseguire.

Ritorni
CommandResult	CommandResult contenente il risultato dell'esecuzione.

chiusuraGce

public boolean shutdownGce ()

Arresta l'istanza di Gce associata a startGce().

Ritorni
boolean	restituisce true se la chiusura di gce è stata richiesta 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 Ossigeno.

Parametri
ipDevice	String: l'IP iniziale dell'istanza GCE in cui eseguire la durata di visualizzazione media, null se non applicabile
user	String: l'utente host che esegue la durata di visualizzazione media, null se non applicabile
offset	Integer: l'offset numerico di dispositivo della durata di visualizzazione media nell'host, null se non applicabile
attributes	MultiMap: attributi associati alla chiamata attuale, utilizzati per passare informazioni applicabili all'istanza GCE da aggiungere come metadati VM
logger	ITestLogger: ITestLogger dove registrare i log di avvio del dispositivo.

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

Lanci
	com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

StartGce

public GceAvdInfo startGce ()

Ritorni
GceAvdInfo

Lanci
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 la durata di visualizzazione media, null se non applicabile
attributes	MultiMap: attributi associati alla chiamata attuale, utilizzati per passare informazioni applicabili all'istanza GCE da aggiungere come metadati VM

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

Lanci
	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 Ossigeno.

Parametri
ipDevice	String: l'IP iniziale dell'istanza GCE in cui eseguire la durata di visualizzazione media, null se non applicabile
user	String: l'utente host che esegue la durata di visualizzazione media, null se non applicabile
offset	Integer: l'offset numerico di dispositivo della durata di visualizzazione media nell'host, null se non applicabile
attributes	MultiMap: attributi associati alla chiamata attuale, utilizzati per passare informazioni applicabili all'istanza GCE da aggiungere come metadati VM

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

Lanci
	com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Questo metodo è deprecato.
Rimuovi questa opzione dopo l'aggiornamento del ramo master.

Parametri
buildInfos

Ritorni

Lanci
TargetSetupError

startMultiDevicesGce

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

Tentativo di avviare l'istanza GCE di più dispositivi con Ossigeno.

Parametri
buildInfos	: ERROR(/List)
attributes	MultiMap: attributi associati alla chiamata corrente

Ritorni
	un ERROR(/List) che descrive le informazioni Avd di GCE.

Lanci
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. Esposizione per i test.

Parametri
reportFile	File
b	IBuildInfo
ipDevice	String
user	String
offset	Integer
attributes	MultiMap

Ritorni

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

Ritorni

estraiNomeIstanza

protected String extractInstanceName (String bootupLogs)

Recupera il nome istanza dai log di avvio di GKE. Cerca il pattern "name": "gce-" per estrarne il nome. Estraiamo dai log anziché dal file dei risultati perché in caso di errore di avvio di GKE, il nome dell'istanza che hai tentato di eseguire non verrà visualizzato in json.

Parametri
bootupLogs	String

Ritorni
String