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

devoluções
GceAvdInfo

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

public  startMultiDevicesGce ( 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

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 gce. Procure o 'nome': 'gce- ' padrão para extrair o nome dele. Extraímos dos logs em vez do arquivo de resultado porque, na falha de inicialização do gce, o nome da instância tentada não será exibido em json.

Parâmetros
bootupLogs	String

devoluções
String