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

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)

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

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Construtores públicos

GceManager

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

Diretor

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.

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.

Lança
IOException

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.

Lança
IOException

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.

Devoluções
CommandResult CommandResult contendo o resultado da execução.

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.

Lança
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Devoluções
GceAvdInfo

Lança
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 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.

Lança
com.android.tradefed.targetprep.TargetSetupError
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 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.

Lança
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Este método está obsoleto.
Remova isto depois que o branch master for atualizado.

Parâmetros
buildInfos

Devoluções

Lança
TargetSetupError

startMultiDevicesGce

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

Tente iniciar uma instância gce de vários dispositivos com Oxygen.

Parâmetros
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : atributos associados à invocação atual

Devoluções
um ERROR(/List ) ERROR(/List ) descrevendo o GCE Avd Info.

Lança
TargetSetupError

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

Devoluções

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

Devoluções

extractInstanceName

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

Devoluções
String