GceManager
public class GceManager
extends Object
java.lang.Object |
↳ | com.android.tradefed.device.cloud.GceManager |
Auxiliar que gerencia as chamadas do GCE para iniciar/parar e coletar logs do GCE.
Resumo
Construtores públicos |
---|
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo) Diretor |
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 do GCE para uso direto. |
Métodos públicos |
---|
static boolean | AcloudShutdown ( TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured) Acloud real é executada 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 GceAvdInfo . |
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 startGce() . |
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 () |
GceAvdInfo | startGce (String ipDevice, MultiMap <String, String> attributes) Tente iniciar uma instância gce. |
GceAvdInfo | startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) Tente iniciar uma instância gce com Acloud ou Oxygen. |
| startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos) Este método está obsoleto. Remova isto depois que o branch master for atualizado. |
| startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes) startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes) Tente iniciar uma 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 do 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
public static final String GCE_IP_PRECONFIGURED_KEY
Construtores públicos
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 do GCE para uso direto.
Parâmetros |
---|
deviceDesc | DeviceDescriptor : O DeviceDescriptor que será associado ao dispositivo GCE. |
deviceOptions | TestDeviceOptions : um TestDeviceOptions associado ao dispositivo |
buildInfo | IBuildInfo : Um IBuildInfo que descreve a compilação do 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
AcloudShutdown
public static boolean AcloudShutdown (TestDeviceOptions options,
IRunUtil runUtil,
String instanceName,
String hostname,
boolean isIpPreconfigured)
Acloud real é executada 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 chocos de oxigênio. |
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 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 do 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 nula 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 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 for nulo, o nome real do arquivo 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. |
desligamentoGce
public boolean shutdownGce ()
Encerre a instância Gce associada ao startGce()
.
Devoluções |
---|
boolean | retorna verdadeiro se o desligamento do gce foi solicitado como sem bloqueio. |
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 GCE para executar o AVD, null se não for aplicável |
user | String : o host que executa o usuário do AVD, null se não for aplicável |
offset | Integer : o deslocamento do número do dispositivo do AVD no host, null se não for aplicável |
attributes | MultiMap : atributos associados à invocação atual, usados para transmitir informações aplicáveis à instância do GCE para serem adicionadas como metadados da VM |
logger | ITestLogger : O ITestLogger onde registrar os logs de inicialização do dispositivo. |
Devoluções |
---|
GceAvdInfo | um GceAvdInfo que descreve a instância do GCE. Pode ser uma instância BOOT_FAIL. |
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 GCE para executar o AVD, null se não for aplicável |
attributes | MultiMap : atributos associados à invocação atual, usados para transmitir informações aplicáveis à instância do GCE para serem adicionadas como metadados da VM |
Devoluções |
---|
GceAvdInfo | um GceAvdInfo que descreve a instância do GCE. Pode ser uma instância BOOT_FAIL. |
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 GCE para executar o AVD, null se não for aplicável |
user | String : o host que executa o usuário do AVD, null se não for aplicável |
offset | Integer : o deslocamento do número do dispositivo do AVD no host, null se não for aplicável |
attributes | MultiMap : atributos associados à invocação atual, usados para transmitir informações aplicáveis à instância do GCE para serem adicionadas como metadados da VM |
Devoluções |
---|
GceAvdInfo | um GceAvdInfo que descreve a instância do GCE. Pode ser uma instância BOOT_FAIL. |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Este método está obsoleto.
Remova isto depois que o branch master for atualizado.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Tente iniciar uma instância gce de vários dispositivos com Oxygen.
Métodos protegidos
buildGceCmd
protected buildGceCmd (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 |
buildShutdownCommand
protected static buildShutdownCommand (File config,
TestDeviceOptions options,
String instanceName,
String hostname,
boolean isIpPreconfigured)
Parâmetros |
---|
config | File |
options | TestDeviceOptions |
instanceName | String |
hostname | String |
isIpPreconfigured | boolean |
protected String extractInstanceName (String bootupLogs)
Recupere o nome da instância dos logs de inicialização do gce. Procure pelo 'nome': 'gce- 'padrão para extrair o nome dele. Extraímos dos logs em vez do arquivo de resultado porque em caso de falha na inicialização do gce, o nome da instância tentada não será exibido em json.
Parâmetros |
---|
bootupLogs | String |