GceManager

public class GceManager
extends Object

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

---

Helper qui gère les appels GCE pour démarrer/arrêter et collecter les journaux de GCE.

Sommaire

Des champs
public static final String	GCE_HOSTNAME_KEY
public static final String	GCE_INSTANCE_CLEANED_KEY
public static final String	GCE_INSTANCE_NAME_KEY

Constructeurs publics
GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo) Directeur
GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, testResourceBuildInfos) Ce constructeur est obsolète. Utilisez d'autres constructeurs, nous gardons cela temporairement pour une compatibilité descendante.
GceManager (DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo, String gceInstanceName, String gceHost) Ctor, variante qui peut être utilisée pour fournir le nom de l'instance GCE à utiliser directement.

Méthodes publiques
static boolean	AcloudShutdown (TestDeviceOptions options, IRunUtil runUtil, String instanceName, String hostname) Exécution réelle d'Acloud pour arrêter le périphérique virtuel.
void	cleanUp ()
static File	getBugreportzWithSsh ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Obtenez un rapport de bogue de l'appareil à l'aide de ssh pour éviter tout problème potentiel de connexion adb.
static String	getInstanceSerialLog ( GceAvdInfo infos, File avdConfigFile, File jsonKeyFile, IRunUtil runUtil) Lit le contenu actuel du journal série de l'instance Gce Avd.
static File	getNestedDeviceSshBugreportz ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil) Obtenez un rapport de bogue via ssh pour une instance imbriquée.
static void	logNestedRemoteFile (ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type) Récupérez un fichier distant à partir d'une instance imbriquée et enregistrez-le.
static void	logNestedRemoteFile (ITestLogger logger, GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, String remoteFilePath, LogDataType type, String baseName) Récupérez un fichier distant à partir d'une instance imbriquée et enregistrez-le.
void	logSerialOutput ( GceAvdInfo infos, ITestLogger logger) Se connecter la sortie série d'un dispositif décrit par GceAvdInfo .
static CommandResult	remoteSshCommandExecution ( GceAvdInfo gceAvd, TestDeviceOptions options, IRunUtil runUtil, long timeoutMs, String... command) Exécutez la commande à distance via ssh sur une instance.
boolean	shutdownGce () Arrêter l'instance Gce associé au startGce() .
GceAvdInfo	startGce ()
GceAvdInfo	startGce (String ipDevice, MultiMap<String, String> attributes) Tenter de démarrer une instance gce

Méthodes protégées
	buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, MultiMap<String, String> attributes) Générez et renvoyez la commande pour lancer GCE.
String	extractInstanceName (String bootupLogs) Récupérez le nom de l'instance dans les journaux de démarrage gce.

Des 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

Constructeurs publics

GceManager

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

Directeur

Paramètres
deviceDesc	DeviceDescriptor : Le DeviceDescriptor qui sera associé au dispositif de GCE.
deviceOptions	TestDeviceOptions : A TestDeviceOptions associés au dispositif.
buildInfo	IBuildInfo : Un IBuildInfo décrivant la construction de GCE pour commencer.

GceManager

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

Ce constructeur est obsolète.
Utilisez d'autres constructeurs, nous gardons cela temporairement pour une compatibilité descendante.

Paramètres
deviceDesc	DeviceDescriptor
deviceOptions	TestDeviceOptions
buildInfo	IBuildInfo
testResourceBuildInfos

GceManager

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

Ctor, variante qui peut être utilisée pour fournir le nom de l'instance GCE à utiliser directement.

Paramètres
deviceDesc	DeviceDescriptor : Le DeviceDescriptor qui sera associé au dispositif de GCE.
deviceOptions	TestDeviceOptions : A TestDeviceOptions associés au dispositif
buildInfo	IBuildInfo : Un IBuildInfo décrivant la construction de GCE pour commencer.
gceInstanceName	String : Le nom d'instance à utiliser.
gceHost	String : Le nom d'hôte ou IP de l'instance à utiliser.

Méthodes publiques

AcloudShutdown

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

Exécution réelle d'Acloud pour arrêter le périphérique virtuel.

Paramètres
options	TestDeviceOptions : Les TestDeviceOptions pour les options Acloud
runUtil	IRunUtil : Le IRunUtil à courir Acloud
instanceName	String : L'instance à l' arrêt.
hostname	String : nom d' hôte de l'instance, utilisé uniquement pour les seiches d'oxygène.

Retour
boolean	Vrai si réussi

nettoyer

public void cleanUp ()

getBugreportzWithSsh

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

Obtenez un rapport de bogue de l'appareil à l'aide de ssh pour éviter tout problème potentiel de connexion adb.

Paramètres
gceAvd	GceAvdInfo : Le GceAvdInfo qui décrivent l'appareil.
options	TestDeviceOptions : un TestDeviceOptions décrivant les options de l' appareil à utiliser pour le dispositif de GCE.
runUtil	IRunUtil : un IRunUtil d'exécuter des commandes.

Retour
File	Un fichier pointant vers le rapport de bogue zip, ou null si un problème s'est produit.

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 : Le GceAvdInfo décrivant l'instance.
avdConfigFile	File : le fichier de configuration AVD
jsonKeyFile	File : le compte de service fichier clé JSON.
runUtil	IRunUtil : un IRunUtil d'exécuter des commandes.

Retour
String	La sortie du journal série ou null si quelque chose ne va pas.

getNestedDeviceSshBugreportz

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

Obtenez un rapport de bogue via ssh pour une instance imbriquée. Cela nécessite de demander l'adb dans l'instance virtuelle imbriquée.

Paramètres
gceAvd	GceAvdInfo : Le GceAvdInfo qui décrivent l'appareil.
options	TestDeviceOptions : un TestDeviceOptions décrivant les options de l' appareil à utiliser pour le dispositif de GCE.
runUtil	IRunUtil : un IRunUtil d'exécuter des commandes.

Retour
File	Un fichier pointant vers le rapport de bogue zip, ou null si un problème s'est produit.

logNestedRemoteFile

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

Récupérez un fichier distant à partir d'une instance imbriquée et enregistrez-le.

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

logNestedRemoteFile

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

Récupérez un fichier distant à partir d'une instance imbriquée et enregistrez-le.

Paramètres
logger	ITestLogger : Le ITestLogger où le fichier journal.
gceAvd	GceAvdInfo : Le GceAvdInfo qui décrivent l'appareil.
options	TestDeviceOptions : un TestDeviceOptions décrivant les options de l' appareil à utiliser pour le dispositif de GCE.
runUtil	IRunUtil : un IRunUtil d'exécuter des commandes.
remoteFilePath	String : Le chemin d' accès distant où trouver le fichier.
type	LogDataType : le LogDataType du fichier journalisé.
baseName	String : Le nom de base à utiliser pour enregistrer le fichier. Si null, le nom de fichier réel sera utilisé.

logSérieSortie

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Se connecter la sortie série d'un dispositif décrit par GceAvdInfo .

Paramètres
infos	GceAvdInfo : Le GceAvdInfo décrivant l'instance.
logger	ITestLogger : Le ITestLogger où se connecter le journal de série.

remoteSshCommandExecution

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

Exécutez la commande à distance via ssh sur une instance.

Paramètres
gceAvd	GceAvdInfo : Le GceAvdInfo qui décrivent l'appareil.
options	TestDeviceOptions : un TestDeviceOptions décrivant les options de l' appareil à utiliser pour le dispositif de GCE.
runUtil	IRunUtil : un IRunUtil d'exécuter des commandes.
timeoutMs	long : Le délai d' attente en millisecondes pour la commande. 0 signifie pas de délai d'attente.
command	String : La commande à distance pour exécuter.

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

arrêtGce

public boolean shutdownGce ()

Arrêter l'instance Gce associé au startGce() .

Retour
boolean	renvoie vrai si l'arrêt de gce a été demandé comme non bloquant.

startGce

public GceAvdInfo startGce ()

Retour
GceAvdInfo

Jetés
TargetSetupError

startGce

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

Tenter de démarrer une instance gce

Paramètres
ipDevice	String : la première IP de l'instance de GCE pour exécuter AVD dans, null si non applicable
attributes	MultiMap : les attributs associés à l' appel en cours, utilisé pour transmettre des informations applicables jusqu'à l'instance de GCE à ajouter sous forme de métadonnées VM

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

Jetés
TargetSetupError

Méthodes protégées

buildGceCmd

protected  buildGceCmd (File reportFile, 
                IBuildInfo b, 
                String ipDevice, 
                MultiMap<String, String> attributes)

Générez et renvoyez la commande pour lancer GCE. Exposé pour les tests.

Paramètres
reportFile	File
b	IBuildInfo
ipDevice	String
attributes	MultiMap

Retour

extraitNomInstance

protected String extractInstanceName (String bootupLogs)

Récupérez le nom de l'instance dans les journaux de démarrage gce. Recherchez le 'nom' : 'gce- ' pour en extraire le nom. Nous extrayons des journaux au lieu du fichier de résultats car en cas d'échec du démarrage de gce, le nom de l'instance tentée ne s'affichera pas dans json.

Paramètres
bootupLogs	String

Retour
String