GceManager
public class GceManager
extends Object
java.lang.Object | |
↳ | com.android.tradefed.device.cloud.GceManager |
Helper que gerencia as chamadas do GCE para iniciar/parar e coletar logs do GCE.
Resumo
Campos | |
---|---|
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
|
Construtores públicos | |
---|---|
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo) Ctor | |
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) Este construtor está obsoleto. Use outros construtores, mantemos isso temporariamente para compatibilidade com versões anteriores. | |
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost) Ctor, variação que pode ser usada para fornecer o nome da instância GCE para usar diretamente. |
Métodos públicos | |
---|---|
static boolean | AcloudShutdown ( TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured) A execução real do Acloud para desligar o dispositivo virtual. |
void | cleanUp () |
static File | getBugreportzWithSsh ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Obtenha um relatório de bug do dispositivo usando ssh para evitar qualquer problema potencial de conexão adb. |
static String | getInstanceSerialLog ( GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil) Lê o conteúdo atual do log serial da instância Gce Avd. |
static File | getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Obtenha um relatório de bug via ssh para uma instância aninhada. |
static boolean | logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type) Busque um arquivo remoto de uma instância aninhada e registre-o. |
static boolean | logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName) Busque um arquivo remoto de uma instância aninhada e registre-o. |
void | logSerialOutput ( GceAvdInfo infos, ITestLogger logger) Registre a saída serial de um dispositivo descrito por |
static CommandResult | remoteSshCommandExecution ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command) Execute o comando remoto via ssh em uma instância. |
boolean | shutdownGce () Encerre a instância Gce associada ao |
GceAvdInfo | startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes, ITestLogger logger) Tente iniciar uma instância gce com Acloud ou Oxygen. |
GceAvdInfo | startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) Tente iniciar uma instância gce com Acloud ou Oxygen. |
GceAvdInfo | startGce () |
GceAvdInfo | startGce (String ipDevice, MultiMap <String, String> attributes) Tente iniciar uma instância gce. |
startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos) Tente iniciar a instância gce de vários dispositivos com Oxygen. |
Métodos protegidos | |
---|---|
buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) Crie e retorne o comando para iniciar o GCE. | |
static | buildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured) |
String | extractInstanceName (String bootupLogs) Recupere o nome da instância dos logs de inicialização gce. |
Campos
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
Construtores públicos
GceManager
public GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)
Ctor
Parâmetros | |
---|---|
deviceDesc | DeviceDescriptor : o DeviceDescriptor que será associado ao dispositivo GCE. |
deviceOptions | TestDeviceOptions : um TestDeviceOptions associado ao dispositivo. |
buildInfo | IBuildInfo : Um IBuildInfo descrevendo a compilação gce para iniciar. |
GceManager
public GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo,testResourceBuildInfos)
Este construtor está obsoleto.
Use outros construtores, mantemos isso temporariamente para compatibilidade com versões anteriores.
Parâmetros | |
---|---|
deviceDesc | DeviceDescriptor |
deviceOptions | TestDeviceOptions |
buildInfo | IBuildInfo |
testResourceBuildInfos |
GceManager
public GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)
Ctor, variação que pode ser usada para fornecer o nome da instância GCE para usar diretamente.
Parâmetros | |
---|---|
deviceDesc | DeviceDescriptor : o DeviceDescriptor que será associado ao dispositivo GCE. |
deviceOptions | TestDeviceOptions : Um TestDeviceOptions associado ao dispositivo |
buildInfo | IBuildInfo : Um IBuildInfo descrevendo a compilação gce para iniciar. |
gceInstanceName | String : o nome da instância a ser usada. |
gceHost | String : O nome do host ou ip da instância a ser usada. |
Métodos públicos
AcloudShutdownComment
public static boolean AcloudShutdown (TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)
A execução real do Acloud para desligar o dispositivo virtual.
Parâmetros | |
---|---|
options | TestDeviceOptions : O TestDeviceOptions para as opções Acloud |
runUtil | IRunUtil : O IRunUtil para executar o Acloud |
instanceName | String : a instância a ser encerrada. |
hostname | String : nome do host da instância, usado apenas para Oxygen choco. |
isIpPreconfigured | boolean : se o AVD foi criado em um dispositivo remoto com IP pré-configurado |
devoluções | |
---|---|
boolean | Verdadeiro se for bem-sucedido |
limpar
public void cleanUp ()
getBugreportzWithSsh
public static File getBugreportzWithSsh (GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)
Obtenha um relatório de bug do dispositivo usando ssh para evitar qualquer problema potencial de conexão adb.
Parâmetros | |
---|---|
gceAvd | GceAvdInfo : O GceAvdInfo que descreve o dispositivo. |
options | TestDeviceOptions : um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo GCE. |
runUtil | IRunUtil : um IRunUtil para executar comandos. |
devoluções | |
---|---|
File | Um arquivo apontando para o relatório de bug do zip ou nulo se ocorreu um problema. |
getInstanceSerialLog
public static String getInstanceSerialLog (GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)
Lê o conteúdo atual do log serial da instância Gce Avd.
Parâmetros | |
---|---|
infos | GceAvdInfo : O GceAvdInfo que descreve a instância. |
avdConfigFile | File : o arquivo de configuração avd |
jsonKeyFile | File : o arquivo de chave json da conta de serviço. |
runUtil | IRunUtil : um IRunUtil para executar comandos. |
devoluções | |
---|---|
String | A saída do log serial ou null se algo der errado. |
getNestedDeviceSshBugreportz
public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)
Obtenha um relatório de bug via ssh para uma instância aninhada. Isso requer a solicitação do adb na instância virtual aninhada.
Parâmetros | |
---|---|
gceAvd | GceAvdInfo : O GceAvdInfo que descreve o dispositivo. |
options | TestDeviceOptions : um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo GCE. |
runUtil | IRunUtil : um IRunUtil para executar comandos. |
devoluções | |
---|---|
File | Um arquivo apontando para o relatório de bug do zip ou nulo se ocorreu um problema. |
logNestedRemoteFile
public static boolean logNestedRemoteFile (ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type)
Busque um arquivo remoto de uma instância aninhada e registre-o.
Parâmetros | |
---|---|
logger | ITestLogger : O ITestLogger onde registrar o arquivo. |
gceAvd | GceAvdInfo : O GceAvdInfo que descreve o dispositivo. |
options | TestDeviceOptions : um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo GCE. |
runUtil | IRunUtil : um IRunUtil para executar comandos. |
remoteFilePath | String : O caminho remoto onde encontrar o arquivo. |
type | LogDataType : o LogDataType do arquivo registrado. |
devoluções | |
---|---|
boolean | se o arquivo foi registrado com sucesso. |
logNestedRemoteFile
public static boolean logNestedRemoteFile (ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)
Busque um arquivo remoto de uma instância aninhada e registre-o.
Parâmetros | |
---|---|
logger | ITestLogger : O ITestLogger onde registrar o arquivo. |
gceAvd | GceAvdInfo : O GceAvdInfo que descreve o dispositivo. |
options | TestDeviceOptions : um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo GCE. |
runUtil | IRunUtil : um IRunUtil para executar comandos. |
remoteFilePath | String : O caminho remoto onde encontrar o arquivo. |
type | LogDataType : o LogDataType do arquivo registrado. |
baseName | String : O nome base a ser usado para registrar o arquivo. Se nulo, o nome do arquivo real será usado. |
devoluções | |
---|---|
boolean | se o arquivo foi registrado com sucesso. |
LogSerialOutput
public void logSerialOutput (GceAvdInfo infos, ITestLogger logger)
Registre a saída serial de um dispositivo descrito por GceAvdInfo
.
Parâmetros | |
---|---|
infos | GceAvdInfo : O GceAvdInfo que descreve a instância. |
logger | ITestLogger : O ITestLogger onde registrar o log serial. |
remoteSshCommandExecution
public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)
Execute o comando remoto via ssh em uma instância.
Parâmetros | |
---|---|
gceAvd | GceAvdInfo : O GceAvdInfo que descreve o dispositivo. |
options | TestDeviceOptions : um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo GCE. |
runUtil | IRunUtil : um IRunUtil para executar comandos. |
timeoutMs | long : O tempo limite em milissegundos para o comando. 0 significa que não há tempo limite. |
command | String : O comando remoto a ser executado. |
devoluções | |
---|---|
CommandResult | CommandResult contendo o resultado da execução. |
shutdownGce
public boolean shutdownGce ()
Encerre a instância Gce associada ao startGce()
.
devoluções | |
---|---|
boolean | retorna true se gce shutdown foi solicitado como não bloqueante. |
startGce
public GceAvdInfo startGce (String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)
Tente iniciar uma instância gce com Acloud ou Oxygen.
Parâmetros | |
---|---|
ipDevice | String : o IP inicial da instância do GCE para executar o AVD, null se não for aplicável |
user | String : o host executando o usuário do AVD, null se não for aplicável |
offset | Integer : o deslocamento numérico do dispositivo do AVD no host, null se não for aplicável |
attributes | MultiMap : atributos associados à invocação atual, usados para passar informações aplicáveis para a instância GCE a serem adicionadas como metadados da VM |
logger | ITestLogger : O ITestLogger onde registrar os logs de inicialização do dispositivo. |
devoluções | |
---|---|
GceAvdInfo | um GceAvdInfo descrevendo a instância GCE. Pode ser uma instância BOOT_FAIL. |
lances | |
---|---|
TargetSetupError |
startGce
public GceAvdInfo startGce (String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)
Tente iniciar uma instância gce com Acloud ou Oxygen.
Parâmetros | |
---|---|
ipDevice | String : o IP inicial da instância do GCE para executar o AVD, null se não for aplicável |
user | String : o host executando o usuário do AVD, null se não for aplicável |
offset | Integer : o deslocamento numérico do dispositivo do AVD no host, null se não for aplicável |
attributes | MultiMap : atributos associados à invocação atual, usados para passar informações aplicáveis para a instância GCE a serem adicionadas como metadados da VM |
devoluções | |
---|---|
GceAvdInfo | um GceAvdInfo descrevendo a instância GCE. Pode ser uma instância BOOT_FAIL. |
lances | |
---|---|
TargetSetupError |
startGce
public GceAvdInfo startGce (String ipDevice, MultiMap<String, String> attributes)
Tente iniciar uma instância gce.
Parâmetros | |
---|---|
ipDevice | String : o IP inicial da instância do GCE para executar o AVD, null se não for aplicável |
attributes | MultiMap : atributos associados à invocação atual, usados para passar informações aplicáveis para a instância GCE a serem adicionadas como metadados da VM |
devoluções | |
---|---|
GceAvdInfo | um GceAvdInfo descrevendo a instância GCE. Pode ser uma instância BOOT_FAIL. |
lances | |
---|---|
TargetSetupError |
startMultiDevicesGce
publicstartMultiDevicesGce ( buildInfos)
Tente iniciar a instância gce de vários dispositivos com Oxygen.
Parâmetros | |
---|---|
buildInfos | ERROR(/List ) ERROR(/List ) |
devoluções | |
---|---|
um ERROR(/List ) ERROR(/List ) descrevendo o GCE Avd Info. |
lances | |
---|---|
TargetSetupError |
Métodos protegidos
buildGceCmd
protectedbuildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)
Crie e retorne o comando para iniciar o GCE. Exposto para testes.
Parâmetros | |
---|---|
reportFile | File |
b | IBuildInfo |
ipDevice | String |
user | String |
offset | Integer |
attributes | MultiMap |
devoluções | |
---|---|
buildShutdownCommand
protected staticbuildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)
Parâmetros | |
---|---|
config | File |
options | TestDeviceOptions |
instanceName | String |
hostname | String |
isIpPreconfigured | boolean |
devoluções | |
---|---|
extractInstanceName
protected String extractInstanceName (String bootupLogs)
Recupere o nome da instância dos logs de inicialização gce. Procure o 'nome': 'gce-
Parâmetros | |
---|---|
bootupLogs | String |
devoluções | |
---|---|
String |