Pengelola Gce

public class GceManager
extends Object

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


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

Ringkasan

Kolom

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

Konstruktor publik

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ktor

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

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

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

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

Metode publik

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

Acloud yang sebenarnya dijalankan untuk mematikan perangkat virtual.

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

Mendapatkan bugreportz dari perangkat menggunakan ssh untuk menghindari potensi masalah koneksi adb.

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

Membaca konten log seri instance Gce Avd saat ini.

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

Dapatkan laporan bug melalui ssh untuk instance bertingkat.

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 dalam log.

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 dalam log.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Catat output seri 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 Oksigen.

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

Coba mulai instance gce.

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

Coba mulai instance gce dengan Acloud atau Oksigen.

startMultiDevicesGce( buildInfos)

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

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

Coba mulai instance gce multi-perangkat dengan Oksigen.

Metode yang dilindungi

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

Buat dan tampilkan perintah untuk meluncurkan GCE.

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

Ambil nama instance dari log booting gce.

Kolom

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_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Konstruktor publik

Pengelola Gce

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

Ktor

Parameter
deviceDesc DeviceDescriptor: DeviceDescriptor yang akan dikaitkan dengan perangkat GCE.

deviceOptions TestDeviceOptions: TestDeviceOptions yang terkait dengan perangkat.

buildInfo IBuildInfo: IBuildInfo yang menjelaskan build gce untuk memulai.

Pengelola Gce

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

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

Parameter
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

Pengelola Gce

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

Ktor, variasi yang dapat digunakan untuk memberikan nama instance GCE untuk 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 untuk memulai.

gceInstanceName String: Nama instance yang akan digunakan.

gceHost String: Nama host atau IP instance yang akan digunakan.

Metode publik

Penonaktifan Acloud

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

Acloud yang sebenarnya dijalankan 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 sotong Oksigen.

isIpPreconfigured boolean: apakah AVD dibuat pada perangkat jarak jauh dengan IP yang telah dikonfigurasi sebelumnya

Hasil
boolean True jika berhasil

pembersihan

public void cleanUp ()

getBugreportzWithSsh

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

Mendapatkan 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

getInstanceSerialLog

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

Membaca konten log seri instance Gce Avd saat ini.

Parameter
infos GceAvdInfo: GceAvdInfo yang mendeskripsikan 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)

Dapatkan laporan bug melalui ssh untuk instance bertingkat. Hal ini memerlukan permintaan adb dalam 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

logDirektori

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 dalam log.

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 menemukan file.

type LogDataType: LogDataType file yang dicatat dalam log.

Hasil
boolean apakah file berhasil dicatat dalam log.

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 dalam log.

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 menemukan file.

type LogDataType: LogDataType file yang dicatat dalam log.

baseName String: Nama dasar yang akan digunakan untuk mencatat file ke dalam log. Jika null, nama file sebenarnya akan digunakan.

Hasil
boolean apakah file berhasil dicatat dalam log.

{i>logSerialOutput<i}

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Catat output seri perangkat yang dijelaskan oleh GceAvdInfo.

Parameter
infos GceAvdInfo: GceAvdInfo yang mendeskripsikan instance.

logger ITestLogger: ITestLogger tempat untuk mencatat log seri.

{i>remoteSshCommandExecution<i}

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 untuk dijalankan.

Hasil
CommandResult CommandResult yang berisi hasil eksekusi.

shutdownGce

public boolean shutdownGce ()

Matikan instance Gce yang terkait dengan startGce().

Hasil
boolean akan menampilkan true (benar) jika penonaktifan gce diminta sebagai tidak memblokir.

startGce

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

Coba mulai instance gce dengan Acloud atau Oksigen.

Parameter
ipDevice String: IP awal instance GCE untuk menjalankan AVD, null jika tidak berlaku

user String: host yang menjalankan pengguna AVD, null jika tidak berlaku

offset Integer: offset angka 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 mencatat log peluncuran perangkat.

Hasil
GceAvdInfo GceAvdInfo yang mendeskripsikan instance GCE. Dapat berupa 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)

Coba mulai 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 mendeskripsikan instance GCE. Dapat berupa 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 Oksigen.

Parameter
ipDevice String: IP awal instance GCE untuk menjalankan AVD, null jika tidak berlaku

user String: host yang menjalankan pengguna AVD, null jika tidak berlaku

offset Integer: offset angka 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 mendeskripsikan instance GCE. Dapat berupa 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)

Coba mulai instance gce multi-perangkat dengan Oksigen.

Parameter
buildInfos : ERROR(/List)

attributes MultiMap: atribut yang terkait dengan pemanggilan saat ini

Hasil
ERROR(/List) yang mendeskripsikan GCE Avd Info.

Menampilkan
TargetSetupError

Metode yang dilindungi

buildGceCmd

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

Buat dan tampilkan perintah untuk meluncurkan GCE. Terekspos untuk pengujian.

Parameter
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

Hasil

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 kegagalan booting gce, nama instance yang dicoba tidak akan ditampilkan dalam json.

Parameter
bootupLogs String

Hasil
String