Tests avec Jenkins

Introduction

Pour automatiser les tests avec Jenkins, vous configurez deux ordinateurs : un maître Jenkins et un esclave Jenkins. Cette configuration maître-esclave permet à une seule et même installation Jenkins sur l'ordinateur maître d'accueillir plusieurs environnements esclaves pour la construction et l'exécution des tests. Le plug-in Jenkins s'installe sur l'ordinateur maître, tandis que les produits eux-mêmes s'installent sur l'ordinateur esclave, où vous créez les tests. Pour des informations détaillées sur la relation maître-esclave Jenkins, consultez la section Distributed Builds sur le site Jenkins.

Avant de commencer

• Installez IBM® Installation Manager, programme nécessaire à l'installation des produits.
• Installez les produits.
• Vérifiez que vous avez un ordinateur maître Jenkins là où Jenkins et les plug-ins Jenkins sont installés.
• Vérifiez que vous avez un ordinateur esclave Jenkins là où les produits sont installés.
• Vérifiez que vous avez un test résidant au sein d'un espace de travail Eclipse, sur l'ordinateur esclave Jenkins où les produits sont installés.
• Vous devez fermer IBM Installation Manager et les produits de test avant de démarrer l'exécution du test.

Installation du plug-in Jenkins sur l'ordinateur maître Jenkins

1. Téléchargez le plug-in Jenkins pour le produit de test approprié à partir de Continuous Testing SharePoint sur l'ordinateur sur lequel le produit de test est installé.
2. A partir du tableau de bord Jenkins, installez le plug-in Jenkins pour l'un des deux produits de test ou pour les deux.
3. Configurez la Sécurité globale pour autoriser les agents Random TCP Ports for JNLP (Java™ Network Launch Protocol).

Configuration des travaux

1. Créez un nouveau projet logiciel free-style Jenkins. Pour plus de détails, voir https://wiki.jenkins-ci.org/display/JENKINS/Building+a+software+project.
2. A partir du tableau de bord Jenkins, cliquez sur Build > Add build step, puis sur Run a nom produit test.

3. Fournissez les détails relatifs à l'exécution du test en vous aidant de la description suivante.

   

   Le tableau suivant décrit chaque champ.

   Champ	Description
   Nom	Requis. Le nom du test.
   Emplacement d'IBM Installation Manager	Requis. Chemin d'accès complet à IBM Installation Manager.
   Espace de travail	Requis. Chemin d'accès complet à l'espace de travail Eclipse.
   Projet	Requis. Chemin (incluant le nom de fichier) du projet relatif à l'espace de travail.
   Nom de la suite de tests	Requis. Chemin (nom de fichier inclus) du test à exécuter, spécifié relativement au chemin du projet.
   Fichier de variables	Optionnel. Chemin complet d'accès au fichier XML qui contient les paires de nom et valeur de variable.
   Fichier de configuration	Facultatif. Chemin complet d'accès à un fichier qui contient les paramètres pour une exécution de test ou de planning.
   Fichier de résultats	Facultatif. Nom du fichier de résultats. Par défaut, il s'agit du nom du test ou du planning, complété d'un horodatage.
   Remplacer le fichier de résultats	Optionnel. Détermine si un fichier de résultats portant le même nom sera remplacé. La valeur par défaut, false, indique que le fichier de résultats ne sera pas remplacé.
   Silencieux	Facultatif. Désactive la production de messages par le lanceur. A la fin de l'exécution ou de la tentative, il y a simplement un retour à l'interpréteur de commandes.
   Nombre d'utilisateurs virtuels	Facultatif. Rational Performance Tester uniquement. Remplace le nombre d'utilisateurs virtuels dans l'exécution. Pour un planning, la valeur par défaut correspond au nombre d'utilisateurs spécifié dans l'éditeur de planning. Pour un test, la valeur par défaut est un utilisateur.
   Arguments de la VM	Facultatif. Arguments de machine virtuelle Java à transmettre.
   Fichier de données du rapport statistique exporté	Facultatif. Chemin complet d'un répertoire dans lequel stocker les données des rapports statistiques exportés.
   Fichiers au format de rapport personnalisé	Facultatif. Liste séparée par des virgules de chemins absolus de fichiers au format de rapport personnalisé (fichiers .view) à utiliser lors de l'exportation des données de rapports statistiques avec l'option Fichier de données du rapport statistique exporté.
   Rapport statistique exporté au format html	Facultatif. Chemin complet d'un répertoire dans lequel exporter des résultats analytiques Web. Les résultats sont exportés vers le répertoire spécifié. L'analyse des résultats s'effectue sur un navigateur Web sans à avoir à utiliser le plan de travail de test.
   Commentaires de l'utilisateur	Facultatif. Ajoutez du texte entre guillemets pour l'afficher dans la ligne Commentaires de l'utilisateur du rapport.

   Si vous ne fournissez pas de valeur pour Fichier de données du rapport statistique exporté, ces journaux seront sauvegardés dans le répertoire workspace/temp de Jenkins.

4. Cliquez sur OK pour sauvegarder la configuration d'étape de construction.
5. Pour exécuter plusieurs tests sous le même travail, cliquez à nouveau sur Add build step et fournissez les détails pour le test suivant.

Configuration maître/esclave

Les configurations maître et esclave sont prises en charge par ce plug-in. Pour plus d'informations, consultez la documentation Jenkins relative aux constructions distribuées (en anglais).

Lors de la création de la configuration du travail, outre l'exécution des étapes ci-dessus, vous devez fournir le nom de noeud esclave en tant que Label Expression dans le champ Restrict where this project can be run. Il s'agit de l'endroit où les produits sont installés et où les tests peuvent être exécutés.

Exécution de tests

Une fois le projet (Job) créé, ouvrez-le et cliquez sur Build Now. Cette action démarre l'exécution du test sur l'ordinateur esclave.

Résultats et journaux de la construction

1. Une fois la construction (build) achevée, cliquez sur son numéro et ouvrez la console du projet. Recherchez Test Result (résultat du test) pour déterminer le statut de l'exécution du test.
   Remarque : Si vous avez ajouté plusieurs étapes de construction pour exécuter plusieurs tests, l'élément Test Result apparaîtra plusieurs fois.
2. Pour les journaux du produit, connectez-vous à la machine esclave et regardez dans le répertoire Jenkins slave workspace/temp.