DeployVisualStudioTestAgent@1 - Tâche de déploiement de l’agent de test Visual Studio v1

Article
07/02/2024

Cette tâche déploie et configure l’agent de test pour exécuter des tests sur un ensemble de machines.

Important

Cette tâche est dépréciée. Utilisez la tâche de test Visual Studio pour exécuter des tests unitaires et fonctionnels.

Syntax

# Visual Studio Test Agent Deployment v1
# Deploy and configure Test Agent to run tests on a set of machines.
- task: DeployVisualStudioTestAgent@1
  inputs:
  # Test Machine Group
    testMachineGroup: # string. Required. Machines. 
    #adminUserName: # string. Admin Login. 
    #adminPassword: # string. Admin Password. 
    #winRmProtocol: # 'Http' | 'Https'. Protocol. 
    #testCertificate: true # boolean. Optional. Use when winRmProtocol = Https. Test Certificate. Default: true.
    #resourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #testMachines: # string. Filter Criteria. 
  # Agent Configuration
    machineUserName: # string. Required. Username. 
    machinePassword: # string. Required. Password. 
    #runAsProcess: false # boolean. Interactive Process. Default: false.
  # Advanced
    #agentLocation: # string. Test Agent Location. 
    #updateTestAgent: true # boolean. Update Test Agent. Default: true.
    #isDataCollectionOnly: false # boolean. Enable Data Collection Only. Default: false.

Entrées

testMachineGroup - Machines
string. Obligatoire.

Cette entrée a trois options :

Fournit une liste séparée par des virgules des adresses IP ou des noms de domaine complets de l’ordinateur, ainsi que des ports. Le port par défaut est basé sur le protocole sélectionné. Par exemple : dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986.
Fournit la variable de sortie d’autres tâches. Par exemple : $(variableName).
Fournit un nom de groupe d’ordinateurs. Si vous utilisez HTTPS, le nom/l’adresse IP de l’ordinateur doit correspondre au nom commun sur le certificat.

adminUserName - Connexion administrateur
string.

Spécifie la connexion administrateur pour les ordinateurs cibles.

adminPassword - mot de passe Administration
string.

Spécifie le mot de passe administrateur pour les machines cibles. Cette entrée peut accepter une variable définie dans les définitions de build/mise en production en tant que $(passwordVariable). Vous pouvez marquer le type de variable comme secret pour le sécuriser.

winRmProtocol - Protocole
string. Valeurs autorisées : Http, Https.

Spécifie le protocole à utiliser pour la connexion WinRM avec la ou les machines. La valeur par défaut est HTTPS.

testCertificate - Certificat de test
boolean. facultatif. Utilisez quand winRmProtocol = Https. Valeur par défaut : true.

Fournit la possibilité d’ignorer la validation d’authenticité du certificat de la machine par une autorité de certification approuvée. Le paramètre est requis pour le protocole HTTPS WinRM.

resourceFilteringMethod - Sélectionner les machines par
string. Valeurs autorisées : machineNames (Noms des ordinateurs), tags. Valeur par défaut : machineNames.

testMachines - Critères de filtre
string.

Fournit une liste d’ordinateurs tels que dbserver.fabrikam.com, dbserver_int.fabrikam.com, 192.168.12.34 ou des balises comme Role:DB;OS:Win8.1. Retourne les machines qui ont l’une des balises. Pour Groupe de ressources Azure, indiquez le nom d’hôte de la machine virtuelle pour le nom de la machine. La valeur par défaut déploie un agent sur toutes les machines représentées dans le champ Machines.

machineUserName - Nom d'utilisateur
string. Obligatoire.

Spécifie le nom d’utilisateur avec lequel l’agent de test doit s’exécuter.

machinePassword - Mot de passe
string. Obligatoire.

Spécifie le mot de passe du nom d’utilisateur indiqué ci-dessus.

runAsProcess - Processus interactif
boolean. Valeur par défaut : false.

Indique si l’agent de test doit s’exécuter en tant que processus interactif. Cette entrée est nécessaire pour les tests codés de l’interface utilisateur.

agentLocation - Emplacement de l’agent de test
string.

facultatif. Fournit le chemin d’accès à vstf_testagent.exe à partir du réseau ou de l’emplacement local. Si aucun chemin d’accès n’est fourni, il est téléchargé à partir du centre de téléchargement.

updateTestAgent - Mettre à jour l’agent de test
boolean. Valeur par défaut : true.

facultatif. Spécifie si l’agent de test doit être mis à jour.

isDataCollectionOnly - Activer la collecte de données uniquement
boolean. Valeur par défaut : false.

facultatif. Spécifie si l’agent de test est utilisé uniquement pour la collecte de données et non pour l’exécution de tests. Cela se trouve généralement sur l’application sous le groupe de machines de test (AUT).

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	1.104.0 ou version ultérieure
Catégorie de la tâche	Test

Partager via