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

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

Metodi protetti

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

Ctor

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

Lanci
IOException

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.

Lanci
IOException

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.

Ritorni
CommandResult CommandResult contenente il risultato dell'esecuzione.

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.

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)

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

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

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 questo elemento dopo l'aggiornamento del ramo principale.

Parametri
buildInfos

Ritorni

Lanci
TargetSetupError

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.

Lanci
TargetSetupError

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

Ritorni

extractInstanceName

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

Ritorni
String