GceManager

public class GceManager
extends Object

java.lang.Object
↳ com.android.tradefed.device.cloud.GceManager

Вспомогательная функция, которая управляет вызовами GCE для запуска/остановки и сбора логов из GCE.

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

Константы

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

Государственные строители

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Цтор

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

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

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, List< IBuildInfo > testResourceBuildInfos)

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

Общедоступные методы

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

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

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

Чтобы избежать потенциальных проблем с подключением к ADB, получите отчет об ошибке (ugreportz) с устройства, используя SSH.

HostOrchestratorUtil getHostOrchestratorUtil ()

Возвращает экземпляр HostOrchestratorUtil .

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 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, String baseName, List<String> scpArgs)

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

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.

List< GceAvdInfo > startMultiDevicesGce (List< IBuildInfo > buildInfos, MultiMap <String, String> attributes)

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

List< GceAvdInfo > startMultiDevicesGce (List< IBuildInfo > buildInfos)

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

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

static List<String> 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-hostname"

GCE_INSTANCE_CLEANED_KEY 

public static final String GCE_INSTANCE_CLEANED_KEY

Постоянное значение: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY 

public static final String GCE_INSTANCE_NAME_KEY

Постоянное значение: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY 

public static final String GCE_IP_PRECONFIGURED_KEY

Постоянное значение: "gce-ip-pre-configured"

Государственные строители

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, 
                String gceInstanceName, 
                String gceHost)

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

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

deviceOptions TestDeviceOptions : Объект TestDeviceOptions связанный с устройством.

buildInfo IBuildInfo : Объект IBuildInfo , описывающий начальную сборку gce.

gceInstanceName String : Имя экземпляра для использования.

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

GceManager 

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

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

Параметры
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos List

Общедоступные методы

AcloudShutdown 

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

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

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

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

instanceName String : Экземпляр, который необходимо завершить.

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

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

Возвраты
boolean Верно, если успешно

очистка 

public void cleanUp ()

collectErrorSignatures 

public static void collectErrorSignatures (File remoteFile)

Параметры
remoteFile File

getBugreportzWithSsh 

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

Чтобы избежать потенциальных проблем с подключением к ADB, получите отчет об ошибке (ugreportz) с устройства, используя SSH.

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

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

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

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

Броски
java.io.IOException
IOException

getHostOrchestratorUtil 

public HostOrchestratorUtil getHostOrchestratorUtil ()

Возвращает экземпляр HostOrchestratorUtil .

Возвраты
HostOrchestratorUtil

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 В случае возникновения проблем вывод в последовательный лог или значение null.

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 bugreport), или null, если проблема возникла.

Броски
java.io.IOException
IOException

logAndDeleteFile 

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

Параметры
tempFile File

dataName String

logger ITestLogger

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, 
                String baseName, 
                List<String> scpArgs)

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

Параметры
logger ITestLogger : Объект ITestLogger куда следует записывать лог в файл.

gceAvd GceAvdInfo : Информация GceAvdInfo , описывающая устройство.

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

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

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

type LogDataType : LogDataType регистрируемого файла.

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

scpArgs List : дополнительные аргументы, передаваемые команде scp.

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

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 : Базовое имя, используемое для записи в файл. Если значение равно null, будет использоваться фактическое имя файла.

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

logSerialOutput 

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

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

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

logger ITestLogger : Объект ITestLogger , куда записываются данные в последовательный порт.

remoteSshCommandExecution 

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 содержит результат выполнения.

shutdownGce 

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 List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos, 
                MultiMap<String, String> attributes)

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

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

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

Возвраты
List< GceAvdInfo > ERROR(/List ) описание информации о среднем балле GCE.

Броски
TargetSetupError

startMultiDevicesGce 

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos)

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

Параметры
buildInfos List

Возвраты
List< GceAvdInfo >

Броски
TargetSetupError

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

buildShutdownCommand 

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

Параметры
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

Возвраты
List<String>

extractInstanceName 

protected String extractInstanceName (String bootupLogs)

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

Параметры
bootupLogs String

Возвраты
String