gceManager

public class GceManager
extends Object

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


Hilfsprogramm, das die GCE-Aufrufe zum Starten/Beenden und Erfassen von Logs 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

Öffentliche Konstruktoren

GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Logo: Ctor

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

<ph type="x-smartling-placeholder"></ph> Dieser Konstruktor wurde verworfen. Verwenden Sie andere Konstruktoren, da diese aus Gründen der Abwärtskompatibilität vorübergehend gespeichert werden.

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

Ctor, eine Variante, mit der der GCE-Instanzname direkt bereitgestellt werden kann.

Öffentliche Methoden

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

Tatsächliche Acloud-Ausführung zum Herunterfahren des virtuellen Geräts.

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

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

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

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

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

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

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

void logSerialOutput(GceAvdInfo infos, ITestLogger logger)

Die serielle Ausgabe eines mit GceAvdInfo beschriebenen Geräts wird protokolliert.

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

Remote-Befehl über SSH auf einer Instanz ausführen

boolean shutdownGce()

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

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

Versuchen, eine gce-Instanz zu starten

Geschützte Methoden

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

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

String extractInstanceName(String bootupLogs)

Rufen Sie den Instanznamen aus den gce-Startlogs 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

Öffentliche Konstruktoren

gceManager

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

Logo: Ctor

Parameter
deviceDesc DeviceDescriptor: Die DeviceDescriptor, die mit dem GCE-Gerät verknüpft wird.

deviceOptions TestDeviceOptions: Eine dem Gerät zugeordnete TestDeviceOptions.

buildInfo IBuildInfo: Ein IBuildInfo, der den zu startenden gce-Build beschreibt.

gceManager

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

<ph type="x-smartling-placeholder"></ph> Dieser Konstruktor wurde verworfen.
Verwenden Sie andere Konstruktoren, da diese aus Gründen der Abwärtskompatibilität vorübergehend gespeichert werden.

Parameter
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

gceManager

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

Ctor, eine Variante, mit der der GCE-Instanzname direkt bereitgestellt werden kann.

Parameter
deviceDesc DeviceDescriptor: Die DeviceDescriptor, die mit dem GCE-Gerät verknüpft wird.

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

buildInfo IBuildInfo: Ein IBuildInfo, der den zu startenden gce-Build beschreibt.

gceInstanceName String: Der zu verwendende Instanzname.

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

Öffentliche Methoden

AcloudHerunterfahren

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

Tatsächliche Acloud-Ausführung zum Herunterfahren des virtuellen Geräts.

Parameter
options TestDeviceOptions: Die TestDeviceOptions für die Acloud-Optionen

runUtil IRunUtil: Der IRunUtil zum Ausführen von Acloud

instanceName String: Die Instanz, die heruntergefahren werden soll.

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

Returns
boolean „True“ bei Erfolg

CleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Rufe per 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 beschreiben.

options TestDeviceOptions: Eine TestDeviceOptions, die die Geräteoptionen beschreibt, die für die GCE-Gerät

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

Returns
File Eine Datei, die auf den ZIP-Fehlerbericht verweist, oder null, wenn ein Problem aufgetreten ist.

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: Der GceAvdInfo, der 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.

Returns
String Die serielle Logausgabe oder null, wenn ein Fehler auftritt.

getNestedDeviceSshBugreportz

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

Rufen Sie über SSH einen Fehlerbericht für eine verschachtelte Instanz ab. Dazu muss das ADB in der verschachtelten virtueller Instanz.

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

options TestDeviceOptions: Eine TestDeviceOptions, die die Geräteoptionen beschreibt, die für die GCE-Gerät

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

Returns
File Eine Datei, die auf den ZIP-Fehlerbericht verweist, oder null, wenn ein Problem aufgetreten ist.

logNestedRemoteFile

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

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

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

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

options TestDeviceOptions: Eine TestDeviceOptions, die die Geräteoptionen beschreibt, die für die GCE-Gerät

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

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

type LogDataType: LogDataType der protokollierten Datei.

logNestedRemoteFile

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

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

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

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

options TestDeviceOptions: Eine TestDeviceOptions, die die Geräteoptionen beschreibt, die für die GCE-Gerät

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

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

type LogDataType: LogDataType der protokollierten Datei.

baseName String: Der Basisname, der zum Protokollieren der Datei verwendet werden soll. Wenn null ist, ist der tatsächliche Dateiname verwendet.

LogSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Die serielle Ausgabe eines mit GceAvdInfo beschriebenen Geräts wird protokolliert.

Parameter
infos GceAvdInfo: Der GceAvdInfo, der die Instanz beschreibt.

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

remoteSshCommandAusführung

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

Remote-Befehl über SSH auf einer Instanz ausführen

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

options TestDeviceOptions: Eine TestDeviceOptions, die die Geräteoptionen beschreibt, die für die GCE-Gerät

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

timeoutMs long: Das Zeitlimit in Millisekunden für den Befehl. 0 bedeutet, dass es keine Zeitüberschreitung gibt.

command String: Der auszuführende Remotebefehl.

Returns
CommandResult CommandResult mit dem Ergebnis der Ausführung.

HerunterfahrenGce

public boolean shutdownGce ()

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

Returns
boolean gibt "true" zurück, wenn das Herunterfahren von gce als nicht blockierend angefordert wurde.

startgce

public GceAvdInfo startGce ()

Returns
GceAvdInfo

Ausgabe
TargetSetupError

startgce

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

Versuchen, eine gce-Instanz zu starten

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

attributes MultiMap: Attribute, die dem aktuellen Aufruf zugeordnet sind und zum Übergeben von anwendbaren Informationen bis hin zur GCE-Instanz, die als VM-Metadaten hinzugefügt werden

Returns
GceAvdInfo Ein GceAvdInfo, der die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein.

Ausgabe
TargetSetupError

Geschützte Methoden

buildGceCmd

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

Erstellen Sie den Befehl zum Starten von GCE und geben Sie ihn zurück. Wird zu Testzwecken zur Verfügung gestellt.

Parameter
reportFile File

b IBuildInfo

ipDevice String

attributes MultiMap

Returns

ExtrahiereinstanzName

protected String extractInstanceName (String bootupLogs)

Rufen Sie den Instanznamen aus den gce-Startlogs ab. Suchen Sie nach "name": "gce-". Muster zu extrahieren, um den Namen zu extrahieren. Wir extrahieren aus den Protokollen statt aus der Ergebnisdatei, gce-Startfehler wird der Name der versuchten Instanz nicht in JSON angezeigt.

Parameter
bootupLogs String

Returns
String