GceManager
public class GceManager
extends Object
java.lang.Объект |
↳ | com.android.tradefed.device.cloud.GceManager |
Помощник, который управляет вызовами GCE для запуска/остановки и сбора журналов из GCE.
Краткое содержание
Публичные конструкторы |
---|
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
public static final String GCE_IP_PRECONFIGURED_KEY
Публичные конструкторы
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, если возникла проблема. |
получить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, если возникла проблема. |
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 : удаленная команда для выполнения. |
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 , куда заносятся журналы запуска устройства. |
startGce
public GceAvdInfo startGce (String ipDevice,
MultiMap<String, String> attributes)
Попытка запустить экземпляр gce.
Параметры |
---|
ipDevice | String : начальный IP-адрес экземпляра GCE для запуска AVD, null , если не применимо. |
attributes | MultiMap : атрибуты, связанные с текущим вызовом, используемые для передачи соответствующей информации в экземпляр GCE для добавления в качестве метаданных виртуальной машины. |
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 для добавления в качестве метаданных виртуальной машины. |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Этот метод устарел.
Удалите это после обновления основной ветки.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Попытка запустить экземпляр gce на нескольких устройствах с помощью Oxygen.
Защищенные методы
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 |
protected String extractInstanceName (String bootupLogs)
Получите имя экземпляра из журналов загрузки gce. Найдите «имя»: «gce- ', чтобы извлечь его имя. Мы извлекаем из журналов вместо файла результатов, потому что при сбое загрузки gce имя попытки экземпляра не будет отображаться в json.
Параметры |
---|
bootupLogs | String |