Intégrations Jenkins

Le plugin Application Automation Tools est un plugin libre pour l’outil Jenkins CI (Intégration continue). Vous pouvez utiliser cet outil pour exécuter des campagnes de test ALM et utiliser ALM Lab Management avec l’intégration continue Jenkins.

Si vous travaillez avec Quality Center 10.00 ou antérieur, et QuickTest Professional 9.x ou 10.x, utilisez le Quality Center Plugin.

Conditions préalables

Voici les conditions préalables à l’intégration d’ALM avec Jenkins.

  • Installez l’une des cinq dernières versions LTS de Jenkins : https://jenkins.io/changelog-stable/.
  • Java version 8 ou supérieure
  • Installez le plugin Application Automation Tools. Pour plus d’informations, voir https://plugins.jenkins.io/hp-application-automation-tools-plugin/.

  • Assurez-vous que le client ALM/Quality Center est installé sur la machine qui exécutera les tests. Pour vérifier si le client est installé, suivez les instructions sur : http://<votre_serveur>:8080/qcbin/TDConnectivity_index.html.

  • Pour exécuter des tests UFT One à partir d’ALM: Installez le Client ALM en mode d’enregistrement commun en accédant au lien suivant depuis votre navigateur sur la machine UFT One : http://<votre_serveur>:8080/qcbin/start_a.jsp?Common=true.

Retour en haut

Configurer la connexion à ALM

Configurer la connexion entre ALM et Jenkins.

Pour configurer la connexion à votre Serveur ALM :

  1. Allez sur la page d’accueil du Serveur Jenkins.
  2. Cliquez sur le lien Gérer Jenkins dans le volet de gauche.
  3. Dans la page Gérer Jenkins, cliquez sur Configurer le système.
  4. Dans l’onglet Configuration, faites défiler la page jusqu’à la section Application Lifecycle Management.
  5. Cliquez sur Ajouter un serveur ALM, si aucun serveur n’est actuellement configuré.
  6. Spécifiez un nom du serveur et une URL significatifs. Lorsque vous spécifiez une URL de serveur ALM, utilisez la chaîne complète : http:/myserver.mydomain/qcbin.

Retour en haut

Exécuter la campagne de test depuis ALM

Exécuter la campagne de test depuis ALM, et publier et examiner les résultats des tests dans Jenkins.

Pour Configurer une tâche pour exécuter des tests depuis ALM :

  1. Allez sur la page d’accueil du Serveur Jenkins.
  2. Cliquez sur le lien Nouvelle tâche ou sélectionnez une tâche existante.
  3. Saisir le nom de la tâche (pour une nouvelle tâche).
  4. Sélectionnez Compiler un projet de logiciel libre et cliquez sur OK.
  5. Dans la section Configuration du projet, faites défiler la page jusqu’à la section Compilation.
  6. Développez la liste déroulante Ajouter une étape de compilation et sélectionnez Exécuter des tests fonctionnels depuis ALM.
  7. Sélectionnez l’un des serveurs ALM que vous avez configurés à l’étape précédente.

  8. Entrez les informations d’identification du serveur, le projet et le domaine. Pour ALM 14, utilisez l’ID et le secret du client de la clé API comme nom d’utilisateur et mot de passe.

    Note : Si vous utilisez le planificateur ALM, il sera exécuté sous l’utilisateur de l’agent Jenkins. Par exemple, si Jenkins est exécuté en tant qu’utilisateur Système, le planificateur exécutera les tests en tant qu’utilisateur Système. Cela n’affectera pas l’exécution du test.

  9. Ajoutez les dossiers campagne de test ou les campagnes de test spécifiques que vous souhaitez inclure, en utilisant le chemin d’accès ALM. Pour ajouter un test spécifique, ajoutez le nom du test après le chemin d’accès de la campagne de test. Pour ajouter plusieurs entrées, cliquez sur la flèche vers le bas à droite du champ et saisissez chaque élément sur une ligne distincte. Voir l’exemple ci-dessous.
  10. En option, indiquez un délai d’attente en secondes après lequel la tâche échouera.
  11. Cliquez sur Avancé pour indiquer un Mode d’exécution (local, distant ou hôte planifié). Si vous spécifiez un mode d’hôte distant, indiquez un nom de l’hôte. Il doit s’agir d’une machine avec une installation valide de l’outil de test.

  12. Cliquez sur Appliquer pour enregistrer vos modifications et poursuivre avec d’autres étapes de compilation. Cliquez sur Enregistrer lorsque vous avez fini d’ajouter des étapes de compilation.

    Root\testfolder1\testset_a
Root\testfolder1\testset_b
Root\testlab_folder
Root\testlab_folder\testset_a\test-name

Pour configurer une action post-compilation qui publie les résultats du test :

Dans la section Actions post-compilation, développez la liste déroulante Ajouter une action post-compilation et sélectionnez Publier le résultat du test.

Pour exécuter la tâche :

Exécutez ou planifiez la tâche comme vous le feriez avec une tâche Jenkins standard.

Pour examiner les résultats :

  1. Dans le tableau de bord, cliquez sur la tâche.
  2. Cliquez sur le lien Console pour afficher les informations ALM.
  3. Copiez le lien ALM dans votre navigateur Internet Explorer et visualisez les résultats de la campagne de test à partir d’ALM.

Retour en haut

Exécuter des tests côté serveur en utilisant ALM Lab Management

Si Lab Management est activé dans ALM, vous pouvez exécuter des tests côté serveur à partir de campagnes de test fonctionnelles et de suites de vérification de compilation. Après avoir configuré les campagnes de test et les suites de vérification de compilation, vous pouvez configurer une étape de compilation Jenkins pour exécuter vos tests.

Pour configurer une tâche pour exécuter des tests en utilisant ALM Lab Management :

  1. Allez sur la page d’accueil du Serveur Jenkins.
  2. Cliquez sur le lien Nouvelle tâche ou sélectionnez une tâche existante.
  3. Saisir le nom de la tâche (pour une nouvelle tâche).
  4. Sélectionnez Compiler un projet de logiciel libre et cliquez sur OK.
  5. Dans la section Configuration du projet, faites défiler la page jusqu’à la section Compilation.
  6. Développez la liste déroulante Ajouter une étape de compilation et sélectionnez Exécuter des tests à l’aide d’ALM Lab Management.
  7. Sélectionnez l’un des serveurs ALM que vous avez configurés à l’étape précédente.
  8. Entrez les informations d’identification du serveur, le projet et le domaine.
  9. Si la version de votre serveur ALM est 12.60 ou supérieure, entrez le Type de client.
  10. Sélectionnez un Type d’exécution dans le menu déroulant (campagne de test fonctionnelle ou suite de vérification de compilation).
  11. Saisissez l’ID de votre entité d’exécution (soit l’ID de la campagne de test, soit l’ID de la suite de vérification de compilation).
  12. Facultatif : Saisissez une description de l’étape de compilation.
  13. Saisissez une durée (en minutes) pour la plage horaire. La durée minimale est de 30 minutes.
  14. Facultatif : Si vous avez défini une configuration de l’environnement AUT dans ALM, vous pouvez entrer l’ID ici afin d’exécuter votre plage horaire avec des paramètres AUT spécifiques. Si le CDA est configuré dans ALM et que vous souhaitez le mettre en œuvre pour cette plage horaire, cochez la case Utiliser le CDA pour la mise en service et déploiement et saisissez vos détails CDA.

Pour configurer une action post-compilation qui publie les résultats du test :

Dans la section Actions post-compilation, développez la liste déroulante Ajouter une action post-compilation et sélectionnez Publier le résultat du test.

Pour exécuter la tâche :

Exécutez ou planifiez la tâche comme vous le feriez avec une tâche Jenkins standard.

Pour examiner les résultats :

  1. Dans le tableau de bord, cliquez sur la tâche.
  2. Cliquez sur le lien Console pour afficher les informations ALM.
  3. Copiez le lien ALM dans votre navigateur Internet Explorer et visualisez les résultats de la campagne de test à partir d’ALM.

Note : Pour les environnements avec Internet Explorer 9 et ALM version 12.20 ou ultérieure : Le rapport, normalement accessible par un lien dans le journal de la console, ne sera pas disponible.

Retour en haut

Créer ou mettre à jour la configuration de l’environnement AUT à l’aide d’ALM Lab Management

Si vous avez activé Lab Management dans ALM, vous pouvez créer ou mettre à jour une configuration de l’environnement AUT pour un environnement AUT existant dans ALM.

Pour mettre en place une tâche :

  1. Allez sur la page d’accueil du Serveur Jenkins.
  2. Cliquez sur le lien Nouvelle tâche ou sélectionnez une tâche existante.
  3. Saisir le nom de la tâche (pour une nouvelle tâche).
  4. Sélectionnez Compiler un projet de logiciel libre et cliquez sur OK.
  5. Dans la section Configuration du projet, faites défiler la page jusqu’à la section Compilation.
  6. Développez le menu déroulant Ajouter une étape de compilation et sélectionnez Exécuter la préparation de l’environnement AUT à l’aide d’ALM Lab Management.
  7. Sélectionnez l’un des serveurs ALM que vous avez configuré à l’étape Configurer la connexion à votre serveur ALM.
  8. Saisissez les informations d’identification du serveur, le nom du projet et le domaine.
  9. Saisissez l’ID de l’environnement pour lequel vous souhaitez créer/mettre à jour une configuration.

  10. Sélectionnez l’une des options suivantes pour indiquer s’il faut ou non créer une nouvelle Configuration de l’environnement AUT ou mettre à jour une configuration existante.

    1. Pour Créer une nouvelle configuration nommée, saisissez un nom pour la nouvelle configuration.

    2. Pour Utiliser une configuration existante avec ID, entrez l’ID de votre Configuration de l’environnement AUT dans ALM.

  11. Facultatif : Saisissez un chemin d’accès à un fichier JSON contenant les valeurs des paramètres de l’environnement AUT pour la configuration concernée.
  12. Facultatif : Saisissez le nom d’un paramètre d’environnement de compilation afin d’enregistrer l’ID de la configuration créée/mise à jour pour une utilisation ultérieure.

  13. Ajoutez les paramètres de l’environnement AUT que vous voulez mettre à jour pour la configuration créée/mise à jour. Pour chaque paramètre :

    1. Sélectionnez le type de paramètre dans le menu déroulant (Manuel, Environnement, De JSON).
    2. Saisissez le chemin d’accès complet du paramètre tel qu’il apparaît dans ALM.
    3. Saisissez la valeur que vous souhaitez attribuer à ce paramètre.

Pour exécuter la tâche :

Exécutez ou planifiez la tâche comme vous le feriez avec une tâche Jenkins standard.

Retour en haut

Télécharger les résultats du test dans ALM

Vous pouvez télécharger des tests s’exécutant dans les structures JUnit, NUnit ou TestNG vers ALM en tant que partie intégrante de la tâche d’exécution ou en tant que tâche distincte. ALM créera des tests et des campagnes de tests (de Type externe) correspondant aux tests exécutés.

Pour mettre en place une tâche :

  1. Allez sur la page d’accueil du Serveur Jenkins.
  2. Cliquez sur le lien Nouvelle tâche ou sélectionnez une tâche existante.
  3. Saisir le nom de la tâche (pour une nouvelle tâche).
  4. Sélectionnez Compiler un projet de logiciel libre et cliquez sur OK.

Pour configurer l’action post-compilation :

  1. Dans la section Configuration du projet, faites défiler vers le bas jusqu’à la section Actions post-compilation.
  2. Développez la liste déroulante Ajouter une action post-compilation et sélectionnez Télécharger les résultats du test dans ALM.
  3. Sélectionnez l’un des serveurs ALM que vous avez configuré à l’étape Configurer la connexion à votre serveur ALM.
  4. Saisissez les informations d’identification du serveur, le nom du projet et le domaine.
  5. Sélectionnez une structure de test dans la liste déroulante : JUnit, NUnit ou TestNG.
  6. Facultatif : Entrez le nom de l’Outil de test, à utiliser dans l’entité correspondante dans ALM.
  7. Saisissez le chemin d’accès du dossier de test ALM, dans lequel vous souhaitez stocker les tests externes. N’incluez pas le dossier de test Racine (Sujet).
  8. Saisissez le chemin d’accès du dossier campagne de test ALM, dans lequel vous souhaitez stocker les campagnes de test externes. N’incluez pas le dossier campagnes de test Racine.
  9. Saisissez la condition du fichier de résultat des Tests, par rapport au chemin d’accès racine de la tâche. Par exemple, utilisez **/junitResult.xml pour les résultats du plugin Junit.
  10. Facultatif : Entrez l’URL du serveur Jenkins.

Pour exécuter la tâche :

Exécutez ou planifiez la tâche comme vous le feriez avec une tâche Jenkins standard.

Pour examiner les résultats :

  1. Dans le tableau de bord, cliquez sur la tâche.
  2. Cliquez sur le lien Console pour afficher les informations ALM.
  3. Copiez le lien ALM dans Internet Explorer et affichez les tests, les campagnes de test et les exécutions de test qui ont été créés dans ALM.

Retour en haut

Voir aussi :