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
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)
Se intentó iniciar la instancia de gce para varios dispositivos con Oxygen.
|
Campos
NOMBRE DE PERSONA_CLAVE_GCE
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
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; 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. |
Muestra |
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 GCE. |
runUtil |
IRunUtil : Es un IRunUtil para ejecutar comandos. |
Muestra |
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 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. |
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)
Obtener un informe de errores a través de SSH para una instancia anidada Esto requiere solicitar el adb de la biblioteca anidada
virtual de Compute Engine.
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 GCE. |
runUtil |
IRunUtil : Es un IRunUtil para ejecutar comandos. |
Muestra |
File |
Un archivo que apunta al informe de errores ZIP o nulo si se produjo un problema. |
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 |
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 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. |
Muestra |
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 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 mostrará el nombre real del archivo
que se usan. |
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 : El GceAvdInfo que describe la instancia. |
logger |
ITestLogger : Es 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 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á. |
cierreGce
public boolean shutdownGce ()
Cierra la instancia de Gce asociada con el startGce()
.
Muestra |
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. Si no es así, es null .
correspondiente |
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; de lo contrario, es null .
correspondiente |
attributes |
MultiMap : Son atributos asociados con la invocación actual, que se usan para pasar los valores aplicables.
información a la instancia de GCE para agregarla como metadatos de VM |
logger |
ITestLogger : El ITestLogger en el que se deben registrar los registros de inicio del dispositivo. |
Muestra |
GceAvdInfo |
Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia 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. Si no es así, es null .
correspondiente |
attributes |
MultiMap : Son atributos asociados con la invocación actual, que se usan para pasar los valores aplicables.
información a la instancia de GCE para agregarla como metadatos de VM |
Muestra |
GceAvdInfo |
Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia 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 : Es la IP inicial de la instancia de GCE en la que se ejecutará el AVD. Si no es así, es null .
correspondiente |
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; de lo contrario, es null .
correspondiente |
attributes |
MultiMap : Son atributos asociados con la invocación actual, que se usan para pasar los valores aplicables.
información a la instancia de GCE para agregarla como metadatos de VM |
Muestra |
GceAvdInfo |
Un GceAvdInfo que describe la instancia de GCE Podría ser una instancia BOOT_FAIL. |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Este método dejó de estar disponible.
Quita esta opción después de actualizar la rama principal.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Se intentó iniciar la instancia de gce para varios dispositivos con Oxygen.
Parámetros |
buildInfos |
: ERROR(/List) |
attributes |
MultiMap : Atributos asociados con la invocación actual |
Muestra |
|
un elemento ERROR(/List) que describe la información de disponibilidad de GCE. |
Métodos protegidos
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)
Recupera el nombre de la instancia de los registros de arranque de gce. Busque el “nombre”: “gce-”.
para extraer su nombre. Extraemos de los registros
en lugar del archivo resultante porque
Se produce un error en el inicio de gce, el nombre de la instancia que se intentó no se mostrará en JSON.
Parámetros |
bootupLogs |
String |