GceManager

public class GceManager
extends Object

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


Pomocnik, który zarządza wywołaniami GCE do uruchamiania i zatrzymywania oraz zbiera logi z GCE.

Podsumowanie

Fieldsem

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

Konstruktory publiczne

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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

Ten konstruktor został wycofany. Użyj innych konstruktorów, tymczasowo zachowujemy tę opcję ze względu na zgodność wsteczną.

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

Konstruktor, wariant, który może służyć do podawania nazwy instancji GCE do bezpośredniego użycia.

Metody publiczne

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

Rzeczywiste uruchomienie Acloud w celu wyłączenia urządzenia wirtualnego.

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

Aby uniknąć potencjalnych problemów z połączeniem ADB, pobierz raport o błędzie z urządzenia za pomocą ssh.

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

Odczytuje bieżącą zawartość logu seryjnego instancji Gce Avd.

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

Pobierz raport o błędach dla zagnieżdżonej instancji przez SSH.

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)

Pobierz plik zdalny z zagłębionej instancji i zapisz go w dzienniku.

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

Pobierz plik zdalny z zagłębionej instancji i zapisz go w dzienniku.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Zarejestruj wyjście szeregowe urządzenia opisanego przez GceAvdInfo.

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

Wykonaj polecenie zdalne za pomocą ssh na instancji.

boolean shutdownGce()

Zamknij instancję GCE powiązaną z startGce().

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

Spróbuj uruchomić instancję gce za pomocą Acloud lub Oxygen.

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

Próbuje uruchomić instancję gce.

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

Spróbuj uruchomić instancję gce za pomocą Acloud lub Oxygen.

startMultiDevicesGce( buildInfos)

Ta metoda została wycofana. Usuń to po zaktualizowaniu gałęzi głównej.

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

Próba uruchomienia instancji GCE na wielu urządzeniach za pomocą Oxygen.

Chronione metody

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

Pobierz nazwę instancji z logów rozruchu gce.

Fieldsem

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Klucz nazwy instancji GCE

public static final String GCE_INSTANCE_NAME_KEY

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Konstruktory publiczne

GceManager

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

Ctor

Parametry
deviceDesc DeviceDescriptor: DeviceDescriptor, który zostanie powiązany z urządzeniem GCE.

deviceOptions TestDeviceOptions: TestDeviceOptions powiązany z tym urządzeniem.

buildInfo IBuildInfo: IBuildInfo opisujący kompilację gce na początek.

GceManager

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

Ten konstruktor został wycofany.
Użyj innych konstruktorów. Zachowujemy to tymczasowo ze względu na zgodność wsteczną.

Parametry
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

Użytkownik, odmiana, której można użyć do bezpośredniego przekazania nazwy instancji GCE.

Parametry
deviceDesc DeviceDescriptor: DeviceDescriptor, który zostanie powiązany z urządzeniem GCE.

deviceOptions TestDeviceOptions: TestDeviceOptions powiązany z tym urządzeniem

buildInfo IBuildInfo: IBuildInfo opisujący wersję gce do uruchomienia.

gceInstanceName String: nazwa instancji do użycia.

gceHost String: nazwa hosta lub adres IP instancji, której chcesz użyć.

Metody publiczne

AcloudShutdown

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

Rzeczywiste uruchomienie Acloud w celu wyłączenia urządzenia wirtualnego.

Parametry
options TestDeviceOptions: TestDeviceOptions dla opcji Acloud

runUtil IRunUtil: IRunUtil potrzebne do uruchomienia Acloud

instanceName String: instancja do wyłączenia.

hostname String: nazwa hosta instancji, używana tylko w przypadku cuttlefisha Oxygen.

isIpPreconfigured boolean: czy maszyna wirtualna została utworzona na urządzeniu zdalnym z wstępnie skonfigurowanym adresem IP

Zwroty
boolean Wartość true, jeśli operacja zakończyła się powodzeniem

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Aby uniknąć potencjalnych problemów z połączeniem adb, wyślij z urządzenia raport o błędzie przez SSH.

Parametry
gceAvd GceAvdInfo: GceAvdInfo opisujące urządzenie.

options TestDeviceOptions: TestDeviceOptions opisujący opcje urządzenia używane na urządzeniu GCE.

runUtil IRunUtil: IRunUtil do wykonywania poleceń.

Zwroty
File Plik wskazujący na plik ZIP z informacjami o błędzie lub null, jeśli wystąpił problem.

Rzuty
IOWyjątek

getInstanceSerialLog

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

Odczytuje bieżącą zawartość logu seryjnego instancji Gce Avd.

Parametry
infos GceAvdInfo: GceAvdInfo opisujący instancję.

avdConfigFile File: plik konfiguracji avd

jsonKeyFile File: plik klucza JSON konta usługi.

runUtil IRunUtil: IRunUtil do wykonywania poleceń.

Zwroty
String Dane wyjściowe dziennika szeregowego lub wartość null w przypadku wystąpienia problemów.

getNestedDeviceSshBugreportz

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

Pobieranie raportu o błędach za pomocą ssh w przypadku zagłębionej instancji. Wymaga to wysłania żądania adb w zagnieżdżonym wystąpieniu wirtualnym.

Parametry
gceAvd GceAvdInfo: GceAvdInfo opisujące urządzenie.

options TestDeviceOptions: TestDeviceOptions opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.

runUtil IRunUtil: IRunUtil do wykonywania poleceń.

Zwroty
File Plik wskazujący na plik ZIP z informacjami o błędzie lub null, jeśli wystąpił problem.

Rzuty
IOException

logAndDeleteFile

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

Parametry
tempFile File

dataName String

logger ITestLogger

katalog logów

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

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

Pobierz plik zdalny z zagnieżdżonej instancji i zapisz go.

Parametry
logger ITestLogger: ITestLogger, w którym należy zapisać plik.

gceAvd GceAvdInfo: GceAvdInfo opisujący urządzenie.

options TestDeviceOptions: TestDeviceOptions opisujący opcje urządzenia używane na urządzeniu GCE.

runUtil IRunUtil: IRunUtil do wykonywania poleceń.

remoteFilePath String: ścieżka zdalna, w której znajduje się plik.

type LogDataType: LogDataType pliku z dziennikiem.

Zwroty
boolean czy plik został zapisany.

logNestedRemoteFile

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

Pobierz plik zdalny z zagnieżdżonej instancji i zapisz go.

Parametry
logger ITestLogger: ITestLogger, w którym należy zapisać plik.

gceAvd GceAvdInfo: GceAvdInfo opisujący urządzenie.

options TestDeviceOptions: TestDeviceOptions opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.

runUtil IRunUtil: IRunUtil do wykonywania poleceń.

remoteFilePath String: ścieżka zdalna, pod którą znajduje się plik.

type LogDataType: LogDataType zapisanego pliku.

baseName String: nazwa podstawowa do użycia w logu pliku. Jeśli wartość to null, używana jest rzeczywista nazwa pliku.

Zwroty
boolean czy plik został zapisany.

logSerialoutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Zarejestruj wyjście szeregowe urządzenia opisanego przez GceAvdInfo.

Parametry
infos GceAvdInfo: GceAvdInfo opisujący instancję.

logger ITestLogger: ITestLogger, w którym należy zapisać dziennik seryjny.

remoteSshCommandExecution

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

Wykonaj polecenie zdalne w instancji za pomocą SSH.

Parametry
gceAvd GceAvdInfo: GceAvdInfo opisujące urządzenie.

options TestDeviceOptions: TestDeviceOptions opisujący opcje urządzenia, które mają być używane w przypadku urządzenia GCE.

runUtil IRunUtil: IRunUtil do wykonywania poleceń.

timeoutMs long: czas oczekiwania na wykonanie polecenia w milisekundach. Wartość 0 oznacza brak limitu czasu.

command String: polecenie zdalne do wykonania.

Zwroty
CommandResult CommandResult zawierający wynik wykonania.

shutdownGce

public boolean shutdownGce ()

Zamknij instancję GCE powiązaną z startGce().

Zwroty
boolean zwraca wartość „prawda”, jeśli żądanie zamknięcia gce zostało zgłoszone jako nieblokujące.

startGce

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

Spróbuj uruchomić instancję gce przy użyciu Acloud lub Oxygen.

Parametry
ipDevice String: początkowy adres IP instancji GCE, w której zostanie uruchomiona usługa AVD, null, jeśli nie ma zastosowania

user String: użytkownik hosta AVD, null, jeśli nie dotyczy

offset Integer: przesunięcie numeru urządzenia AVD na hoście, null, jeśli nie dotyczy

attributes MultiMap: atrybuty powiązane z bieżącym wywołaniem, używane do przekazywania odpowiednich informacji do instancji GCE, które zostaną dodane jako metadane maszyny wirtualnej.

logger ITestLogger: pole ITestLogger, w którym mają być zapisywane logi uruchamiania urządzenia.

Zwroty
GceAvdInfo GceAvdInfo opisujący instancję GCE. Może to być instancja BOOT_FAIL.

Rzuty
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Zwroty
GceAvdInfo

Rzuty
TargetSetupError

StartGce

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

Próbuje uruchomić instancję gce.

Parametry
ipDevice String: początkowy adres IP instancji GCE, w której zostanie uruchomiona usługa AVD, null, jeśli nie ma zastosowania

attributes MultiMap: atrybuty powiązane z bieżącym wywołaniem, używane do przekazywania odpowiednich informacji do instancji GCE w celu dodania ich jako metadanych maszyny wirtualnej.

Zwroty
GceAvdInfo GceAvdInfo opisujący instancję GCE. Może to być instancja BOOT_FAIL.

Rzuty
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

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

Spróbuj uruchomić instancję gce przy użyciu Acloud lub Oxygen.

Parametry
ipDevice String: początkowy adres IP instancji GCE, w której zostanie uruchomiona usługa AVD, null, jeśli nie ma zastosowania

user String: użytkownik hosta AVD, null, jeśli nie dotyczy

offset Integer: przesunięcie numeru urządzenia AVD na hoście, null, jeśli nie dotyczy

attributes MultiMap: atrybuty powiązane z bieżącym wywołaniem, używane do przekazywania odpowiednich informacji do instancji GCE w celu dodania ich jako metadanych maszyny wirtualnej.

Zwroty
GceAvdInfo GceAvdInfo opisujący instancję GCE. Może to być instancja BOOT_FAIL.

Rzuty
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Ta metoda została wycofana.
Usuń ten element po zaktualizowaniu gałęzi głównej.

Parametry
buildInfos

Zwroty

Rzuty
TargetSetupError

startMultiDevicesGce

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

Próba uruchomienia instancji GCE na wielu urządzeniach za pomocą Oxygen.

Parametry
buildInfos : ERROR(/List)

attributes MultiMap: atrybuty powiązane z bieżącym wywołaniem

Zwroty
ERROR(/List) opisujący informacje o AVd w GCE.

Rzuty
TargetSetupError

Chronione metody

buildShutdownCommand

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

Parametry
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

Zwroty

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Pobierz nazwę instancji z logów rozruchu gce. Wyszukaj wzór „name”: „gce-” w celu wyodrębnienia nazwy. Wyodrębniamy dane z dzienników zamiast z pliku wyników, ponieważ w przypadku błędu uruchamiania gce nazwa próbowanego wystąpienia nie będzie widoczna w pliku JSON.

Parametry
bootupLogs String

Zwroty
String