GceManager

public class GceManager
extends Object

java.lang.Object
↳	com.android.tradefed.device.cloud.GceManager

---

Assistente que gerencia as chamadas do GCE para iniciar/parar e coletar registros 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) 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 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) A execução real do Acloud para encerrar 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 com o adb.
static String	getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil) Lê o conteúdo atual do registro de série da instância do Avd do Gce.
static File	getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Receber um bugreport por 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) Busque um arquivo remoto de uma instância aninhada e registre-o.
void	logSerialOutput(GceAvdInfo infos, ITestLogger logger) Registra a saída serial de um dispositivo descrito por GceAvdInfo.
static CommandResult	remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command) Executar 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) Tente 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 mestre for atualizada.
	startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes) Tente iniciar a instância gce de vários dispositivos com Oxygen.

Métodos protegidos
static	buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)
String	extractInstanceName(String bootupLogs) Extraia o nome da instância dos registros 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)

Ctor

Parâmetros
deviceDesc	DeviceDescriptor: o DeviceDescriptor que será associado ao dispositivo do GCE.
deviceOptions	TestDeviceOptions: uma TestDeviceOptions associada ao dispositivo.
buildInfo	IBuildInfo: uma IBuildInfo que descreve o build do gce que será iniciado.

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 o nome da instância do GCE para uso direto.

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

A execução real do Acloud para encerrar 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 encerrada.
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 predefinido

Retorna
boolean	Verdadeiro se for bem-sucedido

limpeza

public void cleanUp ()

getBugreportzWithSsh

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

Receba um relatório de bugs do dispositivo usando SSH para evitar possíveis problemas de conexão com 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 do GCE.
runUtil	IRunUtil: um IRunUtil para executar comandos.

Retorna
File	Um arquivo que aponta para o relatório de bugs zip ou nulo, se um problema tiver ocorrido.

Gera
	IOException

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)

Receber um bugreport por 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 do GCE.
runUtil	IRunUtil: um IRunUtil para executar comandos.

Retorna
File	Um arquivo que aponta para o relatório de bugs zip ou nulo, se um problema tiver ocorrido.

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)

Busque um arquivo remoto de uma instância aninhada e registre-o.

Parâmetros
logger	ITestLogger: o ITestLogger em que o arquivo será registrado.
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 do GCE.
runUtil	IRunUtil: um IRunUtil para executar comandos.
remoteFilePath	String: o caminho remoto em que o arquivo está.
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)

Busque um arquivo remoto de uma instância aninhada e registre-o.

Parâmetros
logger	ITestLogger: o ITestLogger em que o arquivo será registrado.
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 do GCE.
runUtil	IRunUtil: um IRunUtil para executar comandos.
remoteFilePath	String: o caminho remoto em que o arquivo está.
type	LogDataType: o LogDataType do arquivo registrado.
baseName	String: o nome de 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)

Registra 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 em série será registrado.

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 do comando. O valor 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 ()

Encerre a instância do Gce associada ao startGce().

Retorna
boolean	retorna verdadeiro se o encerramento do gce foi solicitado sem bloqueio.

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 em execução do host do AVD, null, se não for aplicável
offset	Integer: o dispositivo é um deslocamento do AVD no host, null, se não for aplicável
attributes	MultiMap: atributos associados à invocação atual, usados para transmitir informações relevantes à instância do GCE para serem adicionadas como metadados da VM
logger	ITestLogger: o ITestLogger em que os registros de inicialização do dispositivo sã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)

Tente 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 relevantes à instância do GCE para 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 em execução do host do AVD, null, se não for aplicável
offset	Integer: o dispositivo é um deslocamento do AVD no host, null, se não for aplicável
attributes	MultiMap: atributos associados à invocação atual, usados para transmitir as 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)

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

Parâmetros
buildInfos

Retorna

Gera
TargetSetupError

startMultiDevicesGce

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

Tente iniciar uma instância do GCE com vários dispositivos 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 GCE Avd.

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

extraçãoInstanceName

protected String extractInstanceName (String bootupLogs)

Extraia o nome da instância dos registros de inicialização do GCE. Pesquise o padrão "name: 'gce-'" para extrair o nome. Extraímos dos registros em vez do arquivo de resultado porque, na falha de inicialização do gce, o nome da instância tentada não será mostrado no json.

Parâmetros
bootupLogs	String

Retorna
String