GceManager

public class GceManager
extends Object

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


Es el asistente que administra las llamadas de GCE para iniciar/detener y recopilar registros de GCE.

Resumen

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

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; lo mantenemos temporalmente para brindar retrocompatibilidad.

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

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

Métodos públicos

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

Acloud run para apagar el dispositivo virtual

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

Obtén un bugreportz del dispositivo con SSH para evitar cualquier problema potencial de conexión de adb.

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

Lee el contenido actual del registro en serie de la instancia de GCE Avd.

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

Obtener un informe de errores a través de SSH para una instancia anidada

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 regístralo.

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 regístralo.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Registra la salida en serie de un dispositivo que se describe en 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()

Cierra la instancia de Gce asociada con el startGce().

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

Intenta iniciar una instancia de gce con Oxygen o Acloud.

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

Intento de iniciar una instancia de gce.

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

Intenta iniciar una instancia de gce con Oxygen o Acloud.

startMultiDevicesGce( buildInfos)

Este método dejó de estar disponible. Quita esto una vez que se actualice la rama principal.

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

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

Métodos protegidos

buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)

Compila y muestra el comando para iniciar GCE.

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.

Campos

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

CLAVE_GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

CLAVE_IP_PRECONFIGURED_GCE

public static final String GCE_IP_PRECONFIGURED_KEY

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; lo mantenemos temporalmente para brindar retrocompatibilidad.

Parámetros
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

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

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á.

gceInstanceName String: Es el nombre de la instancia que se usará.

gceHost String: El nombre de host o la IP de la instancia que se usará.

Métodos públicos

Cierre de la nube

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

Acloud run 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: La instancia que se cerrará.

hostname String: Es el nombre de host de la instancia, solo se usa para sepia.

isIpPreconfigured boolean: Indica si el AVD se creó en un dispositivo remoto con una IP preconfigurada.

Devuelve
boolean Verdadero si se ejecuta correctamente

Limpieza

public void cleanUp ()

getBugreportzWithSsh

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

Obtén un bugreportz del dispositivo con SSH para evitar cualquier problema potencial de conexión de adb.

Parámetros
gceAvd GceAvdInfo: El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions: Es un TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.

runUtil IRunUtil: Es un IRunUtil para ejecutar comandos.

Devuelve
File Un archivo que apunta al informe de errores ZIP o nulo si se produjo un problema.

Arroja
IOException

getInstanceSerialLog

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

Lee el contenido actual del registro en serie de la instancia de GCE Avd.

Parámetros
infos GceAvdInfo: El GceAvdInfo que describe la instancia.

avdConfigFile File: Es el archivo de configuración de avd.

jsonKeyFile File: Es el archivo de claves JSON de la cuenta de servicio.

runUtil IRunUtil: Es un IRunUtil para ejecutar comandos.

Devuelve
String El resultado del registro en serie o un valor nulo si algo sale mal.

getNestedDeviceSshBugreportz

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

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

Parámetros
gceAvd GceAvdInfo: El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions: Es un TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.

runUtil IRunUtil: Es un IRunUtil para ejecutar comandos.

Devuelve
File Un archivo que apunta al informe de errores ZIP o nulo si se produjo un problema.

Arroja
IOException

Directorio de registros

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

Parámetros
remoteDirectory File

baseName String

logger ITestLogger

type LogDataType

ArchivologNestedRemoteFile

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 regístralo.

Parámetros
logger ITestLogger: El ITestLogger en el que se registrará el archivo.

gceAvd GceAvdInfo: El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions: Es un TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.

runUtil IRunUtil: Es un IRunUtil para ejecutar comandos.

remoteFilePath String: Es la ruta remota en la que se encuentra el archivo.

type LogDataType: El LogDataType del archivo registrado.

Devuelve
boolean si el archivo se registró correctamente.

ArchivologNestedRemoteFile

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 regístralo.

Parámetros
logger ITestLogger: El ITestLogger en el que se registrará el archivo.

gceAvd GceAvdInfo: El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions: Es un TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.

runUtil IRunUtil: Es un IRunUtil para ejecutar comandos.

remoteFilePath String: Es la ruta remota en la que se encuentra el archivo.

type LogDataType: 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 real del archivo.

Devuelve
boolean si el archivo se registró correctamente.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Registra la salida en serie de un dispositivo que se describe en GceAvdInfo.

Parámetros
infos GceAvdInfo: El GceAvdInfo que describe la instancia.

logger ITestLogger: el ITestLogger en el que se debe registrar el registro en serie.

Ejecución remota de comandos

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: El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions: Es un TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo de GCE.

runUtil IRunUtil: Es un IRunUtil para ejecutar comandos.

timeoutMs long: Es el tiempo de espera en milisegundos del comando. 0 significa que no hay tiempo de espera.

command String: Es el comando remoto que se ejecutará.

Devuelve
CommandResult Es una CommandResult que contiene el resultado de la ejecución.

cierreGce

public boolean shutdownGce ()

Cierra la instancia de Gce asociada con el startGce().

Devuelve
boolean muestra el valor true si se solicitó el cierre de gce sin bloqueo.

startGce

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

Intenta iniciar una instancia de gce con Oxygen o Acloud.

Parámetros
ipDevice String: Es la IP inicial de la instancia de GCE en la que se ejecutará el AVD (null si no corresponde).

user String: Es el host que ejecuta el usuario de AVD, null si no corresponde.

offset Integer: Es el desplazamiento numérico del dispositivo del AVD en el host, null si no corresponde.

attributes MultiMap: Son atributos asociados con la invocación actual, que se usan para pasar la información aplicable a la instancia de GCE para que se agregue como metadatos de VM.

logger ITestLogger: El ITestLogger en el que se deben registrar los registros de inicio del dispositivo.

Devuelve
GceAvdInfo Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia BOOT_FAIL.

Arroja
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Devuelve
GceAvdInfo

Arroja
TargetSetupError

startGce

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

Intento de 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 (null si no corresponde).

attributes MultiMap: Son atributos asociados con la invocación actual, que se usan para pasar la información aplicable a la instancia de GCE para que se agregue como metadatos de VM.

Devuelve
GceAvdInfo Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia 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 Oxygen o Acloud.

Parámetros
ipDevice String: Es la IP inicial de la instancia de GCE en la que se ejecutará el AVD (null si no corresponde).

user String: Es el host que ejecuta el usuario de AVD, null si no corresponde.

offset Integer: Es el desplazamiento numérico del dispositivo del AVD en el host, null si no corresponde.

attributes MultiMap: Son atributos asociados con la invocación actual, que se usan para pasar la información aplicable a la instancia de GCE para que se agregue como metadatos de VM.

Devuelve
GceAvdInfo Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia BOOT_FAIL.

Arroja
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Este método dejó de estar disponible.
Quita esto una vez que se actualice la rama principal.

Parámetros
buildInfos

Devuelve

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

Devuelve
un elemento ERROR(/List) que describe la información de disponibilidad de GCE.

Arroja
TargetSetupError

Métodos protegidos

ComandoparacompilaciónGceCmd

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

Compila y muestra el comando para iniciar GCE. Expuesto para realizar pruebas.

Parámetros
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

Devuelve

ComandoBuildShutdown

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

Devuelve

nombredeinstanciadeextraer

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 registros en lugar del archivo de resultados porque, si falla el inicio de gce, el nombre de la instancia que se intentó no se mostrará en JSON.

Parámetros
bootupLogs String

Devuelve
String