GceManager

public class GceManager
extends Object

java.lang.Объект
↳ com.android.tradefed.device.cloud.GceManager

Помощник, который управляет вызовами GCE для запуска/остановки и сбора журналов из GCE.

Краткое содержание

Поля

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

Общественные конструкторы

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ктор

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

Этот конструктор устарел. Используйте другие конструкторы, мы оставляем это временно для обратной совместимости.

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

Ctor — вариант, который можно использовать для предоставления имени экземпляра GCE для непосредственного использования.

Публичные методы

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

Фактический запуск Acloud для выключения виртуального устройства.

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

Получите отчет об ошибках с устройства с помощью ssh, чтобы избежать потенциальных проблем с подключением adb.

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

Считывает текущее содержимое последовательного журнала экземпляра Gce Avd.

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

Получите отчет об ошибке через ssh для вложенного экземпляра.

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)

Получите удаленный файл из вложенного экземпляра и запишите его.

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

Получите удаленный файл из вложенного экземпляра и запишите его.

void logSerialOutput ( GceAvdInfo infos, ITestLogger logger)

Зарегистрируйте последовательный вывод устройства, описанного GceAvdInfo .

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

Выполните удаленную команду через ssh на экземпляре.

boolean shutdownGce ()

Завершите работу экземпляра Gce, связанного с startGce() .

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

Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.

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

Попытайтесь запустить экземпляр gce.

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

Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Этот метод устарел. Удалите это после обновления основной ветки.

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

Попытайтесь запустить экземпляр gce на нескольких устройствах с помощью Oxygen.

Защищенные методы

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

Получите имя экземпляра из журналов загрузки gce.

Поля

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

Общественные конструкторы

GceManager 

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

Ктор

Параметры
deviceDesc DeviceDescriptor : DeviceDescriptor , который будет связан с устройством GCE.

deviceOptions TestDeviceOptions : TestDeviceOptions связанный с устройством.

buildInfo IBuildInfo : IBuildInfo , описывающий запуск сборки gce.

GceManager 

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

Этот конструктор устарел.
Используйте другие конструкторы, мы оставляем это временно для обратной совместимости.

Параметры
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager 

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

Ctor — вариант, который можно использовать для предоставления имени экземпляра GCE для непосредственного использования.

Параметры
deviceDesc DeviceDescriptor : DeviceDescriptor , который будет связан с устройством GCE.

deviceOptions TestDeviceOptions : TestDeviceOptions связанный с устройством.

buildInfo IBuildInfo : IBuildInfo , описывающий запуск сборки gce.

gceInstanceName String : имя экземпляра, который нужно использовать.

gceHost String : имя хоста или IP-адрес используемого экземпляра.

Публичные методы

ОблакоВыключение 

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

Фактический запуск Acloud для выключения виртуального устройства.

Параметры
options TestDeviceOptions : TestDeviceOptions для параметров Cloud.

runUtil IRunUtil : IRunUtil для запуска Acloud.

instanceName String : экземпляр для завершения работы.

hostname String : имя хоста экземпляра, используется только для каракатиц Oxygen.

isIpPreconfigured boolean : был ли AVD создан на удаленном устройстве с предварительно настроенным IP-адресом.

Возврат
boolean Правда в случае успеха

очистка 

public void cleanUp ()

getBugreportzWithSsh 

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

Получите отчет об ошибках с устройства с помощью ssh, чтобы избежать потенциальных проблем с подключением adb.

Параметры
gceAvd GceAvdInfo : GceAvdInfo , описывающий устройство.

options TestDeviceOptions : TestDeviceOptions , описывающий параметры устройства, которые будут использоваться для устройства GCE.

runUtil IRunUtil : IRunUtil для выполнения команд.

Возврат
File Файл, указывающий на отчет об ошибке в формате zip, или значение NULL, если возникла проблема.

Броски
Исключение IO

getInstanceSerialLog 

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

Считывает текущее содержимое последовательного журнала экземпляра Gce Avd.

Параметры
infos GceAvdInfo : GceAvdInfo описывающий экземпляр.

avdConfigFile File : файл конфигурации avd.

jsonKeyFile File : JSON-файл ключей сервисной учетной записи.

runUtil IRunUtil : IRunUtil для выполнения команд.

Возврат
String Последовательный вывод журнала или ноль, если что-то пойдет не так.

getNestedDeviceSshBugreportz 

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

Получите отчет об ошибке через ssh для вложенного экземпляра. Для этого требуется запросить adb во вложенном виртуальном экземпляре.

Параметры
gceAvd GceAvdInfo : GceAvdInfo , описывающий устройство.

options TestDeviceOptions : TestDeviceOptions , описывающий параметры устройства, которые будут использоваться для устройства GCE.

runUtil IRunUtil : IRunUtil для выполнения команд.

Возврат
File Файл, указывающий на отчет об ошибке в формате zip, или значение NULL, если возникла проблема.

Броски
Исключение IO

logDirectory 

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

Параметры
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)

Получите удаленный файл из вложенного экземпляра и запишите его.

Параметры
logger ITestLogger : ITestLogger , где регистрируется файл.

gceAvd GceAvdInfo : GceAvdInfo , описывающий устройство.

options TestDeviceOptions : TestDeviceOptions , описывающий параметры устройства, которые будут использоваться для устройства GCE.

runUtil IRunUtil : IRunUtil для выполнения команд.

remoteFilePath String : удаленный путь, по которому можно найти файл.

type LogDataType : LogDataType зарегистрированного файла.

Возврат
boolean успешно ли зарегистрирован файл.

logNestedRemoteFile 

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

Получите удаленный файл из вложенного экземпляра и запишите его.

Параметры
logger ITestLogger : ITestLogger , где регистрируется файл.

gceAvd GceAvdInfo : GceAvdInfo , описывающий устройство.

options TestDeviceOptions : TestDeviceOptions , описывающий параметры устройства, которые будут использоваться для устройства GCE.

runUtil IRunUtil : IRunUtil для выполнения команд.

remoteFilePath String : удаленный путь, по которому можно найти файл.

type LogDataType : LogDataType зарегистрированного файла.

baseName String : базовое имя, которое будет использоваться для регистрации файла. Если значение равно нулю, будет использоваться фактическое имя файла.

Возврат
boolean успешно ли зарегистрирован файл.

журналSerialOutput 

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Зарегистрируйте последовательный вывод устройства, описанного GceAvdInfo .

Параметры
infos GceAvdInfo : GceAvdInfo описывающий экземпляр.

logger ITestLogger : ITestLogger , где регистрируется последовательный журнал.

удаленноеSshCommandExecution 

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

Выполните удаленную команду через ssh на экземпляре.

Параметры
gceAvd GceAvdInfo : GceAvdInfo , описывающий устройство.

options TestDeviceOptions : TestDeviceOptions , описывающий параметры устройства, которые будут использоваться для устройства GCE.

runUtil IRunUtil : IRunUtil для выполнения команд.

timeoutMs long : тайм-аут команды в миллисекундах. 0 означает отсутствие тайм-аута.

command String : удаленная команда для выполнения.

Возврат
CommandResult CommandResult содержащий результат выполнения.

выключениеGce 

public boolean shutdownGce ()

Завершите работу экземпляра Gce, связанного с startGce() .

Возврат
boolean возвращает true, если отключение gce было запрошено как неблокирующее.

startGce 

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

Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.

Параметры
ipDevice String : начальный IP-адрес экземпляра GCE для запуска AVD, null , если неприменимо.

user String : хост, на котором работает пользователь AVD, null , если неприменимо.

offset Integer : смещение номера устройства AVD на хосте, null , если оно неприменимо.

attributes MultiMap : атрибуты, связанные с текущим вызовом, используемые для передачи применимой информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины.

logger ITestLogger : ITestLogger , где сохраняются журналы запуска устройства.

Возврат
GceAvdInfo GceAvdInfo описывающий экземпляр GCE. Это может быть экземпляр BOOT_FAIL.

Броски
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce 

public GceAvdInfo startGce ()

Возврат
GceAvdInfo

Броски
TargetSetupError

startGce 

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

Попытайтесь запустить экземпляр gce.

Параметры
ipDevice String : начальный IP-адрес экземпляра GCE для запуска AVD, null , если неприменимо.

attributes MultiMap : атрибуты, связанные с текущим вызовом, используемые для передачи применимой информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины.

Возврат
GceAvdInfo GceAvdInfo описывающий экземпляр GCE. Это может быть экземпляр BOOT_FAIL.

Броски
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce 

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

Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.

Параметры
ipDevice String : начальный IP-адрес экземпляра GCE для запуска AVD, null , если неприменимо.

user String : хост, на котором работает пользователь AVD, null , если неприменимо.

offset Integer : смещение номера устройства AVD на хосте, null , если оно неприменимо.

attributes MultiMap : атрибуты, связанные с текущим вызовом, используемые для передачи применимой информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины.

Возврат
GceAvdInfo GceAvdInfo описывающий экземпляр GCE. Это может быть экземпляр BOOT_FAIL.

Броски
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce 

public  startMultiDevicesGce ( buildInfos)

Этот метод устарел.
Удалите это после обновления основной ветки.

Параметры
buildInfos

Возврат

Броски
TargetSetupError

startMultiDevicesGce 

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

Попытайтесь запустить экземпляр gce на нескольких устройствах с помощью Oxygen.

Параметры
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : атрибуты, связанные с текущим вызовом.

Возврат
ERROR(/List ) ERROR(/List ) описывающее информацию GCE Avd.

Броски
TargetSetupError

Защищенные методы

сборкаШутдаунКоманда 

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

Параметры
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

Возврат

ExtractInstanceName 

protected String extractInstanceName (String bootupLogs)

Получите имя экземпляра из журналов загрузки gce. Найдите «имя»: «gce- ' шаблон для извлечения его имени. Мы извлекаем данные из журналов, а не из файла результатов, поскольку в случае сбоя загрузки gce имя экземпляра попытки не отображается в формате JSON.

Параметры
bootupLogs String

Возврат
String