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

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)

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 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 void 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()
GceAvdInfo startGce(String ipDevice, MultiMap<String, String> attributes)

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

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

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

Tạo bản dựng và trả về lệnh để khởi chạy GCE.

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

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)

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.

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

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

logNestedRemoteFile

public static void 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ý.

logNestedRemoteFile

public static void 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.

đầ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 ()

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
TargetSetupError

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

buildGceCmd

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                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

attributes MultiMap

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