GceManager

public class GceManager
extends Object

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


Helfer, der die GCE-Aufrufe zum Starten/Stoppen und Sammeln von Protokollen von GCE verwaltet.

Zusammenfassung

Felder

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

Öffentliche Bauträger

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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

Dieser Konstruktor ist veraltet. Verwenden Sie andere Konstruktoren. Diese behalten wir aus Gründen der Abwärtskompatibilität vorübergehend bei.

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

Ctor, Variante, die verwendet werden kann, um den GCE-Instanznamen zur direkten Verwendung bereitzustellen.

Ö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 File getBugreportzWithSsh ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)

Rufen Sie mithilfe von SSH einen Fehlerbericht vom Gerät ab, um potenzielle Probleme mit der ADB-Verbindung zu vermeiden.

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

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

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

Erhalten Sie über SSH einen Fehlerbericht für eine verschachtelte Instanz.

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

Rufen Sie eine Remote-Datei von einer verschachtelten Instanz ab und protokollieren Sie sie.

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

Rufen Sie eine Remote-Datei von einer verschachtelten Instanz ab und protokollieren Sie sie.

void logSerialOutput ( GceAvdInfo infos, ITestLogger logger)

Protokollieren Sie die serielle Ausgabe eines von GceAvdInfo beschriebenen Geräts.

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

Führen Sie den Remote-Befehl über ssh auf einer Instanz aus.

boolean shutdownGce ()

Fahren Sie die mit 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 entweder mit Acloud oder Oxygen zu starten.

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

Versuchen Sie, eine GCE-Instanz zu starten.

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

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

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

Diese Methode ist veraltet. Entfernen Sie dies, nachdem der Hauptzweig aktualisiert wurde.

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

Versuchen Sie, die GCE-Instanz für mehrere Geräte mit Oxygen zu starten.

Geschützte Methoden

buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap <String, String> attributes)

Erstellen Sie den Befehl zum Starten von GCE und geben Sie ihn zurück.

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

Rufen Sie den Instanznamen aus den gce-Bootprotokollen ab.

Felder

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

Öffentliche Bauträger

GceManager

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

Ctor

Parameter
deviceDesc DeviceDescriptor : Der DeviceDescriptor , der dem GCE-Gerät zugeordnet wird.

deviceOptions TestDeviceOptions : Eine mit dem Gerät verknüpfte TestDeviceOptions .

buildInfo IBuildInfo : Eine IBuildInfo , die den zu startenden GCE-Build beschreibt.

GceManager

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

Dieser Konstruktor ist veraltet.
Verwenden Sie andere Konstruktoren. Diese behalten wir aus Gründen der Abwärtskompatibilität vorübergehend bei.

Parameter
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

Ctor, Variante, die verwendet werden kann, um den GCE-Instanznamen zur direkten Verwendung bereitzustellen.

Parameter
deviceDesc DeviceDescriptor : Der DeviceDescriptor , der dem GCE-Gerät zugeordnet wird.

deviceOptions TestDeviceOptions : Eine mit dem Gerät verknüpfte TestDeviceOptions

buildInfo IBuildInfo : Eine IBuildInfo , die den zu startenden GCE-Build beschreibt.

gceInstanceName String : Der zu verwendende Instanzname.

gceHost String : Der Hostname oder die IP der zu verwendenden Instanz.

Ö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 herunterzufahrende Instanz.

hostname String : Hostname der Instanz, wird nur für Oxygen Cuttlefish verwendet.

isIpPreconfigured boolean : ob die AVD auf einem Remote-Gerät mit vorkonfigurierter IP erstellt wurde

Kehrt zurück
boolean True, wenn erfolgreich

Aufräumen

public void cleanUp ()

getBugreportzWithSsh

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

Rufen Sie mithilfe von SSH einen Fehlerbericht vom Gerät ab, um potenzielle Probleme mit der ADB-Verbindung zu vermeiden.

Parameter
gceAvd GceAvdInfo : Die GceAvdInfo , die das Gerät beschreibt.

options TestDeviceOptions : ein TestDeviceOptions der die Geräteoptionen beschreibt, die für das GCE-Gerät verwendet werden sollen.

runUtil IRunUtil : ein IRunUtil zum Ausführen von Befehlen.

Kehrt zurück
File Eine Datei, die auf den Zip-Fehlerbericht verweist, oder null, wenn ein Problem aufgetreten ist.

Würfe
IOException

getInstanceSerialLog

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

Liest den aktuellen Inhalt des seriellen Protokolls 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.

Kehrt zurück
String Die serielle Protokollausgabe oder null, wenn etwas schief geht.

getNestedDeviceSshBugreportz

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

Erhalten Sie über SSH einen Fehlerbericht für eine verschachtelte Instanz. Dies erfordert die Anforderung der ADB in der verschachtelten virtuellen Instanz.

Parameter
gceAvd GceAvdInfo : Die GceAvdInfo , die das Gerät beschreibt.

options TestDeviceOptions : ein TestDeviceOptions der die Geräteoptionen beschreibt, die für das GCE-Gerät verwendet werden sollen.

runUtil IRunUtil : ein IRunUtil zum Ausführen von Befehlen.

Kehrt zurück
File Eine Datei, die auf den Zip-Fehlerbericht verweist, oder null, wenn ein Problem aufgetreten ist.

Würfe
IOException

logNestedRemoteFile

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

Rufen Sie eine Remote-Datei von einer verschachtelten Instanz ab und protokollieren Sie sie.

Parameter
logger ITestLogger : Der ITestLogger , wo die Datei protokolliert werden soll.

gceAvd GceAvdInfo : Die GceAvdInfo , die das Gerät beschreibt.

options TestDeviceOptions : ein TestDeviceOptions der die Geräteoptionen beschreibt, die für das GCE-Gerät verwendet werden sollen.

runUtil IRunUtil : ein IRunUtil zum Ausführen von Befehlen.

remoteFilePath String : Der Remote-Pfad, wo die Datei zu finden ist.

type LogDataType : der LogDataType der protokollierten Datei.

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

Rufen Sie eine Remote-Datei von einer verschachtelten Instanz ab und protokollieren Sie sie.

Parameter
logger ITestLogger : Der ITestLogger , wo die Datei protokolliert werden soll.

gceAvd GceAvdInfo : Die GceAvdInfo , die das Gerät beschreibt.

options TestDeviceOptions : ein TestDeviceOptions der die Geräteoptionen beschreibt, die für das GCE-Gerät verwendet werden sollen.

runUtil IRunUtil : ein IRunUtil zum Ausführen von Befehlen.

remoteFilePath String : Der Remote-Pfad, wo die Datei zu finden ist.

type LogDataType : der LogDataType der protokollierten Datei.

baseName String : Der Basisname, der zum Protokollieren der Datei verwendet werden soll. Bei Null wird der tatsächliche Dateiname verwendet.

Kehrt zurück
boolean ob die Datei erfolgreich protokolliert wurde.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Protokollieren Sie die serielle Ausgabe eines von GceAvdInfo beschriebenen Geräts.

Parameter
infos GceAvdInfo : Die GceAvdInfo , die die Instanz beschreibt.

logger ITestLogger : Der ITestLogger , in dem das serielle Protokoll protokolliert werden soll.

remoteSshCommandExecution

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

Führen Sie den Remote-Befehl über ssh auf einer Instanz aus.

Parameter
gceAvd GceAvdInfo : Die GceAvdInfo , die das Gerät beschreibt.

options TestDeviceOptions : ein TestDeviceOptions der die Geräteoptionen beschreibt, die für das GCE-Gerät verwendet werden sollen.

runUtil IRunUtil : ein IRunUtil zum Ausführen von Befehlen.

timeoutMs long : Das Timeout in Millisekunden für den Befehl. 0 bedeutet kein Timeout.

command String : Der auszuführende Remote-Befehl.

Kehrt zurück
CommandResult CommandResult , das das Ergebnis der Ausführung enthält.

ShutdownGce

public boolean shutdownGce ()

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

Kehrt zurück
boolean gibt true zurück, wenn das Herunterfahren von 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 entweder mit Acloud oder Oxygen zu starten.

Parameter
ipDevice String : die anfängliche IP der GCE-Instanz, in der AVD ausgeführt werden soll, null , falls nicht zutreffend

user String : der Host, auf dem der Benutzer von AVD ausgeführt wird, null , falls nicht zutreffend

offset Integer : der Gerätenummern-Offset des AVD im Host, null , falls nicht zutreffend

attributes MultiMap : Mit dem aktuellen Aufruf verknüpfte Attribute, die zur Weitergabe anwendbarer Informationen an die GCE-Instanz verwendet werden, um sie als VM-Metadaten hinzuzufügen

logger ITestLogger : Der ITestLogger , in dem die Gerätestartprotokolle protokolliert werden.

Kehrt zurück
GceAvdInfo eine GceAvdInfo , die die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein.

Würfe
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Kehrt zurück
GceAvdInfo

Würfe
TargetSetupError

startGce

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

Versuchen Sie, eine GCE-Instanz zu starten.

Parameter
ipDevice String : die anfängliche IP der GCE-Instanz, in der AVD ausgeführt werden soll, null , falls nicht zutreffend

attributes MultiMap : Mit dem aktuellen Aufruf verknüpfte Attribute, die zur Weitergabe anwendbarer Informationen an die GCE-Instanz verwendet werden, um sie als VM-Metadaten hinzuzufügen

Kehrt zurück
GceAvdInfo eine GceAvdInfo , die die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein.

Würfe
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 entweder mit Acloud oder Oxygen zu starten.

Parameter
ipDevice String : die anfängliche IP der GCE-Instanz, in der AVD ausgeführt werden soll, null , falls nicht zutreffend

user String : der Host, auf dem der Benutzer von AVD ausgeführt wird, null , falls nicht zutreffend

offset Integer : der Gerätenummern-Offset des AVD im Host, null , falls nicht zutreffend

attributes MultiMap : Mit dem aktuellen Aufruf verknüpfte Attribute, die zur Weitergabe anwendbarer Informationen an die GCE-Instanz verwendet werden, um sie als VM-Metadaten hinzuzufügen

Kehrt zurück
GceAvdInfo eine GceAvdInfo , die die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein.

Würfe
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Diese Methode ist veraltet.
Entfernen Sie dies, nachdem der Hauptzweig aktualisiert wurde.

Parameter
buildInfos

Kehrt zurück

Würfe
TargetSetupError

startMultiDevicesGce

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

Versuchen Sie, die GCE-Instanz für mehrere Geräte mit Oxygen zu starten.

Parameter
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : Attribute, die dem aktuellen Aufruf zugeordnet sind

Kehrt zurück
ein ERROR(/List ) ERROR(/List ) beschreibt die GCE Avd Info.

Würfe
TargetSetupError

Geschützte Methoden

buildGceCmd

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                String user, 
                Integer offset, 
                MultiMap<String, String> attributes)

Erstellen Sie den Befehl zum Starten von GCE und geben Sie ihn zurück. Zum Testen ausgesetzt.

Parameter
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

Kehrt zurück

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

Kehrt zurück

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Rufen Sie den Instanznamen aus den gce-Bootprotokollen ab. Suchen Sie nach dem „Namen“: „gce-“ ' Muster, um den Namen davon zu extrahieren. Wir extrahieren aus den Protokollen statt aus der Ergebnisdatei, da bei einem GCE-Startfehler der versuchte Instanzname nicht in JSON angezeigt wird.

Parameter
bootupLogs String

Kehrt zurück
String