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
Ö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
public static final String GCE_IP_PRECONFIGURED_KEY
Öffentliche Bauträger
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. |
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. |
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. |
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. |
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. |
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. |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
Diese Methode ist veraltet.
Entfernen Sie dies, nachdem der Hauptzweig aktualisiert wurde.
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Versuchen Sie, die GCE-Instanz für mehrere Geräte mit Oxygen zu starten.
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 |
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-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 |