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 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
public static final String GCE_IP_PRECONFIGURED_KEY
nhà thầu 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ữ 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ố. |
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ố. |
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. |
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ị. |
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 |
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 |
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.
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.
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 |
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 |
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 |