GceManager
public
class
GceManager
extends Object
Objeto java.lang.
|
↳ |
com.android.tradefed.device.cloud.GceManager
|
Es un asistente que administra las llamadas a GCE para iniciar o detener y recopilar registros de GCE.
Resumen
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. Mantenemos esto de forma temporal para mantener la retrocompatibilidad.
|
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 que se 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)
Obtén un informe de errores 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)
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 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 haz un registro.
|
void
|
logSerialOutput(GceAvdInfo infos, ITestLogger logger)
Registra la salida en serie 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 el 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)
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 Acloud o Oxygen.
|
|
startMultiDevicesGce( buildInfos)
Este método dejó de estar disponible.
Quita esto después de actualizar la rama principal.
|
|
startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)
Intenta iniciar una instancia de GCE de varios dispositivos con Oxygen.
|
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 dejó de estar disponible.
Usa otros constructores. Mantenemos esto de forma temporal para mantener 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 el nombre de la instancia de GCE que se 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 : 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)
Ejecución real de Acloud para apagar el dispositivo virtual.
Parámetros |
options |
TestDeviceOptions : Es 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, 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 realiza correctamente. |
cleanUp
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 : Es 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. |
Muestra |
File |
Es 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 en serie de la instancia de Gce Avd.
Parámetros |
infos |
GceAvdInfo : Es el GceAvdInfo que describe la instancia. |
avdConfigFile |
File : El archivo de configuración de avd |
jsonKeyFile |
File : Es el archivo de clave JSON de la cuenta de servicio. |
runUtil |
IRunUtil : Un IRunUtil para ejecutar comandos. |
Muestra |
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)
Obtén 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 : Es 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. |
Muestra |
File |
Es un archivo que apunta al informe de errores ZIP o nulo si se produjo un problema. |
logAndDeleteFile
public static void logAndDeleteFile (File tempFile,
String dataName,
ITestLogger logger)
Parámetros |
tempFile |
File |
dataName |
String |
logger |
ITestLogger |
Directorio de registro
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 haz un registro.
Parámetros |
logger |
ITestLogger : El ITestLogger en el que se registrará el archivo. |
gceAvd |
GceAvdInfo : Es el GceAvdInfo que describe el dispositivo. |
options |
TestDeviceOptions : Un TestDeviceOptions que describe las opciones de dispositivos que se usarán para el dispositivo de GCE. |
runUtil |
IRunUtil : Es 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 |
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 haz un registro.
Parámetros |
logger |
ITestLogger : El ITestLogger en el que se registrará el archivo. |
gceAvd |
GceAvdInfo : Es 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 : Un IRunUtil para ejecutar comandos. |
remoteFilePath |
String : Es la ruta 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 real del archivo. |
Muestra |
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 : Es el GceAvdInfo que describe la instancia. |
logger |
ITestLogger : Es el ITestLogger en el que se registra el registro de serie. |
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 : 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á. |
shutdownGce
public boolean shutdownGce ()
Apaga la instancia de GCE asociada con el startGce()
.
Muestra |
boolean |
Muestra verdadero si se solicitó el cierre de GCE como no bloqueador. |
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 : La IP inicial de la instancia de GCE en la que se ejecutará el AVD, null si no corresponde |
user |
String : El usuario que ejecuta el host del AVD, null si no corresponde |
offset |
Integer : Es la compensación de número de dispositivos del AVD en el host, null si no es aplicable. |
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 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. |
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 la VM. |
Muestra |
GceAvdInfo |
Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia de BOOT_FAIL. |
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 : La IP inicial de la instancia de GCE en la que se ejecutará el AVD, null si no corresponde |
user |
String : El usuario que ejecuta el host del AVD, null si no corresponde |
offset |
Integer : Es la compensación de número de dispositivos del AVD en el host, null si no es aplicable. |
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 la VM. |
Muestra |
GceAvdInfo |
Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia de BOOT_FAIL. |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Este método dejó de estar disponible.
Quita esto una vez que se actualice la rama principal.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Intenta iniciar una 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 de Avd de GCE |
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 |
protected String extractInstanceName (String bootupLogs)
Recupera el nombre de la instancia de los registros de inicio de GCE. Busca el patrón "name": "gce-" para extraer el nombre. Extraemos de los registros en lugar del archivo de resultados porque, en caso de falla de inicio de GCE, el nombre de la instancia que se intentó no se mostrará en JSON.
Parámetros |
bootupLogs |
String |