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)

Ctor

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)

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

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)

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

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, 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-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)

Ctor

Параметры
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-адрес используемого экземпляра.

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

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 ()

getBugreportzWithSsh 

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

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

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

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

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

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

Броски
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 Вывод последовательного журнала или ноль, если что-то пойдет не так.

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

Броски
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)

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

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

выключение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 )

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

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

Броски
TargetSetupError

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

buildShutdownCommand 

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