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
Los 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) GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) Este constructor está en desuso. Use otros constructores, mantenemos esto temporalmente para 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 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 errores 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 de serie de la instancia de Gce Avd. |
static File | getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Obtenga un informe de errores 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 en serie de un dispositivo descrito por |
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 () Cierra la instancia de Gce asociada con |
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 (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) Intente iniciar una instancia de gce con Acloud u Oxygen. |
GceAvdInfo | startGce () |
GceAvdInfo | startGce (String ipDevice, MultiMap <String, String> attributes) Intenta iniciar una instancia de gce. |
startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos) Intente iniciar la instancia gce de varios 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) Recupera el nombre de la instancia de los registros de arranque de gce. |
Los 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)
Ctor
Parámetros | |
---|---|
deviceDesc | DeviceDescriptor : el DeviceDescriptor que se asociará con el dispositivo GCE. |
deviceOptions | TestDeviceOptions : TestDeviceOptions asociado con el dispositivo. |
buildInfo | IBuildInfo : un IBuildInfo que describe la compilación gce para comenzar. |
GceManager
public GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo,testResourceBuildInfos)
Este constructor está en desuso.
Use otros constructores, mantenemos esto temporalmente para 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 instancia de GCE para usar directamente.
Parámetros | |
---|---|
deviceDesc | DeviceDescriptor : el DeviceDescriptor que se asociará con el dispositivo GCE. |
deviceOptions | TestDeviceOptions : TestDeviceOptions asociado con el dispositivo |
buildInfo | IBuildInfo : un IBuildInfo que describe la compilación gce para comenzar. |
gceInstanceName | String : El nombre de la instancia a usar. |
gceHost | String : El nombre de host o ip de la instancia a usar. |
Métodos públicos
AcloudCierre
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 a 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 errores 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 usarán para el dispositivo GCE. |
runUtil | IRunUtil : un IRunUtil para ejecutar comandos. |
Devoluciones | |
---|---|
File | Un archivo que apunta al informe de errores zip, o nulo si se produjo un problema. |
getInstanceSerialLog
public static String getInstanceSerialLog (GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)
Lee el contenido actual del registro de serie de la instancia de Gce Avd.
Parámetros | |
---|---|
infos | GceAvdInfo : el 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 de registro en serie o nulo si algo sale mal. |
getNestedDeviceSshBugreportz
public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)
Obtenga 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 : TestDeviceOptions que describe las opciones del dispositivo que se usarán para el dispositivo GCE. |
runUtil | IRunUtil : un IRunUtil para ejecutar comandos. |
Devoluciones | |
---|---|
File | Un archivo que apunta al informe de errores zip, o nulo si se produjo un problema. |
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 usará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 registra 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 usará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 usará para registrar el archivo. Si es nulo, se utilizará el nombre de archivo real. |
Devoluciones | |
---|---|
boolean | si el archivo se registra correctamente. |
logSerialOutput
public void logSerialOutput (GceAvdInfo infos, ITestLogger logger)
Registre la salida en serie de un dispositivo descrito por GceAvdInfo
.
Parámetros | |
---|---|
infos | GceAvdInfo : el GceAvdInfo que describe la instancia. |
logger | ITestLogger : el ITestLogger donde registrar el registro en serie. |
ejecución remota del 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 usará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 ()
Cierra la instancia de Gce asociada con startGce()
.
Devoluciones | |
---|---|
boolean | devuelve verdadero si gce shutdown se solicitó como no bloqueante. |
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 host que ejecuta el usuario de AVD, null si no corresponde |
offset | Integer : el desplazamiento del número de 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 que se agregue como metadatos de VM |
logger | ITestLogger : el ITestLogger donde registrar los registros de inicio del dispositivo. |
Devoluciones | |
---|---|
GceAvdInfo | un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia de BOOT_FAIL. |
Lanza | |
---|---|
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 host que ejecuta el usuario de AVD, null si no corresponde |
offset | Integer : el desplazamiento del número de 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 que se agregue como metadatos de VM |
Devoluciones | |
---|---|
GceAvdInfo | un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia de BOOT_FAIL. |
Lanza | |
---|---|
TargetSetupError |
inicioGce
public GceAvdInfo startGce (String ipDevice, MultiMap<String, String> attributes)
Intenta 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 que se agregue como metadatos de VM |
Devoluciones | |
---|---|
GceAvdInfo | un GceAvdInfo que describe la instancia de GCE. Podría ser una instancia de BOOT_FAIL. |
Lanza | |
---|---|
TargetSetupError |
startMultiDevicesGce
publicstartMultiDevicesGce ( buildInfos)
Intente iniciar la instancia gce de varios dispositivos con Oxygen.
Parámetros | |
---|---|
buildInfos | ERROR(/List ) ERROR(/List ) |
Devoluciones | |
---|---|
un ERROR(/List ) ERROR(/List ) que describe la GCE Avd Info. |
Lanza | |
---|---|
TargetSetupError |
Métodos protegidos
construirGceCmd
protectedbuildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)
Compile y devuelva el comando para iniciar GCE. Expuesto para la prueba.
Parámetros | |
---|---|
reportFile | File |
b | IBuildInfo |
ipDevice | String |
user | String |
offset | Integer |
attributes | MultiMap |
Devoluciones | |
---|---|
Comando de apagado de compilación
protected staticbuildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)
Parámetros | |
---|---|
config | File |
options | TestDeviceOptions |
instanceName | String |
hostname | String |
isIpPreconfigured | boolean |
Devoluciones | |
---|---|
extractInstanceName
protected String extractInstanceName (String bootupLogs)
Recupera el nombre de la instancia de los registros de arranque de gce. Busque el 'nombre': 'gce-
Parámetros | |
---|---|
bootupLogs | String |
Devoluciones | |
---|---|
String |