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) Mencoba memulai 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
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 menyimpannya sementara untuk 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. Ini memerlukan permintaan adb di direktori bertingkat instance virtual.

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 {i>null<i}, nama file yang sebenarnya akan menjadi data

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 panggilan saat ini, digunakan untuk meneruskan 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 panggilan saat ini, digunakan untuk meneruskan 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 panggilan saat ini, digunakan untuk meneruskan 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

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 'nama': 'gce-' untuk mengekstrak namanya. Kita ekstrak dari log, bukan file hasil karena pada kegagalan booting gce, nama instance yang dicoba tidak akan ditampilkan di json.

Parameter
bootupLogs	String

Hasil
String