▶️ Vous trouverez un tutoriel sur comment utiliser Jenkins avec Agilitest sur notre chaîne Youtube.

‍

Agilitest vous permet d'installer et de configurer automatiquement un serveur Jenkins local, ou même de vous connecter à un Jenkins distant. C'est simple, rapide et extrêmement pratique.

Vous pouvez programmer des exécutions récurrentes pour vous assurer que toutes les fonctions testées sont correctes ou non.

‍

Exemple :

Vous pouvez programmer des Jobs à exécuter tous les matins à 6 heures, ou tous les jeudis, ou même en continu sur une période définie si vous le souhaitez, etc...

‍

Ces jobs, qui lanceront automatiquement vos tests sur vos solutions Web, Desktop, API ou Mobile (terminaux émulés ou physiques), s'afficheront sur un écran très graphique. C'est ainsi que vous gagnez en confiance sur la qualité de vos solutions au quotidien.

‍

Jenkins avec Agilitest

Agilitest peut communiquer avec Jenkins afin de créer de nouveaux Jobs.

Jenkins est le composant qui permet de planifier les exécutions tout en donnant accès aux rapports de campagne et au suivi des taux de réussite et d'échec d'un Job donné. Ceci, même si ATS est compatible avec TestNg et peut être déployé sur n'importe quel système CI/CD.

‍

Agilitest propose un panel réduit des options de base offertes par Jenkins. Lorsque vous souhaitez automatiser l'exécution de vos tests, vous pouvez utiliser Jenkins directement depuis Agilitest.

‍

Ouvrir Jenkins avec Agilitest

1. Jenkins intégré

Pour ouvrir Jenkins dans Agilitest, cliquez sur l'onglet "Gestion des exécutions"

Ensuite, cliquez sur le bouton "Intégration Jenkins" pour accéder à l'interface Jenkins dans Agilitest.

‍

Si Jenkins n'est pas installé :

Cliquez sur l'icône Jenkins ou connectez Jenkins à partir du menu des outils

Dans les outils, cliquez sur "serveur embarqué" dans le menu Jenkins,

Entrez un port disponible sur votre ordinateur, et cliquez sur le bouton "Télécharger" 

Une fois Jenkins installé, cliquez sur "Connecter" pour connecter Jenkins à Agilitest.

‍

La connexion d'un serveur embarqué ouvrira Jenkins sur votre ordinateur, cette opération peut prendre quelques secondes.

Cela ouvrira une page web composée des projets ouverts par Agilitest.

‍

Cliquez sur  "Arrêter Jenkins" pour fermer Jenkins et arrêter son processus

Si vous vous déconnectez simplement, le processus Jenkins ne s'arrêtera pas.

‍

Le serveur embarqué est utile pour créer des Jobs et les exécuter à la volée. Cependant, il est moins sécurisé qu'un serveur distant, car il ne nécessite pas de mot de passe pour se connecter.

‍

           2. Jenkins à distance

Connectez Agilitest à Jenkins avec le serveur distant pour exécuter vos tests en production.

En mode distant, il n'y a pas de téléchargement mais vous devez avoir un Login et un Token.

‍

Pour vous y connecter, cliquez sur le bouton "serveur distant"

Dans le champ "URL" entrez l'URL de votre page Jenkins ouverte.

‍

Le chemin du dossier correspond au dossier dans lequel les projets Agilitest seront stockés.

Saisissez le nom de votre choix pour le dossier

‍

Ensuite, vous devrez entrer un login et un token.

Pour les obtenir, vous pouvez les trouver dans votre page Jenkins Jenkins Tableau de bord > Utilisateurs :

Entrez le login correspondant à celui de la page Jenkins.

‍

Pour obtenir le jeton API, cliquez sur l'utilisateur dans Jenkins et ensuite sur "Configurer".

Dans le champ "Jeton API" cliquez sur "Ajouter un Token" > "Générer"

‍Copiez le Token généré (il n'est généré qu'une seule fois) et collez-le dans l'éditeur Agilitest

Enfin, cliquez sur "Connecter"

‍

Une fois connecté, le serveur distant dispose d'un peu moins d'options que le serveur intégré. Vous aurez la possibilité de vous connecter ou de vous déconnecter de Jenkins.

‍

Créer un Job

Une fois Jenkins connecté, il peut être utilisé pour exécuter des Jobs.

Pour créer un nouvel emploicliquez sur le bouton "Nouveau job"à côté de l'icône Jenkins.

‍

Saisissez le nom de votre Job, ajoutez une description et configurez les paramètres que vous souhaitez.

Vous avez plusieurs options :

• Outils

Utiliser le dépôt Git : Pour utiliser un dépôt Git lorsqu'un projet est déjà géré par Git

Maven Job: Pour faire intervenir Maven lors des exécutions

‍

• Lancement

Vous pouvez également configurer le lancement de votre Job

En cochant la case "Automatique", vous pouvez décider quand vos Jobs doivent être lancés. Choisissez un ou plusieurs jours de la semaine, définissez la fréquence et les heures de travail au format 24 heures.

Cliquez sur le bouton "Continuer" pour exécuter le test plusieurs fois.

‍

• Liste des suites

La liste des suites qui seront exécutées dans votre Job Jenkins se trouve dans l'encart "Liste des Suites".

Cliquez sur le bouton "Ajouter" et définissez les suites que vous souhaitez exécuter.

‍

• Rapports

Vous pouvez choisir de générer les rapports Agilitest à la fin de vos exécutions.

Vous pouvez également choisir d'envoyer un courriel afin de suivre le déroulement de vos Jobs

‍

Paramétrer un Job

Une fois le Job créé, vous pouvez le paramétrer à nouveau en cliquant sur l'icône "stylo" dans l'interface Jenkins d'Agilitest.

Sélectionnez un Job et cliquez sur "Exécuter".

‍

A la fin de l'exécution, Jenkins validera ou non le test.

Vous pouvez exécuter à nouveau votre test directement à partir de la page Web, ou à partir de votre éditeur Agilitest, comme décrit ci-dessus.

‍

Vous pouvez également configurer votre Job directement dans Jenkins à partir de l'onglet "Configurer", où vous aurez accès à tous les paramètres.

Après une première exécution, le Job affiche un symbole météorologique représentant le statut du Job.

Ce symbole météorologique sera également représenté dans Agilitest.

‍

Sous l'icône Jenkins se trouvent des boutons d'accès pour :

• Ouvrir la configuration Jenkins
• Ouvrir la page du projet
• Ouvrir la fenêtre des outils Agilitest
• Synchronisez vos informations à partir de Jenkins

‍

Configuration avancée

Si les besoins d'exécution des tests sont massifs, le serveur Jenkins n'exécutera aucun test et les déléguera aux serveurs d'exécution via la communication Jenkins contrôleur(built-in)/agent.

Jenkins permet l'utilisation de divers protocoles de communication tels que Java Web Start (JNLP) et SSH.

‍

Une liste de tous les agents connectés ou déclarés se trouve dans la configuration du serveur Jenkins.

Vous pouvez également les trouver dans la page Jenkins Tableau de bord > Nœuds

‍

Il est important de noter qu'un contrôleur peut également être un agent.

Lorsqu'un agent est sélectionné, les erreurs qui peuvent être corrigées apparaissent dans l'encart "Avertissements et informations".

‍

Vos tests ont besoin d'un agent pour être exécutés, et cet agent doit avoir un Label déclaré. Pour que l'exécution du test ATS fonctionne, vous avez besoin du label ats-executor.

‍

Si votre agent n'a pas de label :

Cliquez sur le bouton "Corriger".

Une fois redirigé vers la page Jenkins, cliquez sur l'agent concerné dans Tableau de bord > Nœuds

Cliquez ensuite sur "Configurer" et entrez "ats.executor" dans le champ Labels

‍

Il est également possible de créer un nouvel agent.

Pour ce faire, cliquez sur "Nouvel agent"

Saisissez un nom et un nouvel emplacement du dossier

Cliquez ensuite sur "Télécharger l'agent" puis vous devez extraire les fichiers

Cliquez sur "launcher.bat" pour vous connecter.

‍

🔸 Attention

Pour qu'un launcher puisse être exécuté, Java doit être déclaré dans votre système Windows.

‍

Vous avez également la possibilité d'activer ou de désactiver un agent.

Lorsque les tests sont lancés, ils sont exécutés sur les agents disponibles. Si vous ne souhaitez pas qu'un agent soit utilisé, vous pouvez le désactiver.

‍