GceManager
public
class
GceManager
extends Object
java.lang.Object
|
↳ |
com.android.tradefed.device.cloud.GceManager
|
Helper che gestisce le chiamate a GCE per avviare/arrestare e raccogliere i log da GCE.
Riepilogo
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, una variante 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)
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
|
logAndDeleteFile(File tempFile, String dataName, ITestLogger logger)
|
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 GCE associata al 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)
Prova ad avviare un'istanza GCE.
|
GceAvdInfo
|
startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)
Prova ad avviare un'istanza GCE con Acloud o Oxygen.
|
|
startMultiDevicesGce( buildInfos)
Questo metodo è deprecato.
Rimuovila dopo l'aggiornamento del ramo master.
|
|
startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)
Prova ad avviare un'istanza GCE con più dispositivi con Oxygen.
|
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
public static final String GCE_IP_PRECONFIGURED_KEY
Costruttori pubblici
GceManager
public GceManager (DeviceDescriptor deviceDesc,
TestDeviceOptions deviceOptions,
IBuildInfo buildInfo,
testResourceBuildInfos)
Questo costruttore è deprecato.
Utilizza altri costruttori. Manteniamo questa opzione temporaneamente per la 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, variante che può essere utilizzata per fornire il nome dell'istanza GCE da utilizzare direttamente.
Parametri |
deviceDesc |
DeviceDescriptor : il valore DeviceDescriptor che verrà associato al dispositivo GCE. |
deviceOptions |
TestDeviceOptions : un TestDeviceOptions associato 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
AcloudShutdown
public static boolean AcloudShutdown (TestDeviceOptions options,
IRunUtil runUtil,
String instanceName,
String hostname,
boolean isIpPreconfigured)
Esecuzione effettiva di Acloud per spegnere il dispositivo virtuale.
Parametri |
options |
TestDeviceOptions : il 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 Oxygen cuttlefish. |
isIpPreconfigured |
boolean : indica se l'AVD è stato creato su un dispositivo remoto con IP preconfigurato |
Ritorni |
boolean |
Vero se l'operazione è riuscita |
pulizia
public void cleanUp ()
getBugreportzWithSsh
public static File getBugreportzWithSsh (GceAvdInfo gceAvd,
TestDeviceOptions options,
IRunUtil runUtil)
Ricevi un bugreportz 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 eseguire comandi. |
Ritorni |
File |
Un file che rimanda 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 attuale del log seriale dell'istanza Gce Avd.
Parametri |
infos |
GceAvdInfo : il GceAvdInfo che descrive l'istanza. |
avdConfigFile |
File : il file di configurazione dell'avd |
jsonKeyFile |
File : il file della chiave JSON dell'account di servizio. |
runUtil |
IRunUtil : un IRunUtil per eseguire comandi. |
Ritorni |
String |
L'output del log seriale o null se si verifica un problema. |
getNestedDeviceSshBugreportz
public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd,
TestDeviceOptions options,
IRunUtil runUtil)
Ricevi un report di bug tramite SSH per un'istanza nidificata. Questo richiede la richiesta di 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 eseguire comandi. |
Ritorni |
File |
Un file che rimanda alla segnalazione di bug ZIP o null se si è verificato un problema. |
logAndDeleteFile
public static void logAndDeleteFile (File tempFile,
String dataName,
ITestLogger logger)
Parametri |
tempFile |
File |
dataName |
String |
logger |
ITestLogger |
logDirectory
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 : il ITestLogger in cui registrare il file. |
gceAvd |
GceAvdInfo : i GceAvdInfo che descrivono 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. |
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 : il ITestLogger in cui registrare il file. |
gceAvd |
GceAvdInfo : i GceAvdInfo che descrivono 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 : il LogDataType del file registrato. |
baseName |
String : il nome di base da utilizzare per registrare il file. Se è nullo, verrà utilizzato il nome del file reale. |
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 GceAvdInfo che descrive l'istanza. |
logger |
ITestLogger : il ITestLogger in cui registrare il log di serie. |
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 : i GceAvdInfo che descrivono 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. |
chiusuraGce
public boolean shutdownGce ()
Arresta l'istanza GCE associata al startGce()
.
Ritorni |
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 Ossigeno.
Parametri |
ipDevice |
String : l'indirizzo IP iniziale dell'istanza GCE in cui eseguire l'AVD, null se non applicabile |
user |
String : l'utente che esegue l'host dell'AVD, 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 all'attuale chiamata, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM |
logger |
ITestLogger : il ITestLogger in cui registrare i log di avvio del dispositivo. |
StartGce
public GceAvdInfo startGce (String ipDevice,
MultiMap<String, String> attributes)
Prova ad avviare un'istanza GCE.
Parametri |
ipDevice |
String : l'indirizzo IP iniziale dell'istanza GCE in cui eseguire l'AVD, null se non applicabile |
attributes |
MultiMap : attributi associati all'attuale chiamata, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM |
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'indirizzo IP iniziale dell'istanza GCE in cui eseguire l'AVD, null se non applicabile |
user |
String : l'utente che esegue l'host dell'AVD, 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 all'attuale chiamata, utilizzati per trasmettere le informazioni applicabili all'istanza GCE da aggiungere come metadati della VM |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Questo metodo è deprecato.
Rimuovi questo elemento dopo l'aggiornamento del ramo principale.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Prova ad avviare un'istanza GCE con più dispositivi con Oxygen.
Parametri |
buildInfos |
: ERROR(/List) |
attributes |
MultiMap : attributi associati all'invocazione corrente |
Ritorni |
|
un ERROR(/List) che descrive le informazioni Avd di GCE. |
Metodi protetti
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 |
protected String extractInstanceName (String bootupLogs)
Recupera il nome dell'istanza dai log di avvio GCE. 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 |