GceManager

public class GceManager
extends Object

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

Funkcja pomocnicza, która zarządza wywołaniami GCE w celu uruchamiania i zatrzymywania maszyn wirtualnych oraz zbierania z nich logów.

Podsumowanie

Stałe

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

Publiczne konstruktory

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. Zachowujemy ten konstruktor tymczasowo na potrzeby zgodności wstecznej.

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

Konstruktor, wariant, którego można użyć do bezpośredniego podania nazwy instancji GCE.

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)

Pobierz raport o błędach z urządzenia za pomocą SSH, aby uniknąć potencjalnych problemów z połączeniem ADB.

HostOrchestratorUtil getHostOrchestratorUtil()

Zwraca instancję HostOrchestratorUtil.

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

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

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

Pobieranie raportu o błędzie za pomocą SSH w przypadku zagnieżdżonej instancji.

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 zagnieżdżonej instancji i zapisz go w dzienniku.

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

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

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Rejestruj dane wyjściowe portu szeregowego urządzenia opisanego przez GceAvdInfo.

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

Wykonaj polecenie zdalne za pomocą protokołu SSH na instancji.

boolean shutdownGce()

Wyłącz 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óba uruchomienia instancji 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.

Metody chronione

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

Pobierz nazwę instancji z logów rozruchu GCE.

Stałe

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Stała wartość: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Wartość stała: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Wartość stała: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Stała wartość:�0x0A> „gce-ip-pre-configured”

Publiczne konstruktory

GceManager

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

Ctor

Parametry
deviceDesc DeviceDescriptor: DeviceDescriptor, który będzie powiązany z urządzeniem GCE.
deviceOptions TestDeviceOptions: TestDeviceOptions powiązany z urządzeniem.
buildInfo IBuildInfo: IBuildInfo opisujący kompilację gce do uruchomienia.

GceManager

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

Ten konstruktor został wycofany.
Używaj innych konstruktorów. Tymczasowo zachowujemy ten konstruktor na potrzeby zgodności wstecznej.

Parametry
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

Konstruktor, wariant, którego można użyć do bezpośredniego podania nazwy instancji GCE.

Parametry
deviceDesc DeviceDescriptor: DeviceDescriptor, który będzie powiązany z urządzeniem GCE.
deviceOptions TestDeviceOptions: TestDeviceOptions powiązany z urządzeniem
buildInfo IBuildInfo: IBuildInfo opisujący kompilację 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 do uruchomienia Acloud
instanceName String: instancja do wyłączenia.
hostname String: nazwa hosta instancji, używana tylko w przypadku Oxygen cuttlefish.
isIpPreconfigured boolean: czy AVD został utworzony na urządzeniu zdalnym ze wstępnie skonfigurowanym adresem IP.
Zwroty
boolean Wartość true, jeśli operacja się powiodła.

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Pobierz raport o błędach z urządzenia za pomocą SSH, aby uniknąć potencjalnych problemów z połączeniem ADB.

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 raport o błędach w formacie ZIP lub wartość null, jeśli wystąpił problem.
Zgłasza
IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Zwraca instancję HostOrchestratorUtil.

Zwroty
HostOrchestratorUtil

getInstanceSerialLog

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

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

Parametry
infos GceAvdInfo: GceAvdInfo opisująca instancję.
avdConfigFile File: plik konfiguracyjny AVD
jsonKeyFile File: plik JSON z kluczem konta usługi.
runUtil IRunUtil: IRunUtil do wykonywania poleceń.
Zwroty
String Dane wyjściowe dziennika szeregowego lub wartość null, jeśli coś pójdzie nie tak.

getNestedDeviceSshBugreportz

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

Pobieranie raportu o błędzie za pomocą SSH w przypadku zagnieżdżonej instancji. Wymaga to wysłania żądania do usługi adb w zagnieżdżonej instancji wirtualnej.

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 raport o błędach w formacie ZIP lub wartość null, jeśli wystąpił problem.
Zgłasza
IOException

logAndDeleteFile

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

Parametry
tempFile File

dataName String

logger ITestLogger

logDirectory

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 zdalny plik z zagnieżdżonej instancji i zapisz go w dzienniku.

Parametry
logger ITestLogger: ITestLogger, w którym ma być zapisany plik.
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ń.
remoteFilePath String: ścieżka zdalna, w której znajduje się plik.
type LogDataType: LogDataType zalogowanego pliku.
Zwroty
boolean czy plik został zarejestrowany.

logNestedRemoteFile

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

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

Parametry
logger ITestLogger: ITestLogger, w którym ma być zapisany plik.
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ń.
remoteFilePath String: ścieżka zdalna, w której znajduje się plik.
type LogDataType: LogDataType zalogowanego pliku.
baseName String: Nazwa podstawowa, która będzie używana do rejestrowania pliku. Jeśli wartość to null, zostanie użyta rzeczywista nazwa pliku.
Zwroty
boolean czy plik został zarejestrowany.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Rejestruj dane wyjściowe portu szeregowego urządzenia opisanego przez GceAvdInfo.

Parametry
infos GceAvdInfo: GceAvdInfo opisująca instancję.
logger ITestLogger: ITestLogger miejsce, w którym ma być rejestrowany dziennik seryjny.

remoteSshCommandExecution

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

Wykonaj polecenie zdalne za pomocą protokołu SSH na instancji.

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

Wyłącz instancję GCE powiązaną z startGce().

Zwroty
boolean zwraca wartość „true”, jeśli wyłączenie 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 za pomocą Acloud lub Oxygen.

Parametry
ipDevice String: początkowy adres IP instancji GCE, na której ma działać AVD, null, jeśli nie dotyczy
user String: host, na którym działa użytkownik AVD, null, jeśli nie dotyczy
offset Integer: numer urządzenia w 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 mają zostać dodane jako metadane maszyny wirtualnej.
logger ITestLogger: ITestLogger miejsce, w którym mają być rejestrowane dzienniki uruchamiania urządzenia.
Zwroty
GceAvdInfo GceAvdInfo opisującą instancję GCE. Może to być instancja BOOT_FAIL.
Zgłasza
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Zwroty
GceAvdInfo

Zgłasza
TargetSetupError

startGce

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

Próba uruchomienia instancji GCE.

Parametry
ipDevice String: początkowy adres IP instancji GCE, na której ma działać AVD, 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 mają zostać dodane jako metadane maszyny wirtualnej.
Zwroty
GceAvdInfo GceAvdInfo opisującą instancję GCE. Może to być instancja BOOT_FAIL.
Zgłasza
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 za pomocą Acloud lub Oxygen.

Parametry
ipDevice String: początkowy adres IP instancji GCE, na której ma działać AVD, null, jeśli nie dotyczy
user String: host, na którym działa użytkownik AVD, null, jeśli nie dotyczy
offset Integer: numer urządzenia w 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 mają zostać dodane jako metadane maszyny wirtualnej.
Zwroty
GceAvdInfo GceAvdInfo opisującą instancję GCE. Może to być instancja BOOT_FAIL.
Zgłasza
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

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

Parametry
buildInfos

Zwroty
Zgłasza
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 GCE Avd.
Zgłasza
TargetSetupError

Metody chronione

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 wzorzec „name”: „gce-”, aby wyodrębnić jego nazwę. Dane wyodrębniamy z dzienników, a nie z pliku wyników, ponieważ w przypadku niepowodzenia uruchomienia instancji GCE nazwa próbowanej instancji nie będzie widoczna w pliku JSON.

Parametry
bootupLogs String

Zwroty
String