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

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ố tiềm ẩn 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ệ

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.
Hãy 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ố tiềm ẩn 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ẽ được 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. Điều này đòi hỏi việc yêu cầu adb trong thực thể ảo.

Tham số
gceAvd GceAvdInfo: GceAvdInfo mô tả thiết bị.

options TestDeviceOptions: TestDeviceOptions mô tả các tuỳ chọn thiết bị sẽ được 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ẽ được 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ẽ được 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 rỗng, tên tệp thực tế sẽ là đã 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ẽ được 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ó thích hợp

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 thích hợp

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 xuống phiên bản GCE sẽ được thêm 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ó thích hợp

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 xuống phiên bản GCE sẽ được thêm 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ó thích hợp

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 thích hợp

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 xuống phiên bản GCE sẽ được thêm 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 dùng nữa.
Xoá phương thức 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: 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ệ

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 '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ì trên Lỗi khởi động gce, thì tên thực thể đã thử sẽ không xuất hiện trong tệp json.

Tham số
bootupLogs String

Trả về
String