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

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)

Ctor

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

Konstruktor ini tidak digunakan lagi. Gunakan konstruktor lain, kami mempertahankannya untuk sementara waktu untuk 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)

Acloud yang sebenarnya berjalan 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 bugreport 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 ke 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 ke dalam log.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Mencatat output serial perangkat yang dijelaskan oleh GceAvdInfo ke dalam log.

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)

Mencoba memulai 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)

Mencoba memulai 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 multiperangkat 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.

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

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 mempertahankannya untuk sementara waktu untuk 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)

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

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 mengeksekusi perintah.

Hasil
File File yang mengarah ke bugreport 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 mendeskripsikan instance.

avdConfigFile File: file konfigurasi avd

jsonKeyFile File: file kunci json akun layanan.

runUtil IRunUtil: IRunUtil untuk mengeksekusi perintah.

Hasil
String Output log serial atau null jika terjadi masalah.

getNestedDeviceSshBugreportz

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

Mendapatkan bugreport 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 mengeksekusi perintah.

Hasil
File File yang mengarah ke bugreport 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 ke dalam log.

Parameter
logger ITestLogger: ITestLogger tempat file dicatat ke dalam log.

gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.

options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.

runUtil IRunUtil: IRunUtil untuk mengeksekusi perintah.

remoteFilePath String: Jalur jarak jauh tempat file ditemukan.

type LogDataType: LogDataType file yang dicatat ke dalam log.

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

Parameter
logger ITestLogger: ITestLogger tempat file dicatat ke dalam log.

gceAvd GceAvdInfo: GceAvdInfo yang mendeskripsikan perangkat.

options TestDeviceOptions: TestDeviceOptions yang menjelaskan opsi perangkat yang akan digunakan untuk perangkat GCE.

runUtil IRunUtil: IRunUtil untuk mengeksekusi perintah.

remoteFilePath String: Jalur jarak jauh tempat file ditemukan.

type LogDataType: LogDataType file yang dicatat ke dalam log.

baseName String: Nama dasar yang akan digunakan untuk mencatat file ke dalam log. Jika null, nama file yang 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 ke dalam log.

Parameter
infos GceAvdInfo: GceAvdInfo yang mendeskripsikan 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 mengeksekusi 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 true jika penghentian gce diminta sebagai non-pemblokiran.

startGce

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

Mencoba memulai 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 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)

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

Mencoba memulai 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 yang akan 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)

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

Parameter
bootupLogs String

Hasil
String