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
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
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,
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ố. |
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ố. |
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. |
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ị. |
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 |
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 |
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.
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.
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 |
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 |
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 |