2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main 대신 android-latest-release를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

GceManager

public class GceManager
extends Object

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

GCE 호출을 관리하여 GCE에서 로그를 시작/중지하고 수집하는 도우미

요약

상수
`String`	`GCE_HOSTNAME_KEY`
`String`	`GCE_INSTANCE_CLEANED_KEY`
`String`	`GCE_INSTANCE_NAME_KEY`
`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, String gceInstanceName, String gceHost)` 직접 사용할 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를 사용하여 기기에서 bugreportz를 가져옵니다.
`HostOrchestratorUtil`	`getHostOrchestratorUtil()` `HostOrchestratorUtil`의 인스턴스를 반환합니다.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Gce Avd 인스턴스 직렬 로그의 현재 콘텐츠를 읽습니다.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` 중첩된 인스턴스의 ssh를 통해 bugreport를 가져옵니다.
`static void`	`logAndDeleteFile(File tempFile, String dataName, ITestLogger logger)`
`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)` 중첩된 인스턴스에서 원격 파일을 가져와 로깅합니다.
`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, MultiMap<String, String> attributes)` Oxygen으로 멀티 디바이스 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-hostname'

GCE_INSTANCE_CLEANED_KEY

public static final String GCE_INSTANCE_CLEANED_KEY

상수 값: 'gce-instance-clean-called'

GCE_INSTANCE_NAME_KEY

public static final String GCE_INSTANCE_NAME_KEY

상수 값: 'gce-instance-name'

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

상수 값: 'gce-ip-pre-configured'

공개 생성자

GceManager

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

Ctor

매개변수
`deviceDesc`	`DeviceDescriptor`: GCE 기기와 연결될 `DeviceDescriptor`입니다.
`deviceOptions`	`TestDeviceOptions`: 기기와 연결된 `TestDeviceOptions`입니다.
`buildInfo`	`IBuildInfo`: 시작할 gce 빌드를 설명하는 `IBuildInfo`입니다.

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)

직접 사용할 GCE 인스턴스 이름을 제공하는 데 사용할 수 있는 변형입니다.

매개변수
`deviceDesc`	`DeviceDescriptor`: GCE 기기와 연결될 `DeviceDescriptor`입니다.
`deviceOptions`	`TestDeviceOptions`: 기기와 연결된 `TestDeviceOptions`
`buildInfo`	`IBuildInfo`: 시작할 gce 빌드를 설명하는 `IBuildInfo`입니다.
`gceInstanceName`	`String`: 사용할 인스턴스 이름입니다.
`gceHost`	`String`: 사용할 인스턴스의 호스트 이름 또는 IP입니다.

공개 메서드

AcloudShutdown

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 cuttlefish에만 사용됩니다.
`isIpPreconfigured`	`boolean`: 미리 구성된 IP가 있는 원격 기기에서 AVD가 생성되었는지 여부

반환 값
`boolean`	성공하면 true

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

adb 연결 잠재적 문제를 방지하기 위해 ssh를 사용하여 기기에서 bugreportz를 가져옵니다.

매개변수
`gceAvd`	`GceAvdInfo`: 기기를 설명하는 `GceAvdInfo`입니다.
`options`	`TestDeviceOptions`: GCE 기기에 사용할 기기 옵션을 설명하는 `TestDeviceOptions`입니다.
`runUtil`	`IRunUtil`: 명령어를 실행할 `IRunUtil`입니다.

반환 값
`File`	zip 버그 신고를 가리키는 파일입니다. 문제가 발생한 경우 null입니다.

생성 값
	IOException

getHostOrchestratorUtil

public HostOrchestratorUtil getHostOrchestratorUtil ()

HostOrchestratorUtil의 인스턴스를 반환합니다.

반환 값
`HostOrchestratorUtil`

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를 통해 bugreport를 가져옵니다. 이렇게 하려면 중첩된 가상 인스턴스에서 adb를 요청해야 합니다.

매개변수
`gceAvd`	`GceAvdInfo`: 기기를 설명하는 `GceAvdInfo`입니다.
`options`	`TestDeviceOptions`: GCE 기기에 사용할 기기 옵션을 설명하는 `TestDeviceOptions`입니다.
`runUtil`	`IRunUtil`: 명령어를 실행할 `IRunUtil`입니다.

반환 값
`File`	zip 버그 신고를 가리키는 파일입니다. 문제가 발생한 경우 null입니다.

생성 값
	IOException

logAndDeleteFile

public static void logAndDeleteFile (File tempFile, 
                String dataName, 
                ITestLogger logger)

매개변수
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

logDirectory

public static void logDirectory (File remoteDirectory, 
                String baseName, 
                ITestLogger logger, 
                LogDataType type)

매개변수
`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)

중첩된 인스턴스에서 원격 파일을 가져와 로깅합니다.

매개변수
`logger`	`ITestLogger`: 파일을 로깅할 `ITestLogger`입니다.
`gceAvd`	`GceAvdInfo`: 기기를 설명하는 `GceAvdInfo`입니다.
`options`	`TestDeviceOptions`: GCE 기기에 사용할 기기 옵션을 설명하는 `TestDeviceOptions`입니다.
`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`: GCE 기기에 사용할 기기 옵션을 설명하는 `TestDeviceOptions`입니다.
`runUtil`	`IRunUtil`: 명령어를 실행할 `IRunUtil`입니다.
`remoteFilePath`	`String`: 파일을 찾을 수 있는 원격 경로입니다.
`type`	`LogDataType`: 로깅된 파일의 `LogDataType`입니다.
`baseName`	`String`: 파일을 로깅하는 데 사용할 기본 이름입니다. null이면 실제 파일 이름이 사용됩니다.

반환 값
`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`: GCE 기기에 사용할 기기 옵션을 설명하는 `TestDeviceOptions`입니다.
`runUtil`	`IRunUtil`: 명령어를 실행할 `IRunUtil`입니다.
`timeoutMs`	`long`: 명령의 제한 시간(밀리초)입니다. 0은 제한 시간이 없음을 의미합니다.
`command`	`String`: 실행할 원격 명령어입니다.

반환 값
`CommandResult`	실행 결과를 포함하는 `CommandResult`

shutdownGce

public boolean shutdownGce ()

startGce()와 연결된 Gce 인스턴스를 종료합니다.

반환 값
`boolean`	gce 종료가 비차단으로 요청된 경우 true를 반환합니다.

startGce

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`: 현재 호출과 연결된 속성으로, VM 메타데이터로 추가될 GCE 인스턴스에 관련 정보를 전달하는 데 사용됩니다.
`logger`	`ITestLogger`: 기기 실행 로그를 기록할 `ITestLogger`입니다.

반환 값
`GceAvdInfo`	GCE 인스턴스를 설명하는 `GceAvdInfo` BOOT_FAIL 인스턴스일 수 있습니다.

생성 값
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

반환 값
`GceAvdInfo`

생성 값
`TargetSetupError`

startGce

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

gce 인스턴스를 시작하려고 시도합니다.

매개변수
`ipDevice`	`String`: AVD를 실행할 GCE 인스턴스의 초기 IP입니다. 해당하지 않는 경우 `null`입니다.
`attributes`	`MultiMap`: 현재 호출과 연결된 속성으로, VM 메타데이터로 추가될 GCE 인스턴스에 관련 정보를 전달하는 데 사용됩니다.

반환 값
`GceAvdInfo`	GCE 인스턴스를 설명하는 `GceAvdInfo` BOOT_FAIL 인스턴스일 수 있습니다.

생성 값
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

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`: 현재 호출과 연결된 속성으로, VM 메타데이터로 추가될 GCE 인스턴스에 관련 정보를 전달하는 데 사용됩니다.

반환 값
`GceAvdInfo`	GCE 인스턴스를 설명하는 `GceAvdInfo` BOOT_FAIL 인스턴스일 수 있습니다.

생성 값
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

이 메서드는 지원 중단되었습니다.
마스터 브랜치가 업데이트된 후 삭제하세요.

매개변수
`buildInfos`

반환 값

생성 값
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos, 
                MultiMap<String, String> attributes)

Oxygen으로 멀티 디바이스 GCE 인스턴스를 시작하려고 시도합니다.

매개변수
`buildInfos`	: `ERROR(/List)`
`attributes`	`MultiMap`: 현재 호출과 연결된 속성

반환 값
	GCE Avd 정보를 설명하는 `ERROR(/List)`

생성 값
`TargetSetupError`

보호된 메서드

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 부팅 로그에서 인스턴스 이름을 가져옵니다. 'name'을 검색합니다. 'gce-' 패턴을 사용하여 이름을 추출합니다. GCE 부팅 실패 시도된 인스턴스 이름이 json에 표시되지 않으므로 결과 파일 대신 로그에서 추출합니다.

매개변수
`bootupLogs`	`String`

반환 값
`String`