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 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.

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

buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap <String, String> attributes)

Создайте и верните команду для запуска GCE.

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

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

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 : имя хоста экземпляра, используется только для каракатиц 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, если возникла проблема.

Броски
IOException

получитьInstanceSerialLog

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

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

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

shutdownGce

public boolean shutdownGce ()

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

Возвращает
boolean возвращает истину, если отключение 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 Info.

Броски
TargetSetupError

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

buildGceCmd

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

Создайте и верните команду для запуска GCE. Выставлен на тестирование.

Параметры
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

Возвращает

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