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
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
public static final String GCE_IP_PRECONFIGURED_KEY
Constructores públicos
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. |
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. |
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. |
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. |
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. |
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. |
inicioMultiDispositivosGce
public startMultiDevicesGce ( buildInfos)
Este método está en desuso.
Elimine esto después de que se actualice la rama maestra.
inicioMultiDispositivosGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Intente iniciar la instancia de gce de múltiples dispositivos con Oxygen.
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 |
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 |
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 |