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 (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) Попытайтесь запустить экземпляр gce с помощью Acloud или Oxygen.
GceAvdInfo	startGce ()
GceAvdInfo	startGce (String ipDevice, MultiMap <String, String> attributes) Попытка запустить экземпляр gce.
	startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos) Попытка запустить экземпляр 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, если возникла проблема.

получить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 : удаленная команда для выполнения.

Возвращает
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.

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

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

Броски
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

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

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

Возвращает
	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