GceManager

public class GceManager
extends Object

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

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

Résumé

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

public static final String GCE_IP_PRECONFIGURED_KEY

Constructeurs publics

GceManager ( DeviceDescriptor deviceDesc, TestDeviceOptions deviceOptions, IBuildInfo buildInfo)

Cteur

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 les gardons temporairement pour une compatibilité descendante.

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

Ctor, variation 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, boolean isIpPreconfigured)

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 de 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 boolean 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 boolean 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)

Enregistrez la sortie série d'un périphérique 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ê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) 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) startMultiDevicesGce ( buildInfos, MultiMap <String, String> attributes)

Essayez de démarrer une instance gce multi-appareils avec Oxygen.

Méthodes protégées

buildGceCmd (File reportFile, IBuildInfo b, String ipDevice, String user, Integer offset, MultiMap <String, String> attributes)

Compilez et renvoyez la commande pour lancer GCE.

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.

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

GCE_IP_PRECONFIGURED_KEY

public static final String GCE_IP_PRECONFIGURED_KEY

Constructeurs publics

GceManager

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

Cteur

Paramètres
deviceDesc DeviceDescriptor : le DeviceDescriptor qui sera associé à l'appareil GCE.

deviceOptions TestDeviceOptions : Une TestDeviceOptions associée à l'appareil.

buildInfo IBuildInfo : un IBuildInfo décrivant la génération gce à démarrer.

GceManager

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

Ce constructeur est obsolète.
Utilisez d'autres constructeurs, nous les gardons 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, variation qui peut être utilisée pour fournir le nom de l'instance GCE à utiliser directement.

Paramètres
deviceDesc DeviceDescriptor : le DeviceDescriptor qui sera associé à l'appareil GCE.

deviceOptions TestDeviceOptions : Une TestDeviceOptions associée à l'appareil

buildInfo IBuildInfo : un IBuildInfo décrivant la génération gce à démarrer.

gceInstanceName String : Le nom de l'instance à utiliser.

gceHost String : Le nom d'hôte ou l'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 le périphérique virtuel.

Paramètres
options TestDeviceOptions : Les TestDeviceOptions pour les options Acloud

runUtil IRunUtil : L' IRunUtil pour exécuter Acloud

instanceName String : l'instance à arrêter.

hostname String : nom d'hôte de l'instance, utilisé uniquement pour la seiche Oxygen.

isIpPreconfigured boolean : si l'AVD a été créé sur un appareil distant avec une adresse IP préconfigurée

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écrit l'appareil.

options TestDeviceOptions : un TestDeviceOptions décrivant les options de périphérique à utiliser pour le périphérique GCE.

runUtil IRunUtil : un IRunUtil pour exécuter des commandes.

Retour
File Un fichier pointant vers le rapport de bogue zip, ou nul si un problème est survenu.

Lance
IOException

getInstanceSerialLog

public 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.

Paramètres
infos GceAvdInfo : Le GceAvdInfo décrivant l'instance.

avdConfigFile File : le fichier de configuration avd

jsonKeyFile File : le fichier de clé JSON du compte de service.

runUtil IRunUtil : un IRunUtil pour exécuter des commandes.

Retour
String La sortie du journal série ou null en cas de problème.

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écrit l'appareil.

options TestDeviceOptions : un TestDeviceOptions décrivant les options de périphérique à utiliser pour le périphérique GCE.

runUtil IRunUtil : un IRunUtil pour exécuter des commandes.

Retour
File Un fichier pointant vers le rapport de bogue zip, ou nul si un problème est survenu.

Lance
IOException

logNestedRemoteFile

public static boolean 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 : L' ITestLogger où enregistrer le fichier.

gceAvd GceAvdInfo : Le GceAvdInfo qui décrit l'appareil.

options TestDeviceOptions : un TestDeviceOptions décrivant les options de périphérique à utiliser pour le périphérique GCE.

runUtil IRunUtil : un IRunUtil pour exécuter des commandes.

remoteFilePath String : Le chemin distant où trouver le fichier.

type LogDataType : le LogDataType du fichier journalisé.

Retour
boolean si le fichier est enregistré avec succès.

logNestedRemoteFile

public static boolean 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 : L' ITestLogger où enregistrer le fichier.

gceAvd GceAvdInfo : Le GceAvdInfo qui décrit l'appareil.

options TestDeviceOptions : un TestDeviceOptions décrivant les options de périphérique à utiliser pour le périphérique GCE.

runUtil IRunUtil : un IRunUtil pour exécuter des commandes.

remoteFilePath String : Le chemin distant où trouver le fichier.

type LogDataType : le LogDataType du fichier journalisé.

baseName String : Le nom de base à utiliser pour journaliser le fichier. Si null, le nom de fichier réel sera utilisé.

Retour
boolean si le fichier est enregistré avec succès.

logSerialOutput

public void logSerialOutput (GceAvdInfo infos, 
                ITestLogger logger)

Enregistrez la sortie série d'un périphérique décrit par GceAvdInfo .

Paramètres
infos GceAvdInfo : Le GceAvdInfo décrivant l'instance.

logger ITestLogger : L' 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 à distance via ssh sur une instance.

Paramètres
gceAvd GceAvdInfo : Le GceAvdInfo qui décrit l'appareil.

options TestDeviceOptions : un TestDeviceOptions décrivant les options de périphérique à utiliser pour le périphérique GCE.

runUtil IRunUtil : un IRunUtil pour 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 distante à exécuter.

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

shutdownGce

public boolean shutdownGce ()

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

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

startGce

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 : l'adresse IP initiale de l'instance GCE dans laquelle exécuter AVD, null si non applicable

user String : l'hôte exécutant l'utilisateur d'AVD, null si non applicable

offset Integer : le décalage du numéro de périphérique 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 : L' ITestLogger où enregistrer les journaux de lancement de l'appareil.

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

Lance
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startGce

public GceAvdInfo startGce ()

Retour
GceAvdInfo

Lance
TargetSetupError

startGce

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

Essayez de démarrer une instance gce.

Paramètres
ipDevice String : l'adresse IP initiale de l'instance GCE dans laquelle exécuter 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

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

Lance
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 : l'adresse IP initiale de l'instance GCE dans laquelle exécuter AVD, null si non applicable

user String : l'hôte exécutant l'utilisateur d'AVD, null si non applicable

offset Integer : le décalage du numéro de périphérique 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

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

Lance
com.android.tradefed.targetprep.TargetSetupError
TargetSetupError

startMultiDevicesGce

public  startMultiDevicesGce ( buildInfos)

Cette méthode est obsolète.
Supprimez-le après la mise à jour de la branche principale.

Paramètres
buildInfos

Retour

Lance
TargetSetupError

startMultiDevicesGce

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

Essayez de démarrer une instance gce multi-appareils avec Oxygen.

Paramètres
buildInfos : ERROR(/List ) ERROR(/List )

attributes MultiMap : attributs associés à l'invocation en cours

Retour
une ERROR(/List ) ERROR(/List ) décrivant le GCE Avd Info.

Lance
TargetSetupError

Méthodes protégées

buildGceCmd

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

Compilez et renvoyez la commande pour lancer GCE. Exposé pour essai.

Paramètres
reportFile File

b IBuildInfo

ipDevice String

user String

offset Integer

attributes MultiMap

Retour

buildShutdownCommandbuildShutdownCommand

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

Retour

extractInstanceName

protected String extractInstanceName (String bootupLogs)

Récupérez le nom de l'instance à partir des 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 gce, le nom de l'instance tentée ne s'affichera pas dans json.

Paramètres
bootupLogs String

Retour
String