GceManager

public class GceManager
extends Object

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


Ayudante que gestiona 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)

Director

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

Este constructor está en desuso. Utilice otros constructores, lo mantenemos temporalmente por compatibilidad con versiones anteriores.

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

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

Métodos públicos

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

Ejecución real de Acloud para apagar el dispositivo virtual.

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

Obtenga un informe de error del dispositivo usando ssh para evitar cualquier problema potencial de conexión adb.

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

Lee el contenido actual del registro serial de la instancia Gce Avd.

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

Obtenga un informe de error a través de ssh para una instancia anidada.

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

Obtenga un archivo remoto de una instancia anidada y regístrelo.

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

Obtenga un archivo remoto de una instancia anidada y regístrelo.

void logSerialOutput ( GceAvdInfo infos, ITestLogger logger)

Registre la salida serial de un dispositivo descrito por GceAvdInfo .

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

Ejecute el comando remoto a través de ssh en una instancia.

boolean shutdownGce ()

Apague la instancia de Gce asociada con startGce() .

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

Intente iniciar una instancia de gce con Acloud u Oxygen.

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

Intente iniciar una instancia de gce.

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

Intente iniciar una instancia de gce con Acloud u Oxygen.

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Este método está en desuso. Elimine esto después de que se actualice la rama maestra.

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

Intente iniciar la instancia de gce de múltiples dispositivos con Oxygen.

Métodos protegidos

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

Compile y devuelva el comando para iniciar GCE.

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

Recupere el nombre de la instancia de los registros de inicio de 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

Constructores públicos

GceManager

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

Director

Parámetros
deviceDesc DeviceDescriptor : el DeviceDescriptor que se asociará con el dispositivo GCE.

deviceOptions TestDeviceOptions : TestDeviceOptions asociado con el dispositivo.

buildInfo IBuildInfo : IBuildInfo que describe la compilación de gce para comenzar.

GceManager

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

Este constructor está en desuso.
Utilice otros constructores, lo mantenemos temporalmente por compatibilidad con versiones anteriores.

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 el nombre de la instancia de GCE para usar directamente.

Parámetros
deviceDesc DeviceDescriptor : el DeviceDescriptor que se asociará con el dispositivo GCE.

deviceOptions TestDeviceOptions : un TestDeviceOptions asociado con el dispositivo.

buildInfo IBuildInfo : IBuildInfo que describe la compilación de gce para comenzar.

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

gceHost String : el nombre de host o IP de la instancia a utilizar.

Métodos públicos

AcloudShutdown

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

Ejecución real de Acloud para apagar el dispositivo virtual.

Parámetros
options TestDeviceOptions : TestDeviceOptions para las opciones de Acloud

runUtil IRunUtil : El IRunUtil para ejecutar Acloud

instanceName String : la instancia que se cerrará.

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

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

Devoluciones
boolean Verdadero si tiene éxito

limpiar

public void cleanUp ()

getBugreportzWithSsh

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

Obtenga un informe de error del dispositivo usando ssh para evitar cualquier problema potencial de conexión adb.

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

options TestDeviceOptions : TestDeviceOptions que describe las opciones del dispositivo que se utilizarán para el dispositivo GCE.

runUtil IRunUtil : un IRunUtil para ejecutar comandos.

Devoluciones
File Un archivo que apunta al informe de error zip, o nulo si ocurrió un problema.

Lanza
IOExcepción

getInstanceSerialLog

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

Lee el contenido actual del registro serial de la instancia Gce Avd.

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

avdConfigFile File : el archivo de configuración avd

jsonKeyFile File : el archivo de clave json de la cuenta de servicio.

runUtil IRunUtil : un IRunUtil para ejecutar comandos.

Devoluciones
String La salida del registro en serie o nula si algo sale mal.

getNestedDeviceSshBugreportz

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

Obtenga un informe de error 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 : TestDeviceOptions que describe las opciones del dispositivo que se utilizarán para el dispositivo GCE.

runUtil IRunUtil : un IRunUtil para ejecutar comandos.

Devoluciones
File Un archivo que apunta al informe de error zip, o nulo si ocurrió un problema.

Lanza
IOExcepción

logNestedRemoteFile

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

Obtenga un archivo remoto de una instancia anidada y regístrelo.

Parámetros
logger ITestLogger : el ITestLogger donde registrar el archivo.

gceAvd GceAvdInfo : El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions : TestDeviceOptions que describe las opciones del dispositivo que se utilizarán para el dispositivo GCE.

runUtil IRunUtil : un IRunUtil para ejecutar comandos.

remoteFilePath String : la ruta remota donde encontrar el archivo.

type LogDataType : el LogDataType del archivo registrado.

Devoluciones
boolean 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)

Obtenga un archivo remoto de una instancia anidada y regístrelo.

Parámetros
logger ITestLogger : el ITestLogger donde registrar el archivo.

gceAvd GceAvdInfo : El GceAvdInfo que describe el dispositivo.

options TestDeviceOptions : TestDeviceOptions que describe las opciones del dispositivo que se utilizarán para el dispositivo GCE.

runUtil IRunUtil : un IRunUtil para ejecutar comandos.

remoteFilePath String : la ruta remota donde encontrar el archivo.

type LogDataType : el LogDataType del archivo registrado.

baseName String : el nombre base que se utilizará para registrar el archivo. Si es nulo, se utilizará el nombre del archivo real.

Devoluciones
boolean si el archivo se registró correctamente.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Registre la salida serial de un dispositivo descrito por GceAvdInfo .

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

logger ITestLogger : ITestLogger donde registrar el registro en serie.

ejecución remota de comando Ssh

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

Ejecute el comando remoto a través de ssh en una instancia.

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

options TestDeviceOptions : TestDeviceOptions que describe las opciones del dispositivo que se utilizarán para el dispositivo GCE.

runUtil IRunUtil : un IRunUtil para ejecutar comandos.

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

command String : el comando remoto a ejecutar.

Devoluciones
CommandResult CommandResult que contiene el resultado de la ejecución.

apagadoGce

public boolean shutdownGce ()

Apague la instancia de Gce asociada con startGce() .

Devoluciones
boolean devuelve verdadero si se solicitó el cierre de gce como sin bloqueo.

inicioGce

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

Intente iniciar una instancia de gce con Acloud u Oxygen.

Parámetros
ipDevice String : la IP inicial de la instancia de GCE para ejecutar AVD, null si no corresponde

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

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

attributes MultiMap : atributos asociados con la invocación actual, utilizados para pasar información aplicable a la instancia de GCE para agregarla como metadatos de VM.

logger ITestLogger : ITestLogger donde registrar los registros de inicio del dispositivo.

Devoluciones
GceAvdInfo un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia BOOT_FAIL.

Lanza
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

inicioGce

public GceAvdInfo startGce ()

Devoluciones
GceAvdInfo

Lanza
TargetSetupError

inicioGce

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

Intente iniciar una instancia de gce.

Parámetros
ipDevice String : la IP inicial de la instancia de GCE para ejecutar AVD, null si no corresponde

attributes MultiMap : atributos asociados con la invocación actual, utilizados para pasar información aplicable a la instancia de GCE para agregarla como metadatos de VM.

Devoluciones
GceAvdInfo un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia BOOT_FAIL.

Lanza
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

inicioGce

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

Intente iniciar una instancia de gce con Acloud u Oxygen.

Parámetros
ipDevice String : la IP inicial de la instancia de GCE para ejecutar AVD, null si no corresponde

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

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

attributes MultiMap : atributos asociados con la invocación actual, utilizados para pasar información aplicable a la instancia de GCE para agregarla como metadatos de VM.

Devoluciones
GceAvdInfo un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia BOOT_FAIL.

Lanza
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

inicioMultiDispositivosGce

public  startMultiDevicesGce ( buildInfos)

Este método está en desuso.
Elimine esto después de que se actualice la rama maestra.

Parámetros
buildInfos

Devoluciones

Lanza
TargetSetupError

inicioMultiDispositivosGce

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

Intente iniciar la instancia de gce de múltiples dispositivos con Oxygen.

Parámetros
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : atributos asociados con la invocación actual

Devoluciones
un ERROR(/List ) ERROR(/List ) que describe GCE Avd Info.

Lanza
TargetSetupError

Métodos protegidos

construirGceCmd

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

Compile y devuelva el comando para iniciar GCE. Expuesto para pruebas.

Parámetros
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

Devoluciones

comando buildShutdown

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

Devoluciones

extraer nombre de instancia

protected String extractInstanceName (String bootupLogs)

Recupere el nombre de la instancia de los registros de inicio de gce. Busque el 'nombre': 'gce- 'patrón para extraer el nombre del mismo. Extraemos de los registros en lugar del archivo de resultados porque, en caso de falla en el arranque de gce, el nombre de la instancia intentada no se mostrará en json.

Parámetros
bootupLogs String

Devoluciones
String