GceManager

public class GceManager
extends Object

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

Helfer, der die GCE-Aufrufe zum Starten/Beenden und Erfassen von Logs aus GCE verwaltet.

Zusammenfassung

Konstanten

String GCE_HOSTNAME_KEY

String GCE_INSTANCE_CLEANED_KEY

String GCE_INSTANCE_NAME_KEY

String GCE_IP_PRECONFIGURED_KEY

Öffentliche Konstruktoren

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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

Ctor, Variation, die verwendet werden kann, um den Namen der GCE-Instanz direkt anzugeben.

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, List<IBuildInfo> testResourceBuildInfos)

Dieser Konstruktor ist veraltet. Verwenden Sie andere Konstruktoren. Dieser wird vorübergehend zur Abwärtskompatibilität beibehalten.

Öffentliche Methoden

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

Tatsächlicher Acloud-Lauf zum Herunterfahren des virtuellen Geräts.

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

Erstellen Sie mit SSH einen bugreportz auf dem Gerät, um mögliche Probleme mit der ADB-Verbindung zu vermeiden.

HostOrchestratorUtil getHostOrchestratorUtil()

Gibt die Instanz von HostOrchestratorUtil zurück.

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

Liest den aktuellen Inhalt des seriellen Logs der Gce Avd-Instanz.

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

Fehlerbericht für eine verschachtelte Instanz über SSH abrufen

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, String baseName, List<String> scpArgs)

Eine Remote-Datei aus einer verschachtelten Instanz abrufen und protokollieren.

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

Eine Remote-Datei aus einer verschachtelten Instanz abrufen und protokollieren.

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

Eine Remote-Datei aus einer verschachtelten Instanz abrufen und protokollieren.

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Protokolliere die serielle Ausgabe eines Geräts, das durch GceAvdInfo beschrieben wird.

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

Führen Sie den Remotebefehl über SSH auf einer Instanz aus.

boolean shutdownGce()

Fahren Sie die mit dem startGce() verknüpfte GCE-Instanz herunter.

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

Versuchen Sie, eine GCE-Instanz mit Acloud oder Oxygen zu starten.

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

Es wird versucht, eine GCE-Instanz zu starten.

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

Versuchen Sie, eine GCE-Instanz mit Acloud oder Oxygen zu starten.

List<GceAvdInfo> startMultiDevicesGce(List<IBuildInfo> buildInfos, MultiMap<String, String> attributes)

Versuche, eine GCE-Instanz mit mehreren Geräten mit Oxygen zu starten.

List<GceAvdInfo> startMultiDevicesGce(List<IBuildInfo> buildInfos)

Diese Methode wurde eingestellt. Entfernen Sie diesen Hinweis, nachdem der Master-Branch aktualisiert wurde.

Geschützte Methoden

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

Rufen Sie den Instanznamen aus den GCE-Bootlogs ab.

Konstanten

GCE_HOSTNAME_KEY

public static final String GCE_HOSTNAME_KEY

Konstanter Wert: "gce-hostname"

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

Konstanter Wert: "gce-instance-clean-called"

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

Konstanter Wert: "gce-instance-name"

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Konstanter Wert: "gce-ip-pre-configured"

Öffentliche Konstruktoren

GceManager

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

Ctor

Parameter
deviceDesc DeviceDescriptor: Der DeviceDescriptor, der dem GCE-Gerät zugeordnet wird.
deviceOptions TestDeviceOptions: Ein TestDeviceOptions, der mit dem Gerät verknüpft ist.
buildInfo IBuildInfo: Ein IBuildInfo, der den zu startenden GCE-Build beschreibt.

GceManager

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

Ctor, Variation, die verwendet werden kann, um den Namen der GCE-Instanz direkt anzugeben.

Parameter
deviceDesc DeviceDescriptor: Der DeviceDescriptor, der dem GCE-Gerät zugeordnet wird.
deviceOptions TestDeviceOptions: Eine TestDeviceOptions, die dem Gerät zugeordnet ist
buildInfo IBuildInfo: Ein IBuildInfo, der den zu startenden GCE-Build beschreibt.
gceInstanceName String: Der Name der zu verwendenden Instanz.
gceHost String: Der Hostname oder die IP-Adresse der zu verwendenden Instanz.

GceManager

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

Dieser Konstruktor wurde eingestellt.
Verwenden Sie andere Konstruktoren. Dieser Konstruktor wird vorübergehend zur Abwärtskompatibilität beibehalten.

Parameter
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos List

Öffentliche Methoden

AcloudShutdown

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

Tatsächlicher Acloud-Lauf zum Herunterfahren des virtuellen Geräts.

Parameter
options TestDeviceOptions: Die TestDeviceOptions für die Acloud-Optionen
runUtil IRunUtil: Das IRunUtil zum Ausführen von Acloud
instanceName String: Die Instanz, die heruntergefahren werden soll.
hostname String: Hostname der Instanz, wird nur für Oxygen-Cuttlefish verwendet.
isIpPreconfigured boolean: Gibt an, ob das AVD auf einem Remote-Gerät mit vorkonfigurierter IP-Adresse erstellt wurde.
Gibt Folgendes zurück:
boolean „True“, wenn erfolgreich

cleanUp

public void cleanUp ()

collectErrorSignatures

public static void collectErrorSignatures (File remoteFile)

Parameter
remoteFile File

getBugreportzWithSsh

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

Erstellen Sie mit SSH einen bugreportz auf dem Gerät, um mögliche Probleme mit der ADB-Verbindung zu vermeiden.

Parameter
gceAvd GceAvdInfo: Die GceAvdInfo, die das Gerät beschreiben.
options TestDeviceOptions: Ein TestDeviceOptions, der die Geräteoptionen für das GCE-Gerät beschreibt.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
Gibt Folgendes zurück:
File Eine Datei, die auf den ZIP-Fehlerbericht verweist, oder „null“, wenn ein Problem aufgetreten ist.
Löst aus
java.io.IOException
IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

Gibt die Instanz von HostOrchestratorUtil zurück.

Gibt Folgendes zurück:
HostOrchestratorUtil

getInstanceSerialLog

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

Liest den aktuellen Inhalt des seriellen Logs der Gce Avd-Instanz.

Parameter
infos GceAvdInfo: Die GceAvdInfo, die die Instanz beschreibt.
avdConfigFile File: die AVD-Konfigurationsdatei
jsonKeyFile File: die JSON-Schlüsseldatei des Dienstkontos.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
Gibt Folgendes zurück:
String Die serielle Protokollausgabe oder „null“, wenn etwas schiefgeht.

getNestedDeviceSshBugreportz

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

Fehlerbericht für eine verschachtelte Instanz über SSH abrufen Dazu muss der ADB in der verschachtelten virtuellen Instanz angefordert werden.

Parameter
gceAvd GceAvdInfo: Die GceAvdInfo, die das Gerät beschreiben.
options TestDeviceOptions: Ein TestDeviceOptions, der die Geräteoptionen für das GCE-Gerät beschreibt.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
Gibt Folgendes zurück:
File Eine Datei, die auf den ZIP-Fehlerbericht verweist, oder „null“, wenn ein Problem aufgetreten ist.
Löst aus
java.io.IOException
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, 
                String baseName, 
                List<String> scpArgs)

Eine Remote-Datei aus einer verschachtelten Instanz abrufen und protokollieren.

Parameter
logger ITestLogger: Das ITestLogger, in dem die Datei protokolliert werden soll.
gceAvd GceAvdInfo: Die GceAvdInfo, die das Gerät beschreiben.
options TestDeviceOptions: Ein TestDeviceOptions, der die Geräteoptionen für das GCE-Gerät beschreibt.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
remoteFilePath String: Der Remote-Pfad, in dem sich die Datei befindet.
type LogDataType: die LogDataType der protokollierten Datei.
baseName String: Der Basisname, der zum Protokollieren der Datei verwendet werden soll. Bei „null“ wird der tatsächliche Dateiname verwendet.
scpArgs List: zusätzliche Argumente, die an den Befehl „scp“ übergeben werden sollen
Gibt Folgendes zurück:
boolean ob die Datei erfolgreich protokolliert wurde.

logNestedRemoteFile

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

Eine Remote-Datei aus einer verschachtelten Instanz abrufen und protokollieren.

Parameter
logger ITestLogger: Das ITestLogger, in dem die Datei protokolliert werden soll.
gceAvd GceAvdInfo: Die GceAvdInfo, die das Gerät beschreiben.
options TestDeviceOptions: Ein TestDeviceOptions, der die Geräteoptionen für das GCE-Gerät beschreibt.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
remoteFilePath String: Der Remote-Pfad, in dem sich die Datei befindet.
type LogDataType: die LogDataType der protokollierten Datei.
Gibt Folgendes zurück:
boolean ob die Datei erfolgreich protokolliert wurde.

logNestedRemoteFile

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

Eine Remote-Datei aus einer verschachtelten Instanz abrufen und protokollieren.

Parameter
logger ITestLogger: Das ITestLogger, in dem die Datei protokolliert werden soll.
gceAvd GceAvdInfo: Die GceAvdInfo, die das Gerät beschreiben.
options TestDeviceOptions: Ein TestDeviceOptions, der die Geräteoptionen für das GCE-Gerät beschreibt.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
remoteFilePath String: Der Remote-Pfad, in dem sich die Datei befindet.
type LogDataType: die LogDataType der protokollierten Datei.
baseName String: Der Basisname, der zum Protokollieren der Datei verwendet werden soll. Bei „null“ wird der tatsächliche Dateiname verwendet.
Gibt Folgendes zurück:
boolean ob die Datei erfolgreich protokolliert wurde.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Protokolliere die serielle Ausgabe eines Geräts, das durch GceAvdInfo beschrieben wird.

Parameter
infos GceAvdInfo: Die GceAvdInfo, die die Instanz beschreibt.
logger ITestLogger: Das ITestLogger, in dem das serielle Log aufgezeichnet werden soll.

remoteSshCommandExecution

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

Führen Sie den Remotebefehl über SSH auf einer Instanz aus.

Parameter
gceAvd GceAvdInfo: Die GceAvdInfo, die das Gerät beschreiben.
options TestDeviceOptions: Ein TestDeviceOptions, der die Geräteoptionen für das GCE-Gerät beschreibt.
runUtil IRunUtil: ein IRunUtil zum Ausführen von Befehlen.
timeoutMs long: Das Zeitlimit für den Befehl in Millisekunden. 0 bedeutet kein Timeout.
command String: Der auszuführende Remote-Befehl.
Gibt Folgendes zurück:
CommandResult CommandResult mit dem Ergebnis der Ausführung.

shutdownGce

public boolean shutdownGce ()

Fahren Sie die mit dem startGce() verknüpfte GCE-Instanz herunter.

Gibt Folgendes zurück:
boolean Gibt „true“ zurück, wenn das Herunterfahren der GCE als nicht blockierend angefordert wurde.

startGce

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

Versuchen Sie, eine GCE-Instanz mit Acloud oder Oxygen zu starten.

Parameter
ipDevice String: Die ursprüngliche IP-Adresse der GCE-Instanz, auf der AVD ausgeführt werden soll. null, falls nicht zutreffend.
user String: Der Host, auf dem der AVD-Nutzer ausgeführt wird. null, falls nicht zutreffend.
offset Integer: Der Geräte-Nummer-Offset des AVD auf dem Host, null, falls nicht zutreffend
attributes MultiMap: Attribute, die mit dem aktuellen Aufruf verknüpft sind und zum Übergeben der entsprechenden Informationen an die GCE-Instanz verwendet werden, die als VM-Metadaten hinzugefügt werden sollen
logger ITestLogger: Der ITestLogger, in dem die Logs zum Starten des Geräts protokolliert werden.
Gibt Folgendes zurück:
GceAvdInfo GceAvdInfo, die die GCE-Instanz beschreibt. Möglicherweise liegt ein BOOT_FAIL-Fall vor.
Löst aus
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Gibt Folgendes zurück:
GceAvdInfo

Löst aus
TargetSetupError

startGce

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

Es wird versucht, eine GCE-Instanz zu starten.

Parameter
ipDevice String: Die ursprüngliche IP-Adresse der GCE-Instanz, auf der AVD ausgeführt werden soll. null, falls nicht zutreffend.
attributes MultiMap: Attribute, die mit dem aktuellen Aufruf verknüpft sind und zum Übergeben der entsprechenden Informationen an die GCE-Instanz verwendet werden, die als VM-Metadaten hinzugefügt werden sollen
Gibt Folgendes zurück:
GceAvdInfo GceAvdInfo, die die GCE-Instanz beschreibt. Möglicherweise liegt ein BOOT_FAIL-Fall vor.
Löst aus
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

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

Versuchen Sie, eine GCE-Instanz mit Acloud oder Oxygen zu starten.

Parameter
ipDevice String: Die ursprüngliche IP-Adresse der GCE-Instanz, auf der AVD ausgeführt werden soll. null, falls nicht zutreffend.
user String: Der Host, auf dem der AVD-Nutzer ausgeführt wird. null, falls nicht zutreffend.
offset Integer: Der Geräte-Nummer-Offset des AVD auf dem Host, null, falls nicht zutreffend
attributes MultiMap: Attribute, die mit dem aktuellen Aufruf verknüpft sind und zum Übergeben der entsprechenden Informationen an die GCE-Instanz verwendet werden, die als VM-Metadaten hinzugefügt werden sollen
Gibt Folgendes zurück:
GceAvdInfo GceAvdInfo, die die GCE-Instanz beschreibt. Möglicherweise liegt ein BOOT_FAIL-Fall vor.
Löst aus
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos, 
                MultiMap<String, String> attributes)

Versuche, eine GCE-Instanz mit mehreren Geräten mit Oxygen zu starten.

Parameter
buildInfos List: ERROR(/List)
attributes MultiMap: Attribute, die mit dem aktuellen Aufruf verknüpft sind
Gibt Folgendes zurück:
List<GceAvdInfo> ERROR(/List), die die GCE-Avd-Informationen beschreibt.
Löst aus
TargetSetupError

startMultiDevicesGce

public List<GceAvdInfo> startMultiDevicesGce (List<IBuildInfo> buildInfos)

Diese Methode wurde eingestellt.
Remove this after master branch is updated.

Parameter
buildInfos List

Gibt Folgendes zurück:
List<GceAvdInfo>

Löst aus
TargetSetupError

Geschützte Methoden

buildShutdownCommand

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

Parameter
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

Gibt Folgendes zurück:
List<String>

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Rufen Sie den Instanznamen aus den GCE-Bootlogs ab. Suchen Sie nach dem Muster „name“: „gce-“, um den Namen zu extrahieren. Wir extrahieren die Informationen aus den Logs anstelle der Ergebnisdatei, da der Name der versuchten Instanz bei einem GCE-Bootfehler nicht in der JSON-Datei angezeigt wird.

Parameter
bootupLogs String

Gibt zurück
String