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
Öffentliche Konstruktoren |
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)
Logo: Ctor
|
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)
Dieser Konstruktor wurde verworfen.
Verwenden Sie andere Konstruktoren. Wir bewahren diese aus Gründen der Abwärtskompatibilität vorübergehend auf.
|
GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)
Ctor, eine Variation, mit der der GCE-Instanzname direkt bereitgestellt werden kann.
|
Öffentliche Methoden |
static
boolean
|
AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)
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
|
logDirectory(File remoteDirectory, String baseName, ITestLogger logger, LogDataType type)
|
static
boolean
|
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
boolean
|
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(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)
Diese Methode wurde verworfen.
Entfernen Sie diese Angabe, nachdem der Master-Branch aktualisiert wurde.
|
|
startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)
Versuchen Sie, die gce-Instanz für mehrere Geräte mit Sauerstoff 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-Startlogs ab.
|
Fields
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
public static final String GCE_IP_PRECONFIGURED_KEY
Öffentliche Konstruktoren
gceManager
public GceManager (DeviceDescriptor deviceDesc,
TestDeviceOptions deviceOptions,
IBuildInfo buildInfo,
testResourceBuildInfos)
Dieser Konstruktor wurde verworfen.
Sie können andere Konstruktoren verwenden. Wir bewahren diese aus Gründen der Abwärtskompatibilität vorübergehend auf.
Parameter |
deviceDesc |
DeviceDescriptor |
deviceOptions |
TestDeviceOptions |
buildInfo |
IBuildInfo |
testResourceBuildInfos |
|
gceManager
public GceManager (DeviceDescriptor deviceDesc,
TestDeviceOptions deviceOptions,
IBuildInfo buildInfo,
String gceInstanceName,
String gceHost)
Ctor, eine Variation, 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,
boolean isIpPreconfigured)
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. |
isIpPreconfigured |
boolean : Gibt an, ob das AVD auf einem Remote-Gerät mit vorkonfigurierter IP-Adresse erstellt wurde |
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 : 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. |
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 virtuellen Instanz angefordert werden.
Parameter |
gceAvd |
GceAvdInfo : Die GceAvdInfo , die das Gerät beschreiben. |
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. |
Returns |
File |
Eine Datei, die auf den ZIP-Fehlerbericht verweist, oder null, wenn ein Problem aufgetreten ist. |
logDirectory (Logverzeichnis)
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)
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 : 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, unter dem die Datei zu finden ist. |
type |
LogDataType : LogDataType der protokollierten Datei. |
Returns |
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 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 : 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, 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, wird der tatsächliche Dateiname verwendet. |
Returns |
boolean |
ob die Datei erfolgreich protokolliert wurde. |
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 : 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 Zeitlimit in Millisekunden für den Befehl. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
command |
String : Der auszuführende Remotebefehl. |
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 (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-Adresse der GCE-Instanz, in der AVD ausgeführt werden soll, null , falls nicht zutreffend |
user |
String : der Hostnutzer von AVD, null , falls nicht zutreffend |
offset |
Integer : der Versatz der Gerätenummer des AVD im Host, null , falls nicht zutreffend |
attributes |
MultiMap : Attribute, die dem aktuellen Aufruf zugeordnet sind und zum Weiterleiten geeigneter Informationen an die GCE-Instanz verwendet werden, die als VM-Metadaten hinzugefügt werden sollen |
logger |
ITestLogger : Der ITestLogger , in dem die Gerätestartprotokolle gespeichert werden sollen. |
Returns |
GceAvdInfo |
Ein GceAvdInfo , der die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein. |
startgce
public GceAvdInfo startGce (String ipDevice,
MultiMap<String, String> attributes)
Versuchen Sie, eine gce-Instanz zu starten.
Parameter |
ipDevice |
String : die anfängliche IP-Adresse der GCE-Instanz, in der AVD ausgeführt werden soll, null , falls nicht zutreffend |
attributes |
MultiMap : Attribute, die dem aktuellen Aufruf zugeordnet sind und zum Weiterleiten geeigneter Informationen an die GCE-Instanz verwendet werden, die als VM-Metadaten hinzugefügt werden sollen |
Returns |
GceAvdInfo |
Ein GceAvdInfo , der die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein. |
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-Adresse der GCE-Instanz, in der AVD ausgeführt werden soll, null , falls nicht zutreffend |
user |
String : der Hostnutzer von AVD, null , falls nicht zutreffend |
offset |
Integer : der Versatz der Gerätenummer des AVD im Host, null , falls nicht zutreffend |
attributes |
MultiMap : Attribute, die dem aktuellen Aufruf zugeordnet sind und zum Weiterleiten geeigneter Informationen an die GCE-Instanz verwendet werden, die als VM-Metadaten hinzugefügt werden sollen |
Returns |
GceAvdInfo |
Ein GceAvdInfo , der die GCE-Instanz beschreibt. Könnte eine BOOT_FAIL-Instanz sein. |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Diese Methode wurde verworfen.
Entfernen Sie dies, nachdem der Master-Branch aktualisiert wurde.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Versuchen Sie, die gce-Instanz für mehrere Geräte mit Sauerstoff zu starten.
Parameter |
buildInfos |
: ERROR(/List) |
attributes |
MultiMap : Attribute, die dem aktuellen Aufruf zugeordnet sind |
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. Wird zu Testzwecken zur Verfügung gestellt.
Parameter |
reportFile |
File |
b |
IBuildInfo |
ipDevice |
String |
user |
String |
offset |
Integer |
attributes |
MultiMap |
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 |
protected String extractInstanceName (String bootupLogs)
Rufen Sie den Instanznamen aus den gce-Startlogs ab. Suchen Sie nach dem Muster 'name': 'gce-', um dessen Namen zu extrahieren. Wir extrahieren Daten aus den Logs und nicht aus der Ergebnisdatei, da bei einem gce-Bootfehler der versuchte Instanzname nicht in json angezeigt wird.
Parameter |
bootupLogs |
String |