GceManager

public class GceManager
extends Object

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

Trợ lý 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

Hằng số

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

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

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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 tôi tạm thời giữ lại hàm khởi tạo 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 trực tiếp tên phiên bản GCE cần sử dụng.

Phương thức công khai

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)

Lấy bugreportz từ thiết bị bằng ssh để tránh mọi vấn đề tiềm ẩn về kết nối adb.

HostOrchestratorUtil getHostOrchestratorUtil()

Trả về thực thể của HostOrchestratorUtil.

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 thông qua ssh cho một phiên bản lồng nhau.

static void logAndDeleteFile(File tempFile, String dataName, ITestLogger logger)
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ể lồng nhau và ghi lại 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ể lồng nhau và ghi lại tệp đó.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Ghi nhật ký đầ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 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)

Thử khởi động một phiên bản gce bằng Acloud hoặc Oxygen.

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

Thử khởi động một phiên bản gce.

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

Thử khởi động một phiên bản gce bằng Acloud hoặc Oxygen.

startMultiDevicesGce( buildInfos)

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

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

Cố gắng khởi động phiên bản gce nhiều thiết bị 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 phiên bản từ nhật ký khởi động gce.

Hằng số

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Giá trị không đổi: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Giá trị không đổi: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Giá trị không đổi: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Giá trị không đổi: "gce-ip-pre-configured"

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

GceManager

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

Ctor

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 cần bắt đầu.

GceManager

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 tôi tạm thời giữ lại hàm khởi tạo này để có khả năng tương thích ngược.

Tham 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ể dùng để cung cấp trực tiếp tên phiên bản GCE cần dùng.

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 phiên bản cần sử dụng.
gceHost String: Tên máy chủ hoặc IP của phiên bản cần sử dụng.

Phương thức công khai

AcloudShutdown

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.

Tham số
options TestDeviceOptions: TestDeviceOptions cho các lựa chọn Acloud
runUtil IRunUtil: IRunUtil để chạy Acloud
instanceName String: Phiên bản cần tắt.
hostname String: tên máy chủ của thực thể, chỉ dùng cho Cuttlefish Oxygen.
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 True nếu thành công

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Lấy bugreportz từ thiết bị bằng ssh để tránh mọi vấn đề tiềm ẩn về kết nối adb.

Tham số
gceAvd GceAvdInfo: GceAvdInfo mô tả thiết bị.
options TestDeviceOptions: một TestDeviceOptions mô tả các lựa chọn thiết bị sẽ được dùng cho thiết bị GCE.
runUtil IRunUtil: một IRunUtil để thực thi các lệnh.
Giá trị trả về
File Một tệp trỏ đến báo cáo lỗi zip hoặc giá trị rỗng nếu xảy ra vấn đề.
Gửi
IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Trả về thực thể của HostOrchestratorUtil.

Giá trị trả về
HostOrchestratorUtil

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ả phiên bản.
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: một IRunUtil để thực thi các lệnh.
Giá trị trả về
String Đầu ra nhật ký nối tiếp hoặc giá trị rỗng nếu có sự cố xảy ra.

getNestedDeviceSshBugreportz

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

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

Tham số
gceAvd GceAvdInfo: GceAvdInfo mô tả thiết bị.
options TestDeviceOptions: một TestDeviceOptions mô tả các lựa chọn thiết bị sẽ được dùng cho thiết bị GCE.
runUtil IRunUtil: một IRunUtil để thực thi các lệnh.
Giá trị trả về
File Một tệp trỏ đến báo cáo lỗi zip hoặc giá trị rỗng nếu xảy ra vấn đề.
Gửi
IOException

logAndDeleteFile

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

Tham số
tempFile File

dataName String

logger ITestLogger

logDirectory

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ể lồng nhau và ghi lại 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: một TestDeviceOptions mô tả các lựa chọn thiết bị sẽ được dùng cho thiết bị GCE.
runUtil IRunUtil: một IRunUtil để thực thi các lệnh.
remoteFilePath String: Đường dẫn từ xa để tìm tệp.
type LogDataType: LogDataType của tệp được ghi nhật ký.
Giá trị trả về
boolean 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ể lồng nhau và ghi lại 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: một TestDeviceOptions mô tả các lựa chọn thiết bị sẽ được dùng cho thiết bị GCE.
runUtil IRunUtil: một IRunUtil để thực thi các lệnh.
remoteFilePath String: Đường dẫn từ xa để tìm tệp.
type LogDataType: LogDataType của tệp được 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 tệp có được ghi nhật ký 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 một thiết bị do GceAvdInfo mô tả.

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

Tham số
gceAvd GceAvdInfo: GceAvdInfo mô tả thiết bị.
options TestDeviceOptions: một TestDeviceOptions mô tả các lựa chọn thiết bị sẽ được dùng cho thiết bị GCE.
runUtil IRunUtil: một 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 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ả của quá trình thực thi.

shutdownGce

public boolean shutdownGce ()

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

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

startGce

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

Thử khởi động một phiên bản gce bằng Acloud hoặc Oxygen.

Tham 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: người dùng đang chạy trên máy chủ của AVD, null nếu không áp dụng
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 được liên kết với lệnh gọi hiện tại, dùng để truyền thông tin có thể áp dụng 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ý khởi chạy thiết bị.
Giá trị trả về
GceAvdInfo GceAvdInfo mô tả phiên bản GCE. Có thể là một phiên bản 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ử khởi động một phiên bản gce.

Tham 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, dùng để truyền thông tin có thể áp dụng 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ả phiên bản GCE. Có thể là một phiên bản 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ử khởi động một phiên bản gce bằng Acloud hoặc Oxygen.

Tham 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: người dùng đang chạy trên máy chủ của AVD, null nếu không áp dụng
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 được liên kết với lệnh gọi hiện tại, dùng để truyền thông tin có thể áp dụng 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ả phiên bản GCE. Có thể là một phiên bản BOOT_FAIL.
Gửi
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

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

Tham số
buildInfos

Giá trị trả về
Gửi
TargetSetupError

startMultiDevicesGce

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

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

Tham số
buildInfos : 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
Giá trị trả về
ERROR(/List) mô tả Thông tin về AVD GCE.
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ề

extractInstanceName

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": mẫu "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 phiên bản đã thử sẽ không xuất hiện trong json.

Tham số
bootupLogs String

Trả về
String