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 registros do GCE.

Resumo

Constantes

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

Construtores públicos

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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

Esse construtor foi descontinuado. 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 diretamente o nome da instância do GCE.

Métodos públicos

static boolean AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)

Execução real do Acloud para desligar o dispositivo virtual.

void cleanUp()
static File getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)

Receba um bugreportz do dispositivo usando ssh para evitar possíveis problemas de conexão adb.

HostOrchestratorUtil getHostOrchestratorUtil()

Retorna a instância do HostOrchestratorUtil.

static String getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)

Lê o conteúdo atual do registro serial da instância do Gce Avd.

static File getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)

Receba um bugreport via SSH para uma instância aninhada.

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)

Buscar um arquivo remoto de uma instância aninhada e fazer o registro dele.

static boolean logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)

Buscar um arquivo remoto de uma instância aninhada e fazer o registro dele.

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

Desligue a instância do GCE associada ao startGce().

GceAvdInfo startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)

Tente iniciar uma instância do GCE com o Acloud ou o Oxygen.

GceAvdInfo startGce()
GceAvdInfo startGce(String ipDevice, MultiMap<String, String> attributes)

Tenta iniciar uma instância do GCE.

GceAvdInfo startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)

Tente iniciar uma instância do GCE com o Acloud ou o Oxygen.

startMultiDevicesGce( buildInfos)

Esse método foi descontinuado. Remova isso depois que a ramificação principal for atualizada.

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

Tente iniciar uma instância do GCE multidispositivo com o Oxygen.

Métodos protegidos

static buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)
String extractInstanceName(String bootupLogs)

Recupere o nome da instância dos registros de inicialização do GCE.

Constantes

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Valor da constante: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Valor da constante: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Valor da constante: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Valor da constante: "gce-ip-pre-configured"

Construtores públicos

GceManager

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

Ctor

Parâmetros
deviceDesc DeviceDescriptor: o DeviceDescriptor que será associado ao dispositivo do GCE.
deviceOptions TestDeviceOptions: um TestDeviceOptions associado ao dispositivo.
buildInfo IBuildInfo: um IBuildInfo que descreve a build do GCE a ser iniciada.

GceManager

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

Esse construtor foi descontinuado.
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 diretamente o nome da instância do GCE.

Parâmetros
deviceDesc DeviceDescriptor: o DeviceDescriptor que será associado ao dispositivo do GCE.
deviceOptions TestDeviceOptions: um TestDeviceOptions associado ao dispositivo.
buildInfo IBuildInfo: um IBuildInfo que descreve a build do GCE a ser iniciada.
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)

Execução real do Acloud para desligar o dispositivo virtual.

Parâmetros
options TestDeviceOptions: o TestDeviceOptions para as opções do Acloud.
runUtil IRunUtil: o IRunUtil para executar o Acloud
instanceName String: a instância a ser desligada.
hostname String: nome do host da instância, usado apenas para o Oxygen cuttlefish.
isIpPreconfigured boolean: se o AVD foi criado em um dispositivo remoto com IP pré-configurado.
Retorna
boolean True se for bem-sucedido

cleanUp

public void cleanUp ()

getBugreportzWithSsh

public static File getBugreportzWithSsh (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

Receba um bugreportz do dispositivo usando ssh para evitar possíveis problemas de conexão adb.

Parâmetros
gceAvd GceAvdInfo: os GceAvdInfo que descrevem o dispositivo.
options TestDeviceOptions: um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo do GCE.
runUtil IRunUtil: um IRunUtil para executar comandos.
Retorna
File Um arquivo que aponta para o relatório de bug ZIP ou nulo se ocorrer um problema.
Gera
IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Retorna a instância do HostOrchestratorUtil.

Retorna
HostOrchestratorUtil

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

Lê o conteúdo atual do registro serial da instância do 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.
Retorna
String A saída do registro serial ou nulo se algo der errado.

getNestedDeviceSshBugreportz

public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil)

Receba um bugreport via SSH para uma instância aninhada. Isso exige solicitar o adb na instância virtual aninhada.

Parâmetros
gceAvd GceAvdInfo: os GceAvdInfo que descrevem o dispositivo.
options TestDeviceOptions: um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo do GCE.
runUtil IRunUtil: um IRunUtil para executar comandos.
Retorna
File Um arquivo que aponta para o relatório de bug ZIP ou nulo se ocorrer um problema.
Gera
IOException

logAndDeleteFile

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

Parâmetros
tempFile File

dataName String

logger ITestLogger

logDirectory

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

Parâmetros
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)

Buscar um arquivo remoto de uma instância aninhada e fazer o registro dele.

Parâmetros
logger ITestLogger: o ITestLogger em que o arquivo será registrado.
gceAvd GceAvdInfo: os GceAvdInfo que descrevem o dispositivo.
options TestDeviceOptions: um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo do GCE.
runUtil IRunUtil: um IRunUtil para executar comandos.
remoteFilePath String: o caminho remoto para encontrar o arquivo.
type LogDataType: o LogDataType do arquivo registrado.
Retorna
boolean se o arquivo foi registrado corretamente.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName)

Buscar um arquivo remoto de uma instância aninhada e fazer o registro dele.

Parâmetros
logger ITestLogger: o ITestLogger em que o arquivo será registrado.
gceAvd GceAvdInfo: os GceAvdInfo que descrevem o dispositivo.
options TestDeviceOptions: um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo do GCE.
runUtil IRunUtil: um IRunUtil para executar comandos.
remoteFilePath String: o caminho remoto para 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 do arquivo real será usado.
Retorna
boolean se o arquivo foi registrado corretamente.

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 em que o registro serial será feito.

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: os GceAvdInfo que descrevem o dispositivo.
options TestDeviceOptions: um TestDeviceOptions que descreve as opções de dispositivo a serem usadas para o dispositivo do 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.
Retorna
CommandResult CommandResult contendo o resultado da execução.

shutdownGce

public boolean shutdownGce ()

Desligue a instância do GCE associada ao startGce().

Retorna
boolean Retorna "true" se o desligamento do GCE foi solicitado como não bloqueador.

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes, 
                ITestLogger logger)

Tente iniciar uma instância do GCE com o Acloud ou o 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 usuário de execução do host do AVD, null se não 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 a serem adicionadas como metadados da VM.
logger ITestLogger: o ITestLogger em que os registros de inicialização do dispositivo serão registrados.
Retorna
GceAvdInfo um GceAvdInfo que descreve a instância do GCE. Pode ser uma instância BOOT_FAIL.
Gera
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Retorna
GceAvdInfo

Gera
TargetSetupError

startGce

public GceAvdInfo startGce (String ipDevice, 
                MultiMap<String, String> attributes)

Tenta iniciar uma instância do 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 transmitir informações aplicáveis à instância do GCE a serem adicionadas como metadados da VM.
Retorna
GceAvdInfo um GceAvdInfo que descreve a instância do GCE. Pode ser uma instância BOOT_FAIL.
Gera
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 do GCE com o Acloud ou o 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 usuário de execução do host do AVD, null se não 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 a serem adicionadas como metadados da VM.
Retorna
GceAvdInfo um GceAvdInfo que descreve a instância do GCE. Pode ser uma instância BOOT_FAIL.
Gera
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Esse método foi descontinuado.
Remova isso depois que a ramificação principal for atualizada.

Parâmetros
buildInfos

Retorna
Gera
TargetSetupError

startMultiDevicesGce

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

Tente iniciar uma instância do GCE multidispositivo com o Oxygen.

Parâmetros
buildInfos : ERROR(/List)
attributes MultiMap: atributos associados à invocação atual
Retorna
um ERROR(/List) que descreve as informações do AVD do GCE.
Gera
TargetSetupError

Métodos protegidos

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

Retorna

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Recupere o nome da instância dos registros de inicialização do GCE. Procure o padrão "name": "gce-" para extrair o nome. Extraímos dos registros em vez do arquivo de resultados porque, em caso de falha na inicialização do GCE, o nome da instância tentada não aparece no JSON.

Parâmetros
bootupLogs String

Retorna
String