GceManager

public class GceManager
extends Object

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

Es un asistente que administra las llamadas a GCE para iniciar, detener y recopilar registros de GCE.

Resumen

Constantes

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

Constructores públicos

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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

Este constructor dejó de estar disponible. Usa otros constructores. Conservamos este temporalmente para la retrocompatibilidad.

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)

Ctor, variación que se puede usar para proporcionar directamente el nombre de la instancia de GCE que se usará.

Métodos públicos

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

Es la ejecución real de Acloud para apagar el dispositivo virtual.

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

Obtén un bugreportz del dispositivo a través de SSH para evitar posibles problemas de conexión de adb.

HostOrchestratorUtil getHostOrchestratorUtil()

Devuelve la instancia de HostOrchestratorUtil.

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

Lee el contenido actual del registro serial de la instancia de AVD de GCE.

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

Obtén un informe de errores a través de SSH para una instancia anidada.

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)

Recupera un archivo remoto de una instancia anidada y lo registra.

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

Recupera un archivo remoto de una instancia anidada y lo registra.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Registra la salida serial de un dispositivo descrito por GceAvdInfo.

static CommandResult remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)

Ejecuta el comando remoto a través de SSH en una instancia.

boolean shutdownGce()

Apaga la instancia de Gce asociada con startGce().

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

Intenta iniciar una instancia de GCE con Acloud o Oxygen.

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

Intenta iniciar una instancia de GCE.

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

Intenta iniciar una instancia de GCE con Acloud o Oxygen.

startMultiDevicesGce( buildInfos)

Este método dejó de estar disponible. Remove this after master branch is updated.

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

Intenta iniciar la instancia de GCE de varios dispositivos con Oxygen.

Métodos protegidos

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

Recupera el nombre de la instancia de los registros de arranque de GCE.

Constantes

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Valor de la constante: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Valor de la constante: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Valor de la constante: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Valor de la constante: "gce-ip-pre-configured"

Constructores públicos

GceManager

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

Ctor

Parámetros
deviceDesc DeviceDescriptor: Es el DeviceDescriptor que se asociará con el dispositivo de GCE.
deviceOptions TestDeviceOptions: Es un TestDeviceOptions asociado con el dispositivo.
buildInfo IBuildInfo: Es un IBuildInfo que describe la compilación de GCE que se iniciará.

GceManager

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

Este constructor dejó de estar disponible.
Usa otros constructores. Conservamos este de forma temporal para garantizar la retrocompatibilidad.

Parámetros
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo, 
                String gceInstanceName, 
                String gceHost)

Ctor, variación que se puede usar para proporcionar directamente el nombre de la instancia de GCE que se usará.

Parámetros
deviceDesc DeviceDescriptor: Es el DeviceDescriptor que se asociará con el dispositivo de GCE.
deviceOptions TestDeviceOptions: Un TestDeviceOptions asociado con el dispositivo
buildInfo IBuildInfo: Es un IBuildInfo que describe la compilación de GCE que se iniciará.
gceInstanceName String: Es el nombre de la instancia que se usará.
gceHost String: Es el nombre de host o la IP de la instancia que se usará.

Métodos públicos

AcloudShutdown

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

Es la ejecución real de Acloud para apagar el dispositivo virtual.

Parámetros
options TestDeviceOptions: El TestDeviceOptions para las opciones de Acloud
runUtil IRunUtil: Es el IRunUtil para ejecutar Acloud.
instanceName String: Es la instancia que se apagará.
hostname String: Es el nombre de host de la instancia, que solo se usa para Oxygen Cuttlefish.
isIpPreconfigured boolean: Indica si el AVD se creó en un dispositivo remoto con una IP preconfigurada.
Muestra
boolean Es verdadero si se ejecuta correctamente.

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Obtén un bugreportz del dispositivo a través de SSH para evitar posibles problemas de conexión de adb.

Parámetros
gceAvd GceAvdInfo: Son los GceAvdInfo que describen el dispositivo.
options TestDeviceOptions: Es un objeto TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.
runUtil IRunUtil: Un IRunUtil para ejecutar comandos.
Muestra
File Es un archivo que apunta al informe de errores en formato zip o es nulo si se produjo un problema.
Arroja
IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Devuelve la instancia de HostOrchestratorUtil.

Muestra
HostOrchestratorUtil

getInstanceSerialLog

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

Lee el contenido actual del registro serial de la instancia de AVD de GCE.

Parámetros
infos GceAvdInfo: Es el objeto GceAvdInfo que describe la instancia.
avdConfigFile File: El archivo de configuración del AVD
jsonKeyFile File: Es el archivo de clave JSON de la cuenta de servicio.
runUtil IRunUtil: Un IRunUtil para ejecutar comandos.
Muestra
String Es el resultado del registro serial o nulo si algo sale mal.

getNestedDeviceSshBugreportz

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

Obtén un informe de errores a través de SSH para una instancia anidada. Esto requiere solicitar adb en la instancia virtual anidada.

Parámetros
gceAvd GceAvdInfo: Son los GceAvdInfo que describen el dispositivo.
options TestDeviceOptions: Es un objeto TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.
runUtil IRunUtil: Un IRunUtil para ejecutar comandos.
Muestra
File Es un archivo que apunta al informe de errores en formato zip o es nulo si se produjo un problema.
Arroja
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)

Recupera un archivo remoto de una instancia anidada y lo registra.

Parámetros
logger ITestLogger: Es el objeto ITestLogger en el que se registrará el archivo.
gceAvd GceAvdInfo: Son los GceAvdInfo que describen el dispositivo.
options TestDeviceOptions: Es un objeto TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.
runUtil IRunUtil: Un IRunUtil para ejecutar comandos.
remoteFilePath String: Es la ruta de acceso remota en la que se encuentra el archivo.
type LogDataType: Es el LogDataType del archivo registrado.
Muestra
boolean Indica si el archivo se registró correctamente.

logNestedRemoteFile

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

Recupera un archivo remoto de una instancia anidada y lo registra.

Parámetros
logger ITestLogger: Es el objeto ITestLogger en el que se registrará el archivo.
gceAvd GceAvdInfo: Son los GceAvdInfo que describen el dispositivo.
options TestDeviceOptions: Es un objeto TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.
runUtil IRunUtil: Un IRunUtil para ejecutar comandos.
remoteFilePath String: Es la ruta de acceso remota en la que se encuentra el archivo.
type LogDataType: Es el LogDataType del archivo registrado.
baseName String: Es el nombre base que se usará para registrar el archivo. Si es nulo, se usará el nombre de archivo real.
Muestra
boolean Indica si el archivo se registró correctamente.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Registra la salida serial de un dispositivo descrito por GceAvdInfo.

Parámetros
infos GceAvdInfo: Es el objeto GceAvdInfo que describe la instancia.
logger ITestLogger: Es el ITestLogger en el que se registrará el registro serial.

remoteSshCommandExecution

public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                long timeoutMs, 
                String... command)

Ejecuta el comando remoto a través de SSH en una instancia.

Parámetros
gceAvd GceAvdInfo: Son los GceAvdInfo que describen el dispositivo.
options TestDeviceOptions: Es un objeto TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.
runUtil IRunUtil: Un IRunUtil para ejecutar comandos.
timeoutMs long: Es el tiempo de espera en milisegundos para el comando. El valor 0 significa que no hay tiempo de espera.
command String: Es el comando remoto que se ejecutará.
Muestra
CommandResult CommandResult que contiene el resultado de la ejecución.

shutdownGce

public boolean shutdownGce ()

Apaga la instancia de Gce asociada con startGce().

Muestra
boolean Devuelve verdadero si se solicitó el cierre de GCE como no bloqueante.

startGce

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

Intenta iniciar una instancia de GCE con Acloud o Oxygen.

Parámetros
ipDevice String: Es la IP inicial de la instancia de GCE en la que se ejecutará el AVD. Es null si no se aplica.
user String: Es el usuario que ejecuta el host del AVD, null si no es aplicable.
offset Integer: Es el desplazamiento del número de dispositivo del AVD en el host, null si no corresponde.
attributes MultiMap: Son los atributos asociados con la invocación actual, que se usan para pasar información aplicable a la instancia de GCE y agregarla como metadatos de la VM.
logger ITestLogger: Es el ITestLogger en el que se registran los registros de inicio del dispositivo.
Muestra
GceAvdInfo Un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia de BOOT_FAIL.
Arroja
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Muestra
GceAvdInfo

Arroja
TargetSetupError

startGce

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

Intenta iniciar una instancia de GCE.

Parámetros
ipDevice String: Es la IP inicial de la instancia de GCE en la que se ejecutará el AVD. Es null si no se aplica.
attributes MultiMap: Son los atributos asociados con la invocación actual, que se usan para pasar información aplicable a la instancia de GCE y agregarla como metadatos de la VM.
Muestra
GceAvdInfo Un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia de BOOT_FAIL.
Arroja
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

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

Intenta iniciar una instancia de GCE con Acloud o Oxygen.

Parámetros
ipDevice String: Es la IP inicial de la instancia de GCE en la que se ejecutará el AVD. Es null si no se aplica.
user String: Es el usuario que ejecuta el host del AVD, null si no es aplicable.
offset Integer: Es el desplazamiento del número de dispositivo del AVD en el host, null si no corresponde.
attributes MultiMap: Son los atributos asociados con la invocación actual, que se usan para pasar información aplicable a la instancia de GCE y agregarla como metadatos de la VM.
Muestra
GceAvdInfo Un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia de BOOT_FAIL.
Arroja
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Este método dejó de estar disponible.
Remove this after master branch is updated.

Parámetros
buildInfos

Muestra
Arroja
TargetSetupError

startMultiDevicesGce

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

Intenta iniciar la instancia de GCE de varios dispositivos con Oxygen.

Parámetros
buildInfos : ERROR(/List)
attributes MultiMap: Atributos asociados con la invocación actual
Muestra
Un ERROR(/List) que describe la información del AVD de GCE.
Arroja
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

Muestra

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Recupera el nombre de la instancia de los registros de arranque de GCE. Busca el patrón "name": "gce-" para extraer su nombre. Extraemos los datos de los registros en lugar del archivo de resultados porque, si falla el inicio de GCE, el nombre de la instancia intentada no se mostrará en JSON.

Parámetros
bootupLogs String

Devuelve
String