Exécuter des tests dans un pipeline Azure DevOps

Vous devez créer des tests dans IBM® DevOps Test Integrations and APIs (Test Integrations and APIs) pour l'application que vous testez. Vous devez installer le IBM DevOps Test Workbench extension dans votre organisation et configurez le IBM DevOps Test Integrations and APIs Tâche que vous souhaitez exécuter en tant que tâche dans les pipelines Azure DevOps.

Vous devez avoir accompli les tâches suivantes :

Vous avez terminé les tâches préalables. Voir Conditions préalables à l'intégration avec Azure DevOps.
Installé le IBM DevOps Test Workbench extension dans votre organisation. Voir Installation du IBM DevOps Test Workbench extension.
Installation d'un agent dans le pipeline Azure DevOps. Pour plus d'informations, reportez-vous à Agents Azure Pipeline.
Créez des cas de test sous les plans de test si vous souhaitez afficher les résultats des exécutions de tests sur le tableau de bord Plans de test.
Créez des secrets chiffrés ou des variables d'environnement pour votre jeton d'accès personnel (PAT), si vous souhaitez utiliser un PAT chiffré.

Après avoir ajouté le IBM DevOps Test Workbench extension dans votre organisation Azure DevOps, vous pouvez utiliser un pipeline existant ou créer un nouveau pipeline pour ajouter le IBM DevOps Test Integrations and APIs Tâche. Vous pouvez installer un agent ou utiliser l'agent que vous avez installé dans votre pool d'agents par défaut. Vous pouvez ajouter le Test Integrations and APIs tests en tant que tâche pour votre travail d'agent, configurez la tâche, puis exécutez la tâche dans le pipeline Azure DevOps.

Si vous avez créé des scénarios de test sous des plans de test dans un projet sur Azure DevOps, vous devez fournir les détails de l'URL Azure DevOps, du plan de test, du scénario de test et de votre PAT pendant que vous configurez la tâche de test dans un pipeline afin de pouvoir afficher les résultats du test exécuté sur votre tableau de bord Plan de test.

Ouvrez votre Organisation dans Azure DevOps et effectuez les étapes suivantes:
1. Cliquez sur le projet que vous souhaitez utiliser.
2. Initialisez le référentiel en effectuant les étapes suivantes:
  1. Cliquez Repos du volet de gauche.
  2. Cliquez Initialiser du Initialiser avec un README ou gitignore section.
    Note:
    Sélectionnez le Ajouter un README case à cocher si elle n’est pas sélectionnée.
3. Cliquez sur Pipelines du volet de gauche.
4. Cliquez sur Nouveau pipeline.
5. Cliquez sur Utilisez l'éditeur classique pour créer un pipeline sans YAML.
6. Vérifiez le projet, le référentiel et la branche pour les builds manuelles et planifiées, puis cliquez sur Continuer.
7. Cliquez sur Travail vide pour ouvrir un modèle.
Sélectionnez le pipeline et procédez comme suit:
1. Modifiez le nom du pipeline de build, si nécessaire.
2. Modifiez le nom du travail d'agent, si nécessaire.
3. Sélectionnez le Pool d'agents pour votre pipeline de build.
  Vous pouvez utiliser l'agent du pool d'agents par défaut ou utiliser l'agent que vous avez installé.
4. Sélectionnez le Spécification de l'agent pour l'agent.
Ajoutez une tâche au travail de l'agent en procédant comme suit:
1. Clique le Ajouter une tâche icône pour le travail d'agent.
  Le Ajouter des tâches Le volet s'affiche.
2. Rechercher le IBM DevOps Test Integrations and APIs Tâche qui est soutenu par le IBM DevOps Test Workbench extension.
  La tâche que vous pouvez sélectionner s'affiche.
3. Clique le IBM DevOps Test Integrations and APIs Tâche option, puis cliquez sur Ajouter pour ajouter la tâche au travail de l'agent.
  La tâche sélectionnée est ajoutée au travail de l'agent. La tâche s'affiche avec un avertissement indiquant que certains paramètres nécessitent votre attention. Vous devez configurer les paramètres mentionnés à l' Étape 4.
Note:
Vous pouvez supprimer les tâches qui ne sont pas requises dans votre travail. Cliquez avec le bouton droit sur les tâches dans la liste et cliquez sur Supprimer les tâches sélectionnées pour les supprimer.

Sélectionnez le IBM DevOps Test Integrations and APIs Tâche et configurez les paramètres en effectuant les étapes suivantes:

Sélectionnez la dernière version de la tâche.

Effectuez l'action pour la tâche en vous référant au tableau suivant:

Note:

Tous les champs obligatoires sont marqués d'un astérisque (*) dans l'interface utilisateur.

Le tableau suivant fournit les options de la tâche que vous devez configurer.
Champ	Description	Action
Afficher un nom	Le nom par défaut de la tâche. Le nom par défaut affiché est IBM DevOps Test Integrations and APIs Tâche.	Entrez un nom pour la tâche qui vous aide à identifier la tâche en modifiant le nom par défaut.
Type de configuration	Le type de test à exécuter.	Sélectionnez dans la liste. Vous pouvez sélectionner parmi les options suivantes: Simple Fichier de paramètres Note: Si vous sélectionnez le Fichier de paramètres, vous devez fournir le chemin complet du fichier de paramètres que vous avez créé.
Chemin de produit	Le chemin où Test Integrations and APIs est installé sur votre ordinateur.	Entrez le chemin complet vers l'emplacement de Test Integrations and APIs. Par exemple, le chemin peut être:C:\Program Files\IBM\DevOpsTestAPI
Parameter File	The full path to a parameter file that contains run arguments for one or more tests.	Enter the full path to the location of the parameter file that you created. For example, the path can be: D:\Projects\`my_test_parameter_file`.file
Répertoire des projets	Le chemin où se trouve le projet contenant le test sur votre ordinateur.	Entrez le chemin complet vers l'emplacement du projet contenant le test. Par exemple,D:\Projects\`my_project`.
nom du projet	Le nom du projet contenant le test.	Saisissez le nom du projet contenant le test. Par exemple, `mon_projet`.
Environnement	Environnement défini dans le test à utiliser lors de l'exécution du test.	Saisissez le nom de l'environnement défini dans l'actif de test.
Test(s) à exécuter	Le nom des tests ou des suites de tests à exécuter.	Entrez le nom des tests ou des suites de tests que vous souhaitez exécuter en utilisant un point-virgule (;) pour séparer les tests ou les suites de tests.
JunitDir	Le chemin où le rapport JUnit du test doit être enregistré sur votre ordinateur.	Entrez le chemin complet vers l'emplacement sur votre ordinateur où vous souhaitez que le rapport JUnit du test soit enregistré. Par exemple,D:`\Projects\my_project\my_test_results\`.
URL du projet Azure DevOps	L'URL du projet de test dans l'organisation sur le serveur Azure DevOps. Note: Vous devez saisir les détails de cette option si vous avez créé des cas de test sous Plans de test dans votre projet Azure et que vous souhaitez afficher les résultats des tests sur le tableau de bord des plans de test.	Saisissez l'URL du projet de test dans l'organisation sur le serveur Azure DevOps au format suivant: `https://hôte/orgname/projectName` Vous devez utiliser cette option avec les options suivantes: Azure DevOpsPAT Nom du plan de test Nom du scénario de test
Azure DevOpsPAT	Jeton d'accès personnel (PAT) du serveur Azure sur lequel est hébergé le projet de test contenant le plan de test. Vous pouvez également entrer la variable du PAT chiffré que vous créez dans Azure DevOps. Note: Le jeton doit avoir un accès en lecture et en écriture.	Entrez votre jeton d'accès personnel. Vous devez utiliser cette option avec les options suivantes: URL du projet Azure DevOps Nom du plan de test Nom du scénario de test
Nom du plan de test	Le nom du plan de test dans votre projet Azure.	Entrez le nom du plan de test. Vous devez utiliser cette option avec les options suivantes: URL du projet Azure DevOps Azure DevOpsPAT Nom du scénario de test
Nom du scénario de test	Nom du scénario de test sous le plan de test dans votre projet Azure.	Entrez le nom du scénario de test. Vous devez utiliser cette option avec les options suivantes: URL du projet Azure DevOps Azure DevOpsPAT Nom du plan de test

Élargir la Options de contrôle et configurez les paramètres souhaités pour votre tâche.
Élargir la Variables de sortie et configurez les paramètres souhaités pour votre tâche.

Effectuez l'une des actions suivantes:
- Cliquez sur Sauvegarder pour enregistrer les paramètres configurés pour la tâche.
  Note:
  La tâche n'est pas mise en file d'attente pour une exécution.
  Vous pouvez enregistrer la tâche dans un pipeline de build, puis décider d'exécuter la build ultérieurement.
- Cliquez sur Sauvegarder& file d'attente pour enregistrer les configurations et mettre l'exécution en file d'attente dans le pipeline.
  Le Exécuter le pipeline La boîte de dialogue s'affiche.
Effectuez les étapes suivantes:
1. Saisissez un commentaire pour le test dans le champ Enregistrer le commentaire champ.
2. Sélectionnez l'agent que vous avez configuré pour le test dans la liste Pool d'agents liste.
3. Sélectionnez la succursale dans le Branche/étiquette liste.
4. Ajoutez les variables et les demandes pour la tâche exécutée à partir du Options avancées volet, si nécessaire.
5. Sélectionnez le Activer les diagnostics du système cochez la case afin que le journal de test soit généré pour l'exécution du test.
6. Cliquez sur Enregistrer et exécuter.
  Le tableau de bord Azure DevOps affiche la progression de l'exécution du travail.

Vous avez exécuté les tests pour l’application que vous testez en tant que tâche dans le pipeline Azure DevOps.

Vous pouvez effectuer l’une des actions suivantes dans Azure DevOps:

Afficher la progression de l'exécution du travail sur le Résumé page du pipeline.
Consultez les résultats des tests sur le Tâche page en cliquant sur la tâche.
Important:
Bien que l'état du résultat de la tâche soit affiché comme réussite, vous devez consulter le fichier journal de l'exécution de la tâche pour vérifier les erreurs signalées. Lorsque les tests s'exécutent avec succès en tant que tâche, aucune erreur n'est signalée dans le journal. Si des erreurs sont signalées dans le journal, vous devez corriger ces erreurs, puis réexécuter la tâche.
Afficher les journaux de tâches à partir du résumé du pipeline page pour le travail que vous avez exécuté.
Affichez les résultats des tests sur le tableau de bord des plans de test si vous avez créé des cas de test sous des plans de test dans votre projet Azure.