Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

GceManager

public class GceManager
extends Object

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


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

Bản tóm tắt

Lĩnh vực

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

nhà thầu công cộng

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

giám đốc

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

Hàm tạo này không được dùng nữa. Sử dụng các hàm tạo khác, chúng tôi tạm thời giữ cái này để tương thích ngược.

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

Ctor, biến thể có thể được sử dụng để cung cấp tên đối tượng 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 máy ảo.

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

Nhận báo cáo lỗi từ thiết bị bằng ssh để tránh mọi sự cố tiềm ẩn về 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 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 phiên bản lồng nhau.

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

Tìm nạp tệp từ xa từ phiên bản lồng nhau 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 tệp từ xa từ phiên bản lồng nhau và ghi nhật ký tệp đó.

void logSerialOutput ( GceAvdInfo infos, ITestLogger logger)

Ghi nhật ký đầu ra nối tiếp của thiết bị được mô tả bởi GceAvdInfo .

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

Thực thi lệnh từ xa thông qua ssh trên một phiên bản.

boolean shutdownGce ()

Tắt phiên bản Gce được liên kết với startGce() .

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

Cố gắng bắt đầu phiên bản gce bằng Acloud hoặc Oxygen.

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

Cố gắng bắt đầu một phiên bản gce.

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

Cố gắng bắt đầu phiên bản gce bằng Acloud hoặc Oxygen.

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Phương pháp này không được chấp nhận. Xóa cái này sau khi nhánh chính được cập nhật.

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

Cố gắng khởi động phiên bản gce nhiều thiết bị với Oxygen.

phương pháp được bảo vệ

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

Xây dựng và trả lại 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 phiên bản từ nhật ký khởi động gce.

Lĩnh vực

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

nhà thầu công cộng

GceManager

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

giám đốc

Thông 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ả quá trình xây dựng gce để bắt đầu.

GceManager

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

Hàm tạo này không được dùng nữa.
Sử dụng các hàm tạo khác, chúng tôi tạm thời giữ cái này để tương thích ngược.

Thông số
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

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

Thông 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ả quá trình xây dựng gce để bắt đầu.

gceInstanceName String : Tên ví dụ sẽ sử dụng.

gceHost String : Tên máy chủ hoặc ip của phiên bản sẽ sử dụng.

Phương thức công khai

AcloudTắt máy

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

Chạy Acloud thực tế để tắt máy ảo.

Thông số
options TestDeviceOptions : TestDeviceOptions cho các tùy chọn Acloud

runUtil IRunUtil : IRunUtil để chạy Acloud

instanceName String : Ví dụ để tắt máy.

hostname String : tên máy chủ của cá thể, chỉ được sử dụng cho mực nang Oxy.

isIpPreconfigured boolean : liệu AVD có được tạo trên thiết bị từ xa với IP được cấu hình sẵn hay không

trả lại
boolean Đúng nếu thành công

dọn dẹp

public void cleanUp ()

getBugreportzWithSsh

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

Nhận báo cáo lỗi từ thiết bị bằng ssh để tránh mọi sự cố tiềm ẩn về kết nối adb.

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

options TestDeviceOptions : một TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

runUtil IRunUtil : một IRunUtil để thực thi lệnh.

trả lại
File Một tệp trỏ đến báo cáo lỗi zip hoặc null nếu xảy ra sự cố.

ném
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 phiên bản Gce Avd.

Thông số
infos GceAvdInfo : GceAvdInfo mô tả phiên bản.

avdConfigFile File : tệp cấu hình avd

jsonKeyFile File : tệp khóa json của tài khoản dịch vụ.

runUtil IRunUtil : một IRunUtil để thực thi lệnh.

trả lại
String Đầu ra nhật ký nối tiếp hoặc null nếu xảy ra sự cố.

getNestedDeviceSshBugreportz

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

Nhận báo cáo lỗi qua ssh cho một phiên bản lồng nhau. Điều này yêu cầu yêu cầu adb trong phiên bản ảo lồng nhau.

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

options TestDeviceOptions : một TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

runUtil IRunUtil : một IRunUtil để thực thi lệnh.

trả lại
File Một tệp trỏ đến báo cáo lỗi zip hoặc null nếu xảy ra sự cố.

ném
IOException

logNestedRemoteFile

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

Tìm nạp tệp từ xa từ phiên bản lồng nhau và ghi nhật ký tệp đó.

Thông số
logger ITestLogger : ITestLogger nơi ghi nhật ký tệp.

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

options TestDeviceOptions : một TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

runUtil IRunUtil : một IRunUtil để thực thi lệnh.

remoteFilePath String : Đường dẫn từ xa để tìm tệp.

type LogDataType : LogDataType của tệp đã ghi.

trả lại
boolean liệu tệp có được ghi 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 tệp từ xa từ phiên bản lồng nhau và ghi nhật ký tệp đó.

Thông số
logger ITestLogger : ITestLogger nơi ghi nhật ký tệp.

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

options TestDeviceOptions : một TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

runUtil IRunUtil : một IRunUtil để thực thi lệnh.

remoteFilePath String : Đường dẫn từ xa để tìm tệp.

type LogDataType : LogDataType của tệp đã ghi.

baseName String : Tên cơ sở để sử dụng để ghi nhật ký tệp. Nếu null, tên tệp thực tế sẽ được sử dụng.

trả lại
boolean liệu tệp có được ghi thành công hay không.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Ghi nhật ký đầu ra nối tiếp của thiết bị được mô tả bởi GceAvdInfo .

Thông số
infos GceAvdInfo : GceAvdInfo mô tả phiên bản.

logger ITestLogger : ITestLogger nơi ghi nhật ký nối tiếp.

điều khiển từ xaSshCommandExecution

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

Thực thi lệnh từ xa thông qua ssh trên một phiên bản.

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

options TestDeviceOptions : một TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

runUtil IRunUtil : một IRunUtil để thực thi 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 để thực thi.

trả lại
CommandResult CommandResult chứa kết quả thực thi.

tắt máyGce

public boolean shutdownGce ()

Tắt phiên bản Gce được liên kết với startGce() .

trả lại
boolean trả về true nếu yêu cầu tắt gce là không chặn.

bắt đầuGce

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

Cố gắng bắt đầu phiên bản gce bằng Acloud hoặc Oxygen.

Thông số
ipDevice String : IP ban đầu của phiên bản GCE để chạy AVD trong, null nếu không áp dụng

user String : người dùng đang chạy máy chủ của AVD, null nếu không áp dụng

offset Integer : phần bù số thiết bị của AVD trong Máy chủ, null nếu không áp dụng

attributes MultiMap : các thuộc tính được liên kết với lệnh gọi hiện tại, được sử dụng để chuyển thông tin áp dụng xuống phiên bản GCE để được thêm dưới dạng siêu dữ liệu VM

logger ITestLogger : ITestLogger nơi ghi nhật ký khởi chạy thiết bị.

trả lại
GceAvdInfo một GceAvdInfo mô tả phiên bản GCE. Có thể là một phiên bản BOOT_FAIL.

ném
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

bắt đầuGce

public GceAvdInfo startGce ()

trả lại
GceAvdInfo

ném
TargetSetupError

bắt đầuGce

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

Cố gắng bắt đầu một phiên bản gce.

Thông số
ipDevice String : IP ban đầu của phiên bản GCE để chạy AVD trong, null nếu không áp dụng

attributes MultiMap : các thuộc tính được liên kết với lệnh gọi hiện tại, được sử dụng để chuyển thông tin áp dụng xuống phiên bản GCE để được thêm dưới dạng siêu dữ liệu VM

trả lại
GceAvdInfo một GceAvdInfo mô tả phiên bản GCE. Có thể là một phiên bản BOOT_FAIL.

ném
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

bắt đầuGce

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

Cố gắng bắt đầu phiên bản gce bằng Acloud hoặc Oxygen.

Thông số
ipDevice String : IP ban đầu của phiên bản GCE để chạy AVD trong, null nếu không áp dụng

user String : người dùng đang chạy máy chủ của AVD, null nếu không áp dụng

offset Integer : phần bù số thiết bị của AVD trong Máy chủ, null nếu không áp dụng

attributes MultiMap : các thuộc tính được liên kết với lệnh gọi hiện tại, được sử dụng để chuyển thông tin áp dụng xuống phiên bản GCE để được thêm dưới dạng siêu dữ liệu VM

trả lại
GceAvdInfo một GceAvdInfo mô tả phiên bản GCE. Có thể là một phiên bản BOOT_FAIL.

ném
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Phương pháp này không được chấp nhận.
Xóa cái này sau khi nhánh chính được cập nhật.

Thông số
buildInfos

trả lại

ném
TargetSetupError

startMultiDevicesGce

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

Cố gắng khởi động phiên bản gce nhiều thiết bị với Oxygen.

Thông số
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : các thuộc tính được liên kết với lệnh gọi hiện tại

trả lại
một ERROR(/List ) ERROR(/List ) mô tả Thông tin GCE Avd.

ném
TargetSetupError

phương pháp được bảo vệ

buildGceCmd

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

Xây dựng và trả lại lệnh để khởi chạy GCE. Tiếp xúc để thử nghiệm.

Thông số
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

trả lại

buildShutdownCommand

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

Thông số
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

trả lại

giải nénInstanceName

protected String extractInstanceName (String bootupLogs)

Truy xuất tên phiên bản từ nhật ký khởi động gce. Tìm kiếm 'tên': 'gce- ' mẫu để trích xuất tên của nó. 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 bị lỗi, tên phiên bản đã thử sẽ không hiển thị trong json.

Thông số
bootupLogs String

trả lại
String