Trình quản lý Gce

public class GceManager
extends Object

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

---

Trình trợ giúp giúp quản lý các lệnh gọi GCE để bắt đầu/dừng và thu thập nhật ký từ GCE.

Tóm tắt

Trường
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

Hàm khởi tạo công khai
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo) Giám đốc
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) Hàm khởi tạo này không được dùng nữa. Hãy dùng các hàm khởi tạo khác, chúng ta sẽ tạm thời giữ lại hàm này để có khả năng tương thích ngược.
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost) Ctor, biến thể có thể dùng để cung cấp tên thực thể GCE để sử dụng trực tiếp.

Phương thức công khai
static boolean	AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured) Chạy Acloud thực tế để tắt thiết bị ảo.
void	cleanUp()
static File	getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Tạo báo cáo lỗi từ thiết bị bằng cách sử dụng ssh để tránh mọi sự cố có thể xảy ra khi kết nối adb.
static String	getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil) Đọc nội dung hiện tại của nhật ký nối tiếp của phiên bản Gce Avd.
static File	getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Nhận báo cáo lỗi qua ssh cho một thực thể được lồng.
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) Tìm nạp một tệp từ xa từ một thực thể được lồng và ghi nhật ký tệp đó.
static boolean	logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName) Tìm nạp một tệp từ xa từ một thực thể được lồng và ghi nhật ký tệp đó.
void	logSerialOutput(GceAvdInfo infos, ITestLogger logger) Ghi lại đầu ra nối tiếp của một thiết bị do GceAvdInfo mô tả.
static CommandResult	remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command) Thực thi lệnh từ xa qua ssh trên một thực thể.
boolean	shutdownGce() Tắt thực thể Gce liên kết với startGce().
GceAvdInfo	startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger) Thử bắt đầu một thực thể gce bằng Acloud hoặc Oxy.
GceAvdInfo	startGce()
GceAvdInfo	startGce(String ipDevice, MultiMap<String, String> attributes) Thử bắt đầu một thực thể gce.
GceAvdInfo	startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes) Thử bắt đầu một thực thể gce bằng Acloud hoặc Oxy.
	startMultiDevicesGce( buildInfos) Phương thức này không được dùng nữa. Hãy xoá phương thức này sau khi cập nhật nhánh chính.
	startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes) Thử khởi động phiên bản nhiều thiết bị trong Google Chrome bằng Oxygen.

Phương thức được bảo vệ
	buildGceCmd(File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap<String, String> attributes) Tạo bản dựng và trả về lệnh để khởi chạy GCE.
static	buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)
String	extractInstanceName(String bootupLogs) Truy xuất tên thực thể từ nhật ký khởi động gce.

Trường

GCE_FERPA_KEY

public static final String GCE_HOSTNAME_KEY

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Hàm GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Hàm khởi tạo công khai

Trình quản lý Gce

public GceManager (DeviceDescriptor deviceDesc, 
                TestDeviceOptions deviceOptions, 
                IBuildInfo buildInfo)

Giám đốc

Tham số
deviceDesc	DeviceDescriptor: DeviceDescriptor sẽ được liên kết với thiết bị GCE.
deviceOptions	TestDeviceOptions: Một TestDeviceOptions được liên kết với thiết bị.
buildInfo	IBuildInfo: Một IBuildInfo mô tả bản dựng gce để bắt đầu.

Trình quản lý Gce

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

Hàm khởi tạo này không còn được dùng nữa.
Sử dụng các hàm khởi tạo khác, chúng ta sẽ tạm thời giữ lại hàm này để có khả năng tương thích ngược.

Tham số
deviceDesc	DeviceDescriptor
deviceOptions	TestDeviceOptions
buildInfo	IBuildInfo
testResourceBuildInfos

Trình quản lý Gce

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

Ctor, biến thể có thể dùng để cung cấp tên thực thể GCE để sử dụng trực tiếp.

Tham số
deviceDesc	DeviceDescriptor: DeviceDescriptor sẽ được liên kết với thiết bị GCE.
deviceOptions	TestDeviceOptions: Một TestDeviceOptions được liên kết với thiết bị
buildInfo	IBuildInfo: Một IBuildInfo mô tả bản dựng gce để bắt đầu.
gceInstanceName	String: Tên thực thể cần sử dụng.
gceHost	String: Tên máy chủ lưu trữ hoặc ip của thực thể cần sử dụng.

Phương thức công khai

Tắt đám mây

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

Chạy Acloud thực tế để tắt thiết bị ảo.

Tham số
options	TestDeviceOptions: TestDeviceOptions cho các tuỳ chọn Acloud
runUtil	IRunUtil: IRunUtil để điều hành Acloud
instanceName	String: Thực thể cần tắt.
hostname	String: tên máy chủ của thực thể, chỉ dùng cho mực nang Oxy.
isIpPreconfigured	boolean: liệu AVD có được tạo trên một thiết bị từ xa có IP được định cấu hình sẵn hay không

Giá trị trả về
boolean	Đúng nếu thành công

dọn dẹp

public void cleanUp ()

getBugreportzVớiSsh

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

Tạo báo cáo lỗi từ thiết bị bằng cách sử dụng ssh để tránh mọi sự cố có thể xảy ra khi kết nối adb.

Tham số
gceAvd	GceAvdInfo: GceAvdInfo mô tả thiết bị.
options	TestDeviceOptions: TestDeviceOptions mô tả các tuỳ chọn thiết bị sẽ dùng cho thiết bị GCE.
runUtil	IRunUtil: IRunUtil để thực thi các lệnh.

Giá trị trả về
File	Tệp trỏ đến báo cáo lỗi zip hoặc rỗng nếu xảy ra vấn đề.

Gửi
	IOException

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

Đọc nội dung hiện tại của nhật ký nối tiếp của phiên bản Gce Avd.

Tham số
infos	GceAvdInfo: GceAvdInfo mô tả thực thể.
avdConfigFile	File: tệp cấu hình avd
jsonKeyFile	File: tệp khoá json của tài khoản dịch vụ.
runUtil	IRunUtil: IRunUtil để thực thi các lệnh.

Giá trị trả về
String	Kết quả nhật ký nối tiếp hoặc giá trị rỗng nếu có sự cố.

getnestDeviceSshBugreportz

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

Nhận báo cáo lỗi qua ssh cho một thực thể được lồng. Việc này đòi hỏi bạn phải yêu cầu adb trong thực thể ảo lồng nhau.

Tham số
gceAvd	GceAvdInfo: GceAvdInfo mô tả thiết bị.
options	TestDeviceOptions: TestDeviceOptions mô tả các tuỳ chọn thiết bị sẽ dùng cho thiết bị GCE.
runUtil	IRunUtil: IRunUtil để thực thi các lệnh.

Giá trị trả về
File	Tệp trỏ đến báo cáo lỗi zip hoặc rỗng nếu xảy ra vấn đề.

Gửi
	IOException

thư mục nhật ký

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

Tham số
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)

Tìm nạp một tệp từ xa từ một thực thể được lồng và ghi nhật ký tệp đó.

Tham số
logger	ITestLogger: ITestLogger nơi ghi nhật ký tệp.
gceAvd	GceAvdInfo: GceAvdInfo mô tả thiết bị.
options	TestDeviceOptions: TestDeviceOptions mô tả các tuỳ chọn thiết bị sẽ dùng cho thiết bị GCE.
runUtil	IRunUtil: IRunUtil để thực thi các lệnh.
remoteFilePath	String: Đường dẫn từ xa nơi tìm tệp.
type	LogDataType: LogDataType của tệp đã ghi nhật ký.

Giá trị trả về
boolean	xem tệp có được ghi nhật ký thành công hay không.

logNestedRemoteFile

public static boolean logNestedRemoteFile (ITestLogger logger, 
                GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                String remoteFilePath, 
                LogDataType type, 
                String baseName)

Tìm nạp một tệp từ xa từ một thực thể được lồng và ghi nhật ký tệp đó.

Tham số
logger	ITestLogger: ITestLogger nơi ghi nhật ký tệp.
gceAvd	GceAvdInfo: GceAvdInfo mô tả thiết bị.
options	TestDeviceOptions: TestDeviceOptions mô tả các tuỳ chọn thiết bị sẽ dùng cho thiết bị GCE.
runUtil	IRunUtil: IRunUtil để thực thi các lệnh.
remoteFilePath	String: Đường dẫn từ xa nơi tìm tệp.
type	LogDataType: LogDataType của tệp đã ghi nhật ký.
baseName	String: Tên cơ sở dùng để ghi nhật ký tệp. Nếu giá trị rỗng, tên tệp thực tế sẽ được sử dụng.

Giá trị trả về
boolean	xem tệp có được ghi nhật ký thành công hay không.

đầu ra logSerial

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Ghi lại đầu ra nối tiếp của một thiết bị do GceAvdInfo mô tả.

Tham số
infos	GceAvdInfo: GceAvdInfo mô tả thực thể.
logger	ITestLogger: ITestLogger nơi ghi nhật ký nối tiếp.

thực thi từ xaSshCommand

public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd, 
                TestDeviceOptions options, 
                IRunUtil runUtil, 
                long timeoutMs, 
                String... command)

Thực thi lệnh từ xa qua ssh trên một thực thể.

Tham số
gceAvd	GceAvdInfo: GceAvdInfo mô tả thiết bị.
options	TestDeviceOptions: TestDeviceOptions mô tả các tuỳ chọn thiết bị sẽ dùng cho thiết bị GCE.
runUtil	IRunUtil: IRunUtil để thực thi các lệnh.
timeoutMs	long: Thời gian chờ tính bằng mili giây cho lệnh. 0 có nghĩa là không có thời gian chờ.
command	String: Lệnh từ xa cần thực thi.

Giá trị trả về
CommandResult	CommandResult chứa kết quả thực thi.

CANNOT TRANSLATE

public boolean shutdownGce ()

Tắt thực thể Gce liên kết với startGce().

Giá trị trả về
boolean	trả về true nếu lệnh tắt gce được yêu cầu dưới dạng không chặn.

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes, 
                ITestLogger logger)

Thử bắt đầu một thực thể gce bằng Acloud hoặc Oxy.

Tham số
ipDevice	String: IP ban đầu của thực thể GCE để chạy AVD, null nếu không có
user	String: máy chủ lưu trữ đang chạy người dùng AVD, null nếu không có
offset	Integer: độ lệch số thiết bị của AVD trong máy chủ lưu trữ, null nếu không áp dụng
attributes	MultiMap: các thuộc tính liên kết với lệnh gọi hiện tại, dùng để truyền thông tin hiện hành xuống thực thể GCE để thêm vào dưới dạng siêu dữ liệu máy ảo
logger	ITestLogger: ITestLogger nơi để ghi nhật ký chạy thiết bị.

Giá trị trả về
GceAvdInfo	GceAvdInfo mô tả thực thể GCE. Có thể là một thực thể BOOT_FAIL.

Gửi
	com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Giá trị trả về
GceAvdInfo

Gửi
TargetSetupError

startGce

public GceAvdInfo startGce (String ipDevice, 
                MultiMap<String, String> attributes)

Thử bắt đầu một thực thể gce.

Tham số
ipDevice	String: IP ban đầu của thực thể GCE để chạy AVD, null nếu không có
attributes	MultiMap: các thuộc tính liên kết với lệnh gọi hiện tại, dùng để truyền thông tin hiện hành xuống thực thể GCE để thêm vào dưới dạng siêu dữ liệu máy ảo

Giá trị trả về
GceAvdInfo	GceAvdInfo mô tả thực thể GCE. Có thể là một thực thể BOOT_FAIL.

Gửi
	com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce (String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

Thử bắt đầu một thực thể gce bằng Acloud hoặc Oxy.

Tham số
ipDevice	String: IP ban đầu của thực thể GCE để chạy AVD, null nếu không có
user	String: máy chủ lưu trữ đang chạy người dùng AVD, null nếu không có
offset	Integer: độ lệch số thiết bị của AVD trong máy chủ lưu trữ, null nếu không áp dụng
attributes	MultiMap: các thuộc tính liên kết với lệnh gọi hiện tại, dùng để truyền thông tin hiện hành xuống thực thể GCE để thêm vào dưới dạng siêu dữ liệu máy ảo

Giá trị trả về
GceAvdInfo	GceAvdInfo mô tả thực thể GCE. Có thể là một thực thể BOOT_FAIL.

Gửi
	com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

khởi động nhiều thiết bịGce

public  startMultiDevicesGce ( buildInfos)

Phương thức này không còn được dùng nữa.
Xoá nút này sau khi cập nhật nhánh chính.

Tham số
buildInfos

Giá trị trả về

Gửi
TargetSetupError

khởi động nhiều thiết bịGce

public  startMultiDevicesGce ( buildInfos, 
                MultiMap<String, String> attributes)

Thử khởi động phiên bản nhiều thiết bị trong Google Chrome bằng Oxygen.

Tham số
buildInfos	: ERROR(/List)
attributes	MultiMap: các thuộc tính liên kết với lệnh gọi hiện tại

Giá trị trả về
	ERROR(/List) mô tả Thông tin GCE Avd.

Gửi
TargetSetupError

Phương thức được bảo vệ

buildGceCmd

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

Tạo bản dựng và trả về lệnh để khởi chạy GCE. Được sử dụng để kiểm thử.

Tham số
reportFile	File
b	IBuildInfo
ipDevice	String
user	String
offset	Integer
attributes	MultiMap

Giá trị trả về

buildShutdownCommand

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

Tham số
config	File
options	TestDeviceOptions
instanceName	String
hostname	String
isIpPreconfigured	boolean

Giá trị trả về

trích xuấtInstanceName

protected String extractInstanceName (String bootupLogs)

Truy xuất tên thực thể từ nhật ký khởi động gce. Tìm kiếm mẫu "name": "gce-" để trích xuất tên của mẫu đó. Chúng tôi trích xuất từ nhật ký thay vì tệp kết quả vì khi khởi động gce không thành công, tên thực thể đã thử sẽ không xuất hiện trong json.

Tham số
bootupLogs	String

Giá trị trả về
String