API Jenkins : ce qu'elle permet et comment l'utiliser avec des agents IA
Jenkins dispose d'une API distante qui expose jobs, builds, file d'attente et nœuds en JSON ou XML, et permet de lancer des builds avec paramètres. Il sert aux équipes d'ingénierie et DevOps qui ont leurs propres serveurs CI/CD. L'accès se fait par un utilisateur doté d'un jeton d'API, sur l'URL du serveur de l'entreprise.
Ce que propose l’API Jenkins
Jobs
Liste, configuration et état de chaque job et pipeline.
Builds
Historique, résultat, durée et artefacts.
Lancement de builds
Exécution de jobs, avec ou sans paramètres.
Logs de console
Sortie de chaque build pour le diagnostic.
File d'attente
Builds en attente d'exécution.
Nœuds et agents
Machines d'exécution et leur disponibilité.
Comment accéder à l’API Jenkins
- Avec les identifiants de votre entrepriseUtilisateur Jenkins avec un jeton d'API généré dans son profil, transmis en authentification basique. Les permissions suivent la stratégie d'autorisation configurée sur le serveur.
- Les logs peuvent contenir des secrets : l'agent ne doit pas les relayer.
- N'exposez pas Jenkins à Internet pour la seule intégration ; utilisez un tunnel ou un réseau privé.
- Utilisez des permissions par job plutôt qu'un compte administrateur.
Documentation officielle: www.jenkins.io/doc/book/using/remote-access-api
Ce qu’un agent iTeam fait avec l’API Jenkins
Build cassé, expliqué
L'agent lit le log du build en échec, indique l'étape et le message d'erreur, et prévient l'auteur de la modification.
Test instable
L'agent repère les tests qui alternent entre succès et échec sur les dernières exécutions et les liste pour l'équipe.
Déploiement sur demande
Le responsable technique demande sur Teams le déploiement en préproduction, et l'agent lance le job avec les paramètres après confirmation.
File d'attente bloquée
L'agent prévient quand la file s'allonge et que des nœuds passent hors ligne.
De l’identifiant à l’agent au travail, avec validation
Créez un utilisateur de service
Dans Jenkins, créez l'utilisateur avec droits de lecture et de build sur les seuls jobs nécessaires, puis générez le jeton.
Enregistrez-le dans le coffre iTeam
Le jeton et l'URL restent dans le coffre, avec un accès réseau approuvé par l'IT.
Testez avec validation
La lecture des logs s'exécute directement ; le lancement de builds de production passe par une validation humaine.
Équipes IA prêtes à l’emploi pour ce travail
Analyse de données
Posez une question métier dans Slack ou Teams : l'équipe écrit la requête, vérifie le résultat et vous répond avec le chiffre et sa source.
Support informatique interne
Mot de passe, accès, matériel : la demande est posée dans Slack ou Teams, l'agent répond ou ouvre un ticket Jira complet.
Questions sur l’API Jenkins
L'API Jenkins est-elle gratuite ?
Oui, Jenkins est un logiciel libre et l'API distante est fournie avec ; le coût est celui de l'infrastructure.
Faut-il programmer pour utiliser l'API Jenkins avec iTeam ?
Pas nécessairement. L'outil HTTP d'iTeam lit la documentation, et l'équipe de déploiement configure l'ensemble avec votre équipe DevOps.
Peut-on lancer des builds avec paramètres ?
Oui, l'API distante accepte des paramètres ; dans iTeam, cette action est soumise à validation.
