Gceマネージャー
public class GceManager
extends Object
java.lang.オブジェクト |
↳ | com.android.tradefed.device.cloud.GceManager |
GCE 呼び出しを管理して開始/停止し、GCE からログを収集するヘルパー。
まとめ
パブリックコンストラクター |
---|
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo) センター |
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) このコンストラクターは非推奨になりました。他のコンストラクターを使用します。下位互換性のためにこれを一時的に保持します。 |
GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost) Ctor、直接使用する GCE インスタンス名を提供するために使用できるバリエーション。 |
パブリックメソッド |
---|
static boolean | AcloudShutdown ( TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured) 実際に Acloud を実行して仮想デバイスをシャットダウンします。 |
void | cleanUp () |
static File | getBugreportzWithSsh ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) adb 接続の潜在的な問題を回避するために、SSH を使用してデバイスからバグレポートを取得します。 |
static String | getInstanceSerialLog ( GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil) Gce Avd インスタンスのシリアル ログの現在の内容を読み取ります。 |
static File | getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) ネストされたインスタンスのバグレポートを ssh 経由で取得します。 |
static boolean | logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type) ネストされたインスタンスからリモート ファイルをフェッチし、ログに記録します。 |
static boolean | logNestedRemoteFile ( ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName) ネストされたインスタンスからリモート ファイルをフェッチし、ログに記録します。 |
void | logSerialOutput ( GceAvdInfo infos, ITestLogger logger) GceAvdInfo で記述されたデバイスのシリアル出力をログに記録します。 |
static CommandResult | remoteSshCommandExecution ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command) インスタンス上で ssh 経由でリモート コマンドを実行します。 |
boolean | shutdownGce () startGce() に関連付けられた Gce インスタンスをシャットダウンします。 |
GceAvdInfo | startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes, ITestLogger logger) Acloud または Oxygen のいずれかを使用して gce インスタンスを起動してみます。 |
GceAvdInfo | startGce () |
GceAvdInfo | startGce (String ipDevice, MultiMap <String, String> attributes) gce インスタンスを起動してみます。 |
GceAvdInfo | startGce (String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) Acloud または Oxygen のいずれかを使用して gce インスタンスを起動してみます。 |
| startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos) このメソッドは廃止されました。 master ブランチが更新された後、これを削除します。 |
| startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes) startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes) Oxygen を使用してマルチデバイスの gce インスタンスを起動しようとします。 |
保護されたメソッド |
---|
| buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap <String, String> attributes) GCE を起動するコマンドをビルドして返します。 |
static | buildShutdownCommand (File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured) |
String | extractInstanceName (String bootupLogs) gce ブート ログからインスタンス名を取得します。 |
田畑
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
パブリックコンストラクター
Gceマネージャー
public GceManager (DeviceDescriptor deviceDesc,
TestDeviceOptions deviceOptions,
IBuildInfo buildInfo,
testResourceBuildInfos)
このコンストラクターは非推奨になりました。
他のコンストラクターを使用します。下位互換性のためにこれを一時的に保持します。
パラメーター |
---|
deviceDesc | DeviceDescriptor |
deviceOptions | TestDeviceOptions |
buildInfo | IBuildInfo |
testResourceBuildInfos | |
Gceマネージャー
public GceManager (DeviceDescriptor deviceDesc,
TestDeviceOptions deviceOptions,
IBuildInfo buildInfo,
String gceInstanceName,
String gceHost)
Ctor、直接使用する GCE インスタンス名を提供するために使用できるバリエーション。
パラメーター |
---|
deviceDesc | DeviceDescriptor : GCE デバイスに関連付けられるDeviceDescriptor 。 |
deviceOptions | TestDeviceOptions : デバイスに関連付けられたTestDeviceOptions |
buildInfo | IBuildInfo : 開始する gce ビルドを記述するIBuildInfo 。 |
gceInstanceName | String : 使用するインスタンス名。 |
gceHost | String : 使用するインスタンスのホスト名または IP。 |
パブリックメソッド
クラウドシャットダウン
public static boolean AcloudShutdown (TestDeviceOptions options,
IRunUtil runUtil,
String instanceName,
String hostname,
boolean isIpPreconfigured)
実際に Acloud を実行して仮想デバイスをシャットダウンします。
パラメーター |
---|
options | TestDeviceOptions : Acloud オプションのTestDeviceOptions |
runUtil | IRunUtil : Acloud を実行するためのIRunUtil |
instanceName | String : シャットダウンするインスタンス。 |
hostname | String : インスタンスのホスト名。Oxygen イカにのみ使用されます。 |
isIpPreconfigured | boolean : AVD が事前構成された IP を持つリモート デバイス上に作成されたかどうか |
掃除
public void cleanUp ()
getBugreportzWithSsh
public static File getBugreportzWithSsh (GceAvdInfo gceAvd,
TestDeviceOptions options,
IRunUtil runUtil)
adb 接続の潜在的な問題を回避するために、SSH を使用してデバイスからバグレポートを取得します。
戻り値 |
---|
File | zip バグレポートを指すファイル、または問題が発生した場合は null。 |
getInstanceSerialLog
public static String getInstanceSerialLog (GceAvdInfo infos,
File avdConfigFile,
File jsonKeyFile,
IRunUtil runUtil)
Gce Avd インスタンスのシリアル ログの現在の内容を読み取ります。
パラメーター |
---|
infos | GceAvdInfo : インスタンスを説明するGceAvdInfo 。 |
avdConfigFile | File : avd 設定ファイル |
jsonKeyFile | File : サービス アカウントの JSON キー ファイル。 |
runUtil | IRunUtil : コマンドを実行するためのIRunUtil 。 |
戻り値 |
---|
String | シリアル ログ出力、または何か問題が発生した場合は null。 |
getNestedDeviceSshBugreportz
public static File getNestedDeviceSshBugreportz (GceAvdInfo gceAvd,
TestDeviceOptions options,
IRunUtil runUtil)
ネストされたインスタンスのバグレポートを ssh 経由で取得します。これには、ネストされた仮想インスタンスで adb をリクエストする必要があります。
戻り値 |
---|
File | zip バグレポートを指すファイル、または問題が発生した場合は null。 |
logNestedRemoteFile
public static boolean logNestedRemoteFile (ITestLogger logger,
GceAvdInfo gceAvd,
TestDeviceOptions options,
IRunUtil runUtil,
String remoteFilePath,
LogDataType type,
String baseName)
ネストされたインスタンスからリモート ファイルをフェッチし、ログに記録します。
パラメーター |
---|
logger | ITestLogger : ファイルのログを記録するITestLogger 。 |
gceAvd | GceAvdInfo : デバイスを説明するGceAvdInfo 。 |
options | TestDeviceOptions : GCE デバイスに使用されるデバイス オプションを記述するTestDeviceOptions 。 |
runUtil | IRunUtil : コマンドを実行するためのIRunUtil 。 |
remoteFilePath | String : ファイルを見つけるリモート パス。 |
type | LogDataType : ログ ファイルのLogDataType 。 |
baseName | String : ファイルのログ記録に使用するベース名。 null の場合、実際のファイル名が使用されます。 |
戻り値 |
---|
boolean | ファイルが正常に記録されたかどうか。 |
リモートSshコマンド実行
public static CommandResult remoteSshCommandExecution (GceAvdInfo gceAvd,
TestDeviceOptions options,
IRunUtil runUtil,
long timeoutMs,
String... command)
インスタンス上で ssh 経由でリモート コマンドを実行します。
パラメーター |
---|
gceAvd | GceAvdInfo : デバイスを説明するGceAvdInfo 。 |
options | TestDeviceOptions : GCE デバイスに使用されるデバイス オプションを記述するTestDeviceOptions 。 |
runUtil | IRunUtil : コマンドを実行するためのIRunUtil 。 |
timeoutMs | long : コマンドのタイムアウト (ミリ秒単位)。 0 はタイムアウトがないことを意味します。 |
command | String : 実行するリモート コマンド。 |
シャットダウンGce
public boolean shutdownGce ()
startGce()
に関連付けられた Gce インスタンスをシャットダウンします。
戻り値 |
---|
boolean | gce シャットダウンがノンブロッキングとして要求された場合は true を返します。 |
スタートGce
public GceAvdInfo startGce (String ipDevice,
String user,
Integer offset,
MultiMap<String, String> attributes,
ITestLogger logger)
Acloud または Oxygen のいずれかを使用して gce インスタンスを起動してみます。
パラメーター |
---|
ipDevice | String : AVD を実行する GCE インスタンスの初期 IP、該当しない場合はnull |
user | String : AVD を実行しているホストのユーザー、該当しない場合はnull |
offset | Integer : ホスト内の AVD のデバイス番号オフセット、該当しない場合はnull |
attributes | MultiMap : 現在の呼び出しに関連付けられた属性。該当する情報を GCE インスタンスに渡して VM メタデータとして追加するために使用されます。 |
logger | ITestLogger : デバイス起動ログを記録するITestLogger 。 |
スタートGce
public GceAvdInfo startGce (String ipDevice,
MultiMap<String, String> attributes)
gce インスタンスを起動してみます。
パラメーター |
---|
ipDevice | String : AVD を実行する GCE インスタンスの初期 IP、該当しない場合はnull |
attributes | MultiMap : 現在の呼び出しに関連付けられた属性。該当する情報を GCE インスタンスに渡して VM メタデータとして追加するために使用されます。 |
スタートGce
public GceAvdInfo startGce (String ipDevice,
String user,
Integer offset,
MultiMap<String, String> attributes)
Acloud または Oxygen のいずれかを使用して gce インスタンスを起動してみます。
パラメーター |
---|
ipDevice | String : AVD を実行する GCE インスタンスの初期 IP、該当しない場合はnull |
user | String : AVD を実行しているホストのユーザー、該当しない場合はnull |
offset | Integer : ホスト内の AVD のデバイス番号オフセット、該当しない場合はnull |
attributes | MultiMap : 現在の呼び出しに関連付けられた属性。該当する情報を GCE インスタンスに渡して VM メタデータとして追加するために使用されます。 |
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos)
このメソッドは廃止されました。
master ブランチが更新された後、これを削除します。
startMultiDevicesGce
public startMultiDevicesGce ( buildInfos,
MultiMap<String, String> attributes)
Oxygen を使用してマルチデバイスの gce インスタンスを起動しようとします。
保護されたメソッド
buildGceCmd
protected buildGceCmd (File reportFile,
IBuildInfo b,
String ipDevice,
String user,
Integer offset,
MultiMap<String, String> attributes)
GCE を起動するコマンドをビルドして返します。テストのために露出しました。
パラメーター |
---|
reportFile | File |
b | IBuildInfo |
ipDevice | String |
user | String |
offset | Integer |
attributes | MultiMap |
buildShutdownコマンド
protected static buildShutdownCommand (File config,
TestDeviceOptions options,
String instanceName,
String hostname,
boolean isIpPreconfigured)
パラメーター |
---|
config | File |
options | TestDeviceOptions |
instanceName | String |
hostname | String |
isIpPreconfigured | boolean |
protected String extractInstanceName (String bootupLogs)
gce ブート ログからインスタンス名を取得します。 「名前」を検索します:「gce-」 ' パターンを使用してその名前を抽出します。 gce ブートが失敗すると、試行されたインスタンス名が json に表示されないため、結果ファイルではなくログから抽出します。