GceManager

public class GceManager
extends Object

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

Helper yang mengelola panggilan GCE untuk memulai/menghentikan dan mengumpulkan log dari GCE.

Ringkasan

Konstanta

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

Konstruktor publik

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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

Konstruktor ini tidak digunakan lagi. Gunakan konstruktor lain, kami menyimpan ini untuk sementara demi kompatibilitas mundur.

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

Ctor, variasi yang dapat digunakan untuk memberikan nama instance GCE yang akan digunakan secara langsung.

Metode publik

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

Menjalankan Acloud sebenarnya untuk mematikan perangkat virtual.

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

Dapatkan bugreportz dari perangkat menggunakan SSH untuk menghindari potensi masalah koneksi ADB.

HostOrchestratorUtil getHostOrchestratorUtil()

Menampilkan instance HostOrchestratorUtil.

static String getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)

Membaca konten saat ini dari log serial instance Gce Avd.

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

Mendapatkan laporan bug melalui SSH untuk instance bertingkat.

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)

Mengambil file jarak jauh dari instance bertingkat dan mencatatnya.

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

Mengambil file jarak jauh dari instance bertingkat dan mencatatnya.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Mencatat output serial perangkat yang dijelaskan oleh GceAvdInfo.

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

Jalankan perintah jarak jauh melalui SSH pada instance.

boolean shutdownGce()

Matikan instance GCE yang terkait dengan startGce().

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

Coba mulai instance GCE dengan Acloud atau Oxygen.

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

Mencoba memulai instance GCE.

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

Coba mulai instance GCE dengan Acloud atau Oxygen.

startMultiDevicesGce( buildInfos)

Metode ini tidak digunakan lagi. Hapus ini setelah cabang master diperbarui.

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

Mencoba memulai instance GCE multi-perangkat dengan Oxygen.

Metode yang dilindungi

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

Ambil nama instance dari log booting GCE.

Konstanta

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Nilai Konstanta: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Nilai Konstanta: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Nilai Konstanta: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Nilai Konstanta: "gce-ip-pre-configured"

Konstruktor publik

GceManager

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

Ctor

Parameter
deviceDesc DeviceDescriptor: DeviceDescriptor yang akan dikaitkan dengan perangkat GCE.
deviceOptions TestDeviceOptions: TestDeviceOptions yang terkait dengan perangkat.
buildInfo IBuildInfo: IBuildInfo yang menjelaskan build GCE yang akan dimulai.

GceManager

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

Konstruktor ini tidak digunakan lagi.
Gunakan konstruktor lain, kami menyimpannya untuk sementara demi kompatibilitas mundur.

Parameter
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

Ctor, variasi yang dapat digunakan untuk memberikan nama instance GCE yang akan digunakan secara langsung.

Parameter
deviceDesc DeviceDescriptor: DeviceDescriptor yang akan dikaitkan dengan perangkat GCE.
deviceOptions TestDeviceOptions: TestDeviceOptions yang terkait dengan perangkat
buildInfo IBuildInfo: IBuildInfo yang menjelaskan build GCE yang akan dimulai.
gceInstanceName String: Nama instance yang akan digunakan.
gceHost String: Nama host atau IP instance yang akan digunakan.

Metode publik

AcloudShutdown

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

Menjalankan Acloud sebenarnya untuk mematikan perangkat virtual.

Parameter
options TestDeviceOptions: TestDeviceOptions untuk opsi Acloud
runUtil IRunUtil: IRunUtil untuk menjalankan Acloud
instanceName String: Instance yang akan dimatikan.
hostname String: nama host instance, hanya digunakan untuk Cuttlefish Oxygen.
isIpPreconfigured boolean: apakah AVD dibuat di perangkat jarak jauh dengan IP yang telah dikonfigurasi sebelumnya
Hasil
boolean Benar jika berhasil

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Dapatkan bugreportz dari perangkat menggunakan SSH untuk menghindari potensi masalah koneksi ADB.

Parameter
gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.
options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
runUtil IRunUtil: IRunUtil untuk menjalankan perintah.
Hasil
File File yang mengarah ke laporan bug zip, atau null jika terjadi masalah.
Menampilkan
IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Menampilkan instance HostOrchestratorUtil.

Hasil
HostOrchestratorUtil

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

Membaca konten saat ini dari log serial instance Gce Avd.

Parameter
infos GceAvdInfo: GceAvdInfo yang menjelaskan instance.
avdConfigFile File: file konfigurasi AVD
jsonKeyFile File: file kunci json akun layanan.
runUtil IRunUtil: IRunUtil untuk menjalankan perintah.
Hasil
String Output log serial atau null jika terjadi masalah.

getNestedDeviceSshBugreportz

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

Mendapatkan laporan bug melalui SSH untuk instance bertingkat. Hal ini memerlukan permintaan adb di instance virtual bertingkat.

Parameter
gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.
options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
runUtil IRunUtil: IRunUtil untuk menjalankan perintah.
Hasil
File File yang mengarah ke laporan bug zip, atau null jika terjadi masalah.
Menampilkan
IOException

logAndDeleteFile

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

Parameter
tempFile File

dataName String

logger ITestLogger

logDirectory

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

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

Mengambil file jarak jauh dari instance bertingkat dan mencatatnya.

Parameter
logger ITestLogger: ITestLogger tempat mencatat file.
gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.
options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
runUtil IRunUtil: IRunUtil untuk menjalankan perintah.
remoteFilePath String: Jalur jarak jauh tempat file dapat ditemukan.
type LogDataType: LogDataType dari file yang dicatat.
Hasil
boolean apakah file berhasil dicatat.

logNestedRemoteFile

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

Mengambil file jarak jauh dari instance bertingkat dan mencatatnya.

Parameter
logger ITestLogger: ITestLogger tempat mencatat file.
gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.
options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
runUtil IRunUtil: IRunUtil untuk menjalankan perintah.
remoteFilePath String: Jalur jarak jauh tempat file dapat ditemukan.
type LogDataType: LogDataType dari file yang dicatat.
baseName String: Nama dasar yang akan digunakan untuk mencatat file. Jika null, nama file sebenarnya akan digunakan.
Hasil
boolean apakah file berhasil dicatat.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Mencatat output serial perangkat yang dijelaskan oleh GceAvdInfo.

Parameter
infos GceAvdInfo: GceAvdInfo yang menjelaskan instance.
logger ITestLogger: ITestLogger tempat mencatat log serial.

remoteSshCommandExecution

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

Jalankan perintah jarak jauh melalui SSH pada instance.

Parameter
gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.
options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.
runUtil IRunUtil: IRunUtil untuk menjalankan perintah.
timeoutMs long: Waktu tunggu dalam milidetik untuk perintah. 0 berarti tidak ada waktu tunggu.
command String: Perintah jarak jauh yang akan dieksekusi.
Hasil
CommandResult CommandResult yang berisi hasil eksekusi.

shutdownGce

public boolean shutdownGce ()

Matikan instance GCE yang terkait dengan startGce().

Hasil
boolean menampilkan nilai benar jika penonaktifan GCE diminta sebagai non-blocking.

startGce

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

Coba mulai instance GCE dengan Acloud atau Oxygen.

Parameter
ipDevice String: IP awal instance GCE untuk menjalankan AVD, null jika tidak berlaku
user String: pengguna yang menjalankan host AVD, null jika tidak berlaku
offset Integer: offset nomor perangkat AVD di host, null jika tidak berlaku
attributes MultiMap: atribut yang terkait dengan pemanggilan saat ini, digunakan untuk meneruskan informasi yang berlaku ke instance GCE untuk ditambahkan sebagai metadata VM
logger ITestLogger: ITestLogger tempat untuk mencatat log peluncuran perangkat.
Hasil
GceAvdInfo GceAvdInfo yang menjelaskan instance GCE. Mungkin merupakan instance BOOT_FAIL.
Menampilkan
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Hasil
GceAvdInfo

Menampilkan
TargetSetupError

startGce

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

Mencoba memulai instance GCE.

Parameter
ipDevice String: IP awal instance GCE untuk menjalankan AVD, null jika tidak berlaku
attributes MultiMap: atribut yang terkait dengan pemanggilan saat ini, digunakan untuk meneruskan informasi yang berlaku ke instance GCE untuk ditambahkan sebagai metadata VM
Hasil
GceAvdInfo GceAvdInfo yang menjelaskan instance GCE. Mungkin merupakan instance BOOT_FAIL.
Menampilkan
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

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

Coba mulai instance GCE dengan Acloud atau Oxygen.

Parameter
ipDevice String: IP awal instance GCE untuk menjalankan AVD, null jika tidak berlaku
user String: pengguna yang menjalankan host AVD, null jika tidak berlaku
offset Integer: offset nomor perangkat AVD di host, null jika tidak berlaku
attributes MultiMap: atribut yang terkait dengan pemanggilan saat ini, digunakan untuk meneruskan informasi yang berlaku ke instance GCE untuk ditambahkan sebagai metadata VM
Hasil
GceAvdInfo GceAvdInfo yang menjelaskan instance GCE. Mungkin merupakan instance BOOT_FAIL.
Menampilkan
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Metode ini tidak digunakan lagi.
Hapus ini setelah cabang master diperbarui.

Parameter
buildInfos

Hasil
Menampilkan
TargetSetupError

startMultiDevicesGce

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

Mencoba memulai instance GCE multi-perangkat dengan Oxygen.

Parameter
buildInfos : ERROR(/List)
attributes MultiMap: atribut yang terkait dengan pemanggilan saat ini
Hasil
ERROR(/List) yang menjelaskan Info Avd GCE.
Menampilkan
TargetSetupError

Metode yang dilindungi

buildShutdownCommand

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

Parameter
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

Hasil

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Ambil nama instance dari log booting GCE. Telusuri pola 'name': 'gce-' untuk mengekstrak namanya. Kami mengekstrak dari log, bukan file hasil, karena jika terjadi kegagalan booting GCE, nama instance yang dicoba tidak akan muncul di JSON.

Parameter
bootupLogs String

Hasil
String