GceManager

public class GceManager
extends Object

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


ผู้ช่วยที่จัดการการเรียก GCE เพื่อเริ่ม/หยุดและรวบรวมบันทึกจาก GCE

สรุป

ทุ่งนา

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

ผู้สร้างสาธารณะ

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Ctor

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)

รับรายงานข้อผิดพลาดจากอุปกรณ์โดยใช้ ssh เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นในการเชื่อมต่อ adb

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

ปิดอินสแตนซ์ Gce ที่เชื่อมโยงกับ startGce()

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

พยายามเริ่มต้นอินสแตนซ์ gce ด้วย Acloud หรือ Oxygen

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

พยายามเริ่มต้นอินสแตนซ์ gce

startMultiDevicesGce ( buildInfos) startMultiDevicesGce ( buildInfos)

พยายามเริ่มต้นอินสแตนซ์หลายอุปกรณ์ด้วย Oxygen

วิธีการป้องกัน

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

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

ผู้สร้างสาธารณะ

GceManager

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

Ctor

พารามิเตอร์
deviceDesc DeviceDescriptor : DeviceDescriptor ที่จะเชื่อมโยงกับอุปกรณ์ GCE

deviceOptions TestDeviceOptions : TestDeviceOptions ที่เกี่ยวข้องกับอุปกรณ์

buildInfo IBuildInfo : IBuildInfo ที่อธิบายการสร้าง gce เพื่อเริ่มต้น

GceManager

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

ตัวสร้างนี้เลิกใช้แล้ว
ใช้ตัวสร้างอื่น เราเก็บสิ่งนี้ไว้ชั่วคราวเพื่อความเข้ากันได้แบบย้อนหลัง

พารามิเตอร์
deviceDesc DeviceDescriptor

deviceOptions TestDeviceOptions

buildInfo IBuildInfo

testResourceBuildInfos

GceManager

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

Ctor รูปแบบที่สามารถใช้เพื่อให้ชื่ออินสแตนซ์ GCE ใช้งานได้โดยตรง

พารามิเตอร์
deviceDesc DeviceDescriptor : DeviceDescriptor ที่จะเชื่อมโยงกับอุปกรณ์ GCE

deviceOptions TestDeviceOptions : TestDeviceOptions ที่เกี่ยวข้องกับอุปกรณ์

buildInfo IBuildInfo : IBuildInfo ที่อธิบายการสร้าง gce เพื่อเริ่มต้น

gceInstanceName String : ชื่ออินสแตนซ์ที่จะใช้

gceHost String : ชื่อโฮสต์หรือ ip ของอินสแตนซ์ที่จะใช้

วิธีการสาธารณะ

AcloudShutdown

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

Acloud จริงทำงานเพื่อปิดอุปกรณ์เสมือน

พารามิเตอร์
options TestDeviceOptions : TestDeviceOptions สำหรับตัวเลือก Acloud

runUtil IRunUtil : IRunUtil เพื่อเรียกใช้ Acloud

instanceName String : อินสแตนซ์ที่จะปิดระบบ

hostname String : ชื่อโฮสต์ของอินสแตนซ์ ใช้สำหรับ Oxygen cuttlefish เท่านั้น

isIpPreconfigured boolean : มีการสร้าง AVD บนอุปกรณ์ระยะไกลด้วย IP ที่กำหนดค่าไว้ล่วงหน้าหรือไม่

คืนสินค้า
boolean จริงถ้าสำเร็จ

ทำความสะอาด

public void cleanUp ()

getBugreportzWithSsh

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

รับรายงานข้อผิดพลาดจากอุปกรณ์โดยใช้ ssh เพื่อหลีกเลี่ยงปัญหาที่อาจเกิดขึ้นในการเชื่อมต่อ adb

พารามิเตอร์
gceAvd GceAvdInfo : GceAvdInfo ที่อธิบายอุปกรณ์

options TestDeviceOptions : TestDeviceOptions ที่อธิบายตัวเลือกอุปกรณ์ที่จะใช้สำหรับอุปกรณ์ GCE

runUtil IRunUtil : IRunUtil เพื่อรันคำสั่ง

คืนสินค้า
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 ในอินสแตนซ์เสมือนที่ซ้อนกัน

พารามิเตอร์
gceAvd GceAvdInfo : GceAvdInfo ที่อธิบายอุปกรณ์

options TestDeviceOptions : TestDeviceOptions ที่อธิบายตัวเลือกอุปกรณ์ที่จะใช้สำหรับอุปกรณ์ GCE

runUtil IRunUtil : IRunUtil เพื่อรันคำสั่ง

คืนสินค้า
File ไฟล์ที่ชี้ไปที่รายงานจุดบกพร่องของ zip หรือเป็นค่า null หากเกิดปัญหาขึ้น

logNestedRemoteFile

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

ดึงไฟล์ระยะไกลจากอินสแตนซ์ที่ซ้อนกันและบันทึก

พารามิเตอร์
logger ITestLogger : ITestLogger ตำแหน่งที่จะบันทึกไฟล์

gceAvd GceAvdInfo : GceAvdInfo ที่อธิบายอุปกรณ์

options TestDeviceOptions : TestDeviceOptions ที่อธิบายตัวเลือกอุปกรณ์ที่จะใช้สำหรับอุปกรณ์ GCE

runUtil IRunUtil : IRunUtil เพื่อรันคำสั่ง

remoteFilePath String : เส้นทางระยะไกลที่จะค้นหาไฟล์

type LogDataType : LogDataType ของไฟล์ที่บันทึก

คืนสินค้า
boolean ไฟล์ถูกบันทึกสำเร็จหรือไม่

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 : TestDeviceOptions ที่อธิบายตัวเลือกอุปกรณ์ที่จะใช้สำหรับอุปกรณ์ GCE

runUtil IRunUtil : IRunUtil เพื่อรันคำสั่ง

remoteFilePath String : เส้นทางระยะไกลที่จะค้นหาไฟล์

type LogDataType : LogDataType ของไฟล์ที่บันทึก

baseName String : ชื่อฐานที่ใช้บันทึกไฟล์ หากเป็นโมฆะ ชื่อไฟล์จริงจะถูกใช้

คืนสินค้า
boolean ไฟล์ถูกบันทึกสำเร็จหรือไม่

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

บันทึกเอาต์พุตอนุกรมของอุปกรณ์ที่อธิบายโดย GceAvdInfo

พารามิเตอร์
infos GceAvdInfo : GceAvdInfo ที่อธิบายอินสแตนซ์

logger ITestLogger : ITestLogger ตำแหน่งที่จะบันทึกซีเรียลล็อก

remoteSshCommandExecution

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

ดำเนินการคำสั่งระยะไกลผ่าน ssh บนอินสแตนซ์

พารามิเตอร์
gceAvd GceAvdInfo : GceAvdInfo ที่อธิบายอุปกรณ์

options TestDeviceOptions : TestDeviceOptions ที่อธิบายตัวเลือกอุปกรณ์ที่จะใช้สำหรับอุปกรณ์ GCE

runUtil IRunUtil : IRunUtil เพื่อรันคำสั่ง

timeoutMs long : ระยะหมดเวลาในหน่วยมิลลิวินาทีสำหรับคำสั่ง 0 หมายถึงไม่มีการหมดเวลา

command String : คำสั่งระยะไกลที่จะดำเนินการ

คืนสินค้า
CommandResult CommandResult ที่มีผลลัพธ์ของการดำเนินการ

ปิดGce

public boolean shutdownGce ()

ปิดอินสแตนซ์ Gce ที่เชื่อมโยงกับ startGce()

คืนสินค้า
boolean คืนค่า true หากมีการร้องขอการปิดระบบ gce เนื่องจากไม่มีการบล็อก

startGce

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

พยายามเริ่มต้นอินสแตนซ์ gce ด้วย Acloud หรือ Oxygen

พารามิเตอร์
ipDevice String : IP เริ่มต้นของอินสแตนซ์ GCE ที่จะเรียกใช้ AVD เป็น null หากใช้ไม่ได้

user String : โฮสต์ที่รันผู้ใช้ AVD, null ถ้าใช้ไม่ได้

offset Integer : ค่าออฟเซ็ต num ของอุปกรณ์ของ AVD ในโฮสต์, null ถ้าใช้ไม่ได้

attributes MultiMap : แอตทริบิวต์ที่เกี่ยวข้องกับการเรียกใช้ปัจจุบัน ใช้สำหรับส่งข้อมูลที่เกี่ยวข้องไปยังอินสแตนซ์ GCE เพื่อเพิ่มเป็นข้อมูลเมตาของ VM

คืนสินค้า
GceAvdInfo GceAvdInfo ที่อธิบายอินสแตนซ์ GCE อาจเป็นอินสแตนซ์ BOOT_FAIL

ขว้าง
TargetSetupError

startGce

public GceAvdInfo startGce ()

คืนสินค้า
GceAvdInfo

ขว้าง
TargetSetupError

startGce

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

พยายามเริ่มต้นอินสแตนซ์ gce

พารามิเตอร์
ipDevice String : IP เริ่มต้นของอินสแตนซ์ GCE ที่จะเรียกใช้ AVD เป็น null หากใช้ไม่ได้

attributes MultiMap : แอตทริบิวต์ที่เกี่ยวข้องกับการเรียกใช้ปัจจุบัน ใช้สำหรับส่งข้อมูลที่เกี่ยวข้องไปยังอินสแตนซ์ GCE เพื่อเพิ่มเป็นข้อมูลเมตาของ VM

คืนสินค้า
GceAvdInfo GceAvdInfo ที่อธิบายอินสแตนซ์ GCE อาจเป็นอินสแตนซ์ BOOT_FAIL

ขว้าง
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

พยายามเริ่มต้นอินสแตนซ์หลายอุปกรณ์ด้วย Oxygen

พารามิเตอร์
buildInfos : ERROR(/List ) ERROR(/List )

คืนสินค้า
ERROR(/List ) ERROR(/List ) อธิบายข้อมูล GCE Avd

ขว้าง
TargetSetupError

วิธีการป้องกัน

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

คืนสินค้า

buildShutdownCommand

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

พารามิเตอร์
config File

options TestDeviceOptions

instanceName String

hostname String

isIpPreconfigured boolean

คืนสินค้า

extractInstanceName

protected String extractInstanceName (String bootupLogs)

ดึงชื่ออินสแตนซ์จากบันทึกการบูต gce ค้นหา 'ชื่อ': 'gce- ' รูปแบบการดึงชื่อของมัน. เราดึงข้อมูลจากบันทึกแทนไฟล์ผลลัพธ์ เนื่องจากเมื่อบูต gce ล้มเหลว ชื่ออินสแตนซ์ที่พยายามจะไม่แสดงใน json

พารามิเตอร์
bootupLogs String

คืนสินค้า
String