Intégration continue

Le service Intégration Continue de Tuleap permet de connecter des jobs Jenkins à votre projet et de suivre l'état des builds directement depuis la plateforme. Il prend également en charge le déclenchement automatique de builds après des commits dans votre dépôt SVN.

Information

Ce service est historiquement orienté SVN. Pour une intégration Git/Jenkins complète — incluant la découverte automatique des dépôts et branches, le statut de build sur les pull requests et le reporting des résultats de tests — consultez la documentation technique Tuleap CI.

Prérequis

• Le service Intégration Continue doit être activé dans l'Administration du projet (section Services).

• Seuls les administrateurs du projet peuvent ajouter, modifier ou supprimer des jobs.

• Le serveur Jenkins doit être accessible depuis le serveur Tuleap.

Page du service

Cliquez sur le lien Intégration Continue dans la navigation du projet. La page affiche la liste des jobs enregistrés avec, pour chacun :

• une icône de statut du dernier build (succès, échec, en cours, non exécuté),

• la référence et la date du dernier build réussi,

• la référence et la date du dernier build échoué,

• un lien RSS vers le flux des builds.

Ajouter un job

1. Cliquez sur Ajouter un job.

2. Renseignez les champs :

   • URL du job (obligatoire) : URL complète du job Jenkins. Exemples :

   • Déclencher un build après un commit (optionnel) : voir Déclencher un build après un commit SVN.

   • Token (optionnel) : token de sécurité Jenkins si le déclenchement du build est protégé par authentification.

3. Cliquez sur Ajouter un job.

Information

Tuleap contacte Jenkins au moment de l'enregistrement pour récupérer automatiquement le nom du job. Le serveur Jenkins doit donc être joignable depuis Tuleap lors de l'ajout.

Modifier un job

1. Sur la ligne du job, cliquez sur Éditer.

2. Les champs disponibles sont les mêmes qu'à la création, avec en supplément :

   • Job name : nom court utilisé pour les références croisées Tuleap (ex. job #MonJob). Les espaces ne sont pas autorisés — ils sont automatiquement remplacés par _.

3. Cliquez sur Modifier.

Supprimer un job

1. Sur la ligne du job, cliquez sur Supprimer.

2. Confirmez la suppression dans la modale.

Information

La suppression dans Tuleap retire uniquement le lien entre le projet et le job. Elle ne supprime pas le job dans Jenkins.

Déclencher un build après un commit SVN

Lorsque l'option SVN est cochée sur un job, Jenkins est automatiquement notifié après chaque commit dans le dépôt SVN du projet.

• Par défaut, tout commit déclenche un build.

• Il est possible de restreindre le déclenchement à des chemins spécifiques du dépôt (un chemin par ligne dans le champ dédié).

Si un token a été configuré dans Jenkins pour protéger le déclenchement, renseignez-le dans le champ Token du formulaire.

Attention

L'option Git dans ce formulaire est obsolète depuis Tuleap 8.14. Pour déclencher des builds Jenkins depuis Git, utilisez les webhooks configurés dans l'administration du service Git du projet. Voir la documentation technique Tuleap CI.

Références croisées vers Jenkins

Tuleap génère automatiquement des références croisées vers les jobs et les builds Jenkins. Vous pouvez les utiliser dans les commentaires d'artifacts, les messages de commit ou les descriptions de pull requests.

Référencer un job :

• job #NomDuJob — job dans le projet courant

• job #nom-projet:NomDuJob — job dans un autre projet

Référencer un build :

• build #175 — build n°175 (uniquement si un seul job est configuré dans le projet)

• build #NomDuJob/175 — build n°175 du job NomDuJob

• build #nom-projet:NomDuJob/175 — build dans un autre projet