Cette page a été traduite par l'API Cloud Translation.

GceManager

public class GceManager
extends Object

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

Outil d'aide qui gère les appels GCE pour démarrer/arrêter et collecter des journaux à partir de GCE.

Résumé

Champs
`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`

Constructeurs publics
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)` Directeur
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos)` Ce constructeur est obsolète. Utilisez d'autres constructeurs. Nous conservons cette option temporairement pour assurer la rétrocompatibilité.
`GceManager(DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost)` Ctor, variante permettant de fournir le nom de l'instance GCE à utiliser directement.

Méthodes publiques
`static boolean`	`AcloudShutdown(TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname, boolean isIpPreconfigured)` Exécution réelle d'Acloud pour arrêter l'appareil virtuel.
`void`	`cleanUp()`
`static File`	`getBugreportzWithSsh(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Obtenez un bugreportz de l'appareil à l'aide de ssh pour éviter tout problème de connexion adb potentiel.
`static String`	`getInstanceSerialLog(GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil)` Lit le contenu actuel du journal de série de l'instance Gce Avd.
`static File`	`getNestedDeviceSshBugreportz(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil)` Obtenez un rapport de bug via SSH pour une instance imbriquée.
`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)` Extrayez un fichier distant à partir d'une instance imbriquée et consignez-le.
`static boolean`	`logNestedRemoteFile(ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName)` Extrayez un fichier distant à partir d'une instance imbriquée et consignez-le.
`void`	`logSerialOutput(GceAvdInfo infos, ITestLogger logger)` Consigner la sortie série d'un appareil décrit par `GceAvdInfo`.
`static CommandResult`	`remoteSshCommandExecution(GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command)` Exécutez la commande distante via SSH sur une instance.
`boolean`	`shutdownGce()` Arrêtez l'instance GCE associée à `startGce()`.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes, ITestLogger logger)` Essayez de démarrer une instance gce avec Acloud ou Oxygen.
`GceAvdInfo`	`startGce()`
`GceAvdInfo`	`startGce(String ipDevice, MultiMap<String, String> attributes)` Essayez de démarrer une instance gce.
`GceAvdInfo`	`startGce(String ipDevice, String user, Integer offset, MultiMap<String, String> attributes)` Essayez de démarrer une instance gce avec Acloud ou Oxygen.
	`startMultiDevicesGce( buildInfos)` Cette méthode est obsolète. Supprimez-le après la mise à jour de la branche principale.
	`startMultiDevicesGce( buildInfos, MultiMap<String, String> attributes)` Tentative de démarrage de l'instance gce multi-appareils avec Oxygen.

Méthodes protégées
`static`	`buildShutdownCommand(File config, TestDeviceOptions options, String instanceName, String hostname, boolean isIpPreconfigured)`
`String`	`extractInstanceName(String bootupLogs)` Récupérez le nom de l'instance à partir des journaux de démarrage gce.

Champs

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

Constructeurs publics

GceManager

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

Directeur

Paramètres
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` associé à l'appareil GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` associé à l'appareil.
`buildInfo`	`IBuildInfo`: `IBuildInfo` décrivant la compilation gce à démarrer.

GceManager

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

Ce constructeur est obsolète.
Utilisez d'autres constructeurs. Nous conservons cette option temporairement pour assurer la rétrocompatibilité.

Paramètres
`deviceDesc`	`DeviceDescriptor`
`deviceOptions`	`TestDeviceOptions`
`buildInfo`	`IBuildInfo`
`testResourceBuildInfos`

GceManager

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

Ctor, variante permettant de fournir le nom de l'instance GCE à utiliser directement.

Paramètres
`deviceDesc`	`DeviceDescriptor`: `DeviceDescriptor` associé à l'appareil GCE.
`deviceOptions`	`TestDeviceOptions`: `TestDeviceOptions` associé à l'appareil
`buildInfo`	`IBuildInfo`: `IBuildInfo` décrivant la compilation gce à démarrer.
`gceInstanceName`	`String`: nom de l'instance à utiliser.
`gceHost`	`String`: nom d'hôte ou adresse IP de l'instance à utiliser.

Méthodes publiques

AcloudShutdown

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

Exécution réelle d'Acloud pour arrêter l'appareil virtuel.

Paramètres
`options`	`TestDeviceOptions`: `TestDeviceOptions` pour les options Acloud
`runUtil`	`IRunUtil`: `IRunUtil` pour exécuter Acloud
`instanceName`	`String`: instance à arrêter
`hostname`	`String`: nom d'hôte de l'instance, uniquement utilisé pour la seiche à l'oxygène.
`isIpPreconfigured`	`boolean`: indique si l'AVD a été créé sur un appareil distant avec une adresse IP préconfigurée

Renvoie
`boolean`	"True" si la requête a réussi

cleanUp

public void cleanUp ()

getBugreportzWithSsh

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

Obtenez un rapport de bug de l'appareil en SSH pour éviter tout problème potentiel de connexion adb.

Paramètres
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` qui décrit l'appareil.
`options`	`TestDeviceOptions`: `TestDeviceOptions` décrivant les options d'appareil à utiliser pour l'appareil GCE.
`runUtil`	`IRunUtil`: `IRunUtil` permettant d'exécuter des commandes.

Renvoie
`File`	Fichier pointant vers le bugreport ZIP, ou valeur nulle en cas de problème.

Génère
	IOException

getInstanceSerialLog

public static String getInstanceSerialLog (GceAvdInfo infos, 
                File avdConfigFile, 
                File jsonKeyFile, 
                IRunUtil runUtil)

Lit le contenu actuel du journal série de l'instance Gce Avd.

Paramètres
`infos`	`GceAvdInfo`: `GceAvdInfo` décrivant l'instance.
`avdConfigFile`	`File`: fichier de configuration de l'AVD
`jsonKeyFile`	`File`: fichier de clé JSON du compte de service.
`runUtil`	`IRunUtil`: `IRunUtil` permettant d'exécuter des commandes.

Renvoie
`String`	Sortie du journal série ou valeur "null" en cas de problème.

getNestedDeviceSshBugreportz

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

Obtenir un rapport de bug via ssh pour une instance imbriquée Pour ce faire, vous devez demander l'adb dans l'instance virtuelle imbriquée.

Paramètres
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` qui décrit l'appareil.
`options`	`TestDeviceOptions`: `TestDeviceOptions` décrivant les options d'appareil à utiliser pour l'appareil GCE.
`runUtil`	`IRunUtil`: `IRunUtil` permettant d'exécuter des commandes.

Renvoie
`File`	Fichier pointant vers le bugreport ZIP, ou valeur nulle en cas de problème.

Génère
	IOException

logAndDeleteFile

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

Paramètres
`tempFile`	`File`
`dataName`	`String`
`logger`	`ITestLogger`

Répertoire des journaux

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

Paramètres
`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)

Extrayez un fichier distant à partir d'une instance imbriquée et consignez-le.

Paramètres
`logger`	`ITestLogger`: `ITestLogger` où consigner le fichier.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` décrivant l'appareil.
`options`	`TestDeviceOptions`: un `TestDeviceOptions` décrivant les options de l'appareil à utiliser pour l'appareil GCE.
`runUtil`	`IRunUtil`: `IRunUtil` permettant d'exécuter des commandes.
`remoteFilePath`	`String`: chemin d'accès distant du fichier.
`type`	`LogDataType`: `LogDataType` du fichier journalisé.

Renvoie
`boolean`	si le fichier a bien été enregistré.

logNestedRemoteFile

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

Extrayez un fichier distant à partir d'une instance imbriquée et consignez-le.

Paramètres
`logger`	`ITestLogger`: `ITestLogger` où enregistrer le fichier.
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` qui décrit l'appareil.
`options`	`TestDeviceOptions`: `TestDeviceOptions` décrivant les options d'appareil à utiliser pour l'appareil GCE.
`runUtil`	`IRunUtil`: `IRunUtil` permettant d'exécuter des commandes.
`remoteFilePath`	`String`: chemin d'accès distant du fichier.
`type`	`LogDataType`: `LogDataType` du fichier journalisé.
`baseName`	`String`: nom de base à utiliser pour consigner le fichier. Si la valeur est nulle, le nom de fichier réel est utilisé.

Renvoie
`boolean`	si le fichier a bien été enregistré.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Enregistre la sortie série d'un appareil décrit par GceAvdInfo.

Paramètres
`infos`	`GceAvdInfo`: `GceAvdInfo` décrivant l'instance.
`logger`	`ITestLogger`: `ITestLogger` où enregistrer le journal série.

RemoteSshCommandExecution

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

Exécutez la commande distante via SSH sur une instance.

Paramètres
`gceAvd`	`GceAvdInfo`: `GceAvdInfo` qui décrit l'appareil.
`options`	`TestDeviceOptions`: `TestDeviceOptions` décrivant les options d'appareil à utiliser pour l'appareil GCE.
`runUtil`	`IRunUtil`: `IRunUtil` permettant d'exécuter des commandes.
`timeoutMs`	`long`: délai d'expiration de la commande, en millisecondes. 0 signifie qu'il n'y a pas de délai avant expiration.
`command`	`String`: commande distante à exécuter.

Renvoie
`CommandResult`	`CommandResult` contenant le résultat de l'exécution.

shutdownGce

public boolean shutdownGce ()

Arrêtez l'instance Gce associée à startGce().

Renvoie
`boolean`	renvoie "true" si l'arrêt de gce a été demandé comme non bloquant.

démarrageGce

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

Essayez de démarrer une instance gce avec Acloud ou Oxygen.

Paramètres
`ipDevice`	`String`: adresse IP initiale de l'instance GCE dans laquelle exécuter l'AVD, `null` si non applicable
`user`	`String`: utilisateur hôte exécutant l'AVD, `null` si non applicable
`offset`	`Integer`: décalage de l'appareil num de l'AVD dans l'hôte, `null` si non applicable
`attributes`	`MultiMap`: attributs associés à l'appel en cours, utilisés pour transmettre les informations applicables à l'instance GCE à ajouter en tant que métadonnées de VM
`logger`	`ITestLogger`: `ITestLogger` dans lequel enregistrer les journaux de lancement de l'appareil.

Renvoie
`GceAvdInfo`	un `GceAvdInfo` décrivant l'instance GCE ; Il peut s'agir d'une instance BOOT_FAIL.

Génère
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

public GceAvdInfo startGce ()

Renvoie
`GceAvdInfo`

Génère
`TargetSetupError`

startGce

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

Tentative de démarrage d'une instance gce.

Paramètres
`ipDevice`	`String`: adresse IP initiale de l'instance GCE dans laquelle exécuter l'AVD, `null` si non applicable
`attributes`	`MultiMap`: attributs associés à l'appel en cours, utilisés pour transmettre les informations applicables à l'instance GCE à ajouter en tant que métadonnées de VM

Renvoie
`GceAvdInfo`	un `GceAvdInfo` décrivant l'instance GCE ; Il peut s'agir d'une instance BOOT_FAIL.

Génère
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startGce

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

Essayez de démarrer une instance gce avec Acloud ou Oxygen.

Paramètres
`ipDevice`	`String`: adresse IP initiale de l'instance GCE dans laquelle exécuter l'AVD, `null` si non applicable
`user`	`String`: utilisateur hôte exécutant l'AVD, `null` si non applicable
`offset`	`Integer`: décalage de l'appareil num de l'AVD dans l'hôte, `null` si non applicable
`attributes`	`MultiMap`: attributs associés à l'appel en cours, utilisés pour transmettre les informations applicables à l'instance GCE à ajouter en tant que métadonnées de VM

Renvoie
`GceAvdInfo`	un `GceAvdInfo` décrivant l'instance GCE. Il peut s'agir d'une instance BOOT_FAIL.

Génère
	com.android.tradefed.targetprep.TargetSetupError
`TargetSetupError`

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Cette méthode est obsolète.
Supprimez cette section une fois la branche principale mise à jour.

Paramètres
`buildInfos`

Renvoie

Génère
`TargetSetupError`

startMultiDevicesGce

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

Tentative de démarrage de l'instance gce multi-appareils avec Oxygen.

Paramètres
`buildInfos`	: `ERROR(/List)`
`attributes`	`MultiMap`: attributs associés à l'appel en cours

Renvoie
	un `ERROR(/List)` décrivant les informations Avd de GCE.

Génère
`TargetSetupError`

Méthodes protégées

buildShutdownCommand

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

Paramètres
`config`	`File`
`options`	`TestDeviceOptions`
`instanceName`	`String`
`hostname`	`String`
`isIpPreconfigured`	`boolean`

Renvoie

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Récupérez le nom de l'instance à partir des journaux de démarrage gce. Recherchez le format "name": "gce-" pour en extraire le nom. Nous extrayons les données à partir des journaux plutôt que du fichier de résultats, car en cas d'échec du démarrage de gce, le nom de l'instance tentée ne s'affiche pas dans le fichier JSON.

Paramètres
`bootupLogs`	`String`

Renvoie
`String`