Catégories

Intégration de Jenkins

Cette documentation est obsolète depuis la version Agilitest V1.2.3. Veuillez vous référer à :

https://www.agilitest.com/blog/test-well-yes-but-what-how-or-how-agilitests-jenkins-interface-will-simplify-your-life

Vous pouvez regarder notre tutoriel ou vous pouvez parcourir notre documentation sur l'intégration de Jenkins :

Il existe plusieurs façons de lancer les tests d'un ATS projet : tout comme avec Jenkins, plusieurs solutions sont possibles.

Nous allons présenter ici une solution très simple qui ne nécessite que quelques minutes d'installation et de configuration.

N'utilisez cette procédure que si vous avez besoin d'une installation spécifique de Jenkins : Agilitest est capable de télécharger automatiquement, d'installer une instance de Jenkins et de configurer les travaux sur l'ordinateur où il s'exécute.

Installation de Jenkins

  • Téléchargez un Jenkins pour Windows ici : https://jenkins.io/download/
  • L'installer en standard
  • Lancez-le en ligne de commande avec java (ne le lancez pas en service pour cet exemple de configuration et si nécessaire, arrêtez le service Jenkins).
  • Exemple de commande pour lancer Jenkins : java -jar -Xms768m -Xmx1024m jenkins.war
  • Connectez-vous à "http : // localhost : 8080" et suivez les instructions pour le mot de passe.
    Attention : le mot de passe initial lors du lancement manuel est modifié et imprimé dans les journaux de lancement.
  • Vous pouvez ensuite choisir d'"installer les plugins suggérés" ou d'installer les plugins de votre choix.
  • Saisissez ensuite les informations du compte administrateur et cliquez sur "Enregistrer et continuer".
  • Configurez l'instance (adresse et port) puis cliquez sur "Terminer".
  • Votre instance Jenkins est prête à être personnalisée.

Configurer un JDK (minimum 10)

À l'aide d'un navigateur, connectez-vous à votre instance Jenkins.

(dans certains cas, si vous avez un écran vide, redémarrez votre instance de ligne de commande).

  • Cliquez sur "Manage Jenkins" puis choisissez "Global Tool Configuration" : dans la section "JDK" choisissez le JDK que vous voulez utiliser (minimum 10), soit automatiquement proposé par Jenkins, soit en définissant un répertoire local contenant un JDK 10 .

Installation de plugins :

À partir de "Manage Jenkins", cliquez sur "Manage Plugins". Les plugins nécessaires pour ATS sont :

  • Plugin d'injection d'environnement
  • Plugin d'intégration GitHub
  • Plugin Maven Invoker
  • Plugin TestNG Results
  • Plugin Maven Unleash

(Note : Vous pouvez ajouter tous les plugins qui vous intéressent)

  • Dans la section "Available", filtrez avec les noms des plugins ci-dessus pour les sélectionner :

(Ces plugins seront normalement déjà installés sur la plupart des infrastructures Jenkins existantes, à l'exception peut-être de TestNG).

L'installation de ces plugins récupère toutes les dépendances nécessaires.

Définir le répertoire ATS

Prérequis : Télécharger les composants ATS (Plus d'informations sur le projet GitHub Action Test Script dans la section "installation")

Dans le menu "Manage Jenkins", cliquez sur "Configure System" puis dans la section "Global Properties" ajoutez une variable d'environnement :

Nom = ATS_HOME
Valeur =[chemin vers votre répertoire local ATS]

  • Retour à la page d'accueil de Jenkins
  • Cliquez sur"Nouvel élément".
  • Nommez votre nouvel emploi
  • Cliquez sur"Maven Project" puis sur OK.
  • Dans la section"Gestion du code source", cliquez sur le bouton radio "git" et entrez l'URL git d'un projet ATS (par exemple : https://github.com/pierrehub2b/ats_test.git ).
  • Vous pouvez également cliquer sur "aucun" pour utiliser un projet local (le chemin sera défini dans le fichier POM de votre projet).
  • Dans la section "Build Environment", ajoutez éventuellement une variable (par exemple browser.name = chrome) après avoir coché : "injecter des variables d'environnement au processus de construction"
  • Pour être utilisé par ATS, ce nom de variable doit être le même qu'une variable utilisée dans le projet ATS . (par exemple, dans l'éditeur Agilitest vous trouverez ces variables dans la partie "Paramètres d'exécution" d'un projet)
  • Sur jenkins, dans la section"Build", entrez la valeur "test" dans le champ "Goals and options" :
  • Votre travail est configuré et est prêt à être lancé en cliquant sur "Build Now" :
  • Une fois le travail terminé, vous aurez accès aux rapports habituels résultant de l'exécution des tests (détails par tests, régressions, réussis, échoués etc...).

Si vous souhaitez partager ou échanger sur un autre exemple de configuration, vous pouvez le faire via le projet github suivant: https://github.com/pierrehub2b/actiontestscript.

Vous avez encore besoin d'aide ?
Contacter le support