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 xây dựng công cộng

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

bác sĩ

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ữ nó để 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 phiên bản GCE để sử dụng trực tiếp.

Phương pháp công cộng

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

Acloud thực tế chạy để tắt thiết bị ả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ố 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 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 một tệp từ xa từ một phiên bản lồng nhau và ghi lại nó.

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 phiên bản lồng nhau và ghi lại nó.

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 khởi động 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 khởi động phiên bản gce bằng Acloud hoặc Oxygen.

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Phương pháp này không được dùng nữa. Loại bỏ điều 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 của nhiều thiết bị bằng Oxygen.

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

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

Build 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)

Lấy tên dụ 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_PRECOCONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Nhà thầu xây dựng công cộng

GceManager

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

bác sĩ

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 : 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ữ nó để 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 phiên bản 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 : IBuildInfo mô tả quá trình xây dựng gce để bắt đầu.

gceInstanceName String : Tên phiên bản 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 pháp công cộng

AcloudTắt máy

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

Acloud thực tế chạy để tắt thiết bị ả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 instance, chỉ dùng cho mực Oxy.

isIpPreconfigured boolean : AVD có được tạo trên thiết bị từ xa có 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ố có thể xảy ra khi kết nối adb.

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

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

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

Trả lại
File Một tệp trỏ tới báo cáo lỗi zip hoặc không có giá trị 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 : IRunUtil để thực thi lệnh.

Trả lại
String Đầu ra nhật ký nối tiếp hoặc null nếu có 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 : TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

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

Trả lại
File Một tệp trỏ tới báo cáo lỗi zip hoặc không có giá trị 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 một tệp từ xa từ một phiên bản lồng nhau và ghi lại nó.

Thông 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 tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

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

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

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

Trả lại
boolean liệu tập tin 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 một tệp từ xa từ một phiên bản lồng nhau và ghi lại nó.

Thông 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 tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

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

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

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

baseName String : Tên cơ sở được 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 tin có được ghi thành công hay không.

logSerialĐầu ra

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.

remoteSshCommandExecution

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 : TestDeviceOptions mô tả các tùy chọn thiết bị sẽ được sử dụng cho thiết bị GCE.

runUtil IRunUtil : 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 tắt gce được yêu cầu 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 khởi động 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, null nếu không áp dụng

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

offset Integer : độ lệch 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 có thể á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 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, 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 có thể á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 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 khởi động 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, null nếu không áp dụng

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

offset Integer : độ lệch 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 có thể á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 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 đầuMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Phương pháp này không được dùng nữa.
Loại bỏ điều này sau khi nhánh chính được cập nhật.

Thông số
buildInfos

Trả lại

Ném
TargetSetupError

bắt đầuMultiDevicesGce

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

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

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

attributes MultiMap : các thuộc tính liên quan đến 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ệ

xây dựngGceCmd

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

Build và trả về 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

lệnh buildShutdown

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

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Lấy tên dụ 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 không thành công, tên phiên bản đã thử sẽ không hiển thị trong json.

Thông số
bootupLogs String

Trả lại
String