Connecter ton serveur Jenkins

Crée un token d'API, saisis les informations de ton serveur et comprends l'exigence HTTPS et les permissions nécessaires.

Écrit par Loris Siegenthaler · Créateur de BuildCaptain

3 min de lecture

Mis à jour le 20 août 2026

BuildCaptain se connecte directement à ton serveur Jenkins — pas d'intermédiaire, pas de compte cloud. Il te faut trois choses : l'URL du serveur, ton nom d'utilisateur et un token d'API.

1. Créer un token d'API Jenkins

Dans Jenkins, clique sur ton nom (en haut à droite) → Security (ou Configure sur les versions plus anciennes) → API Token → Add new token. Donne-lui un nom comme « BuildCaptain » et copie la valeur générée — Jenkins ne l'affiche qu'une seule fois.

Utilise un token d'API, pas ton mot de passe. Les tokens peuvent être révoqués individuellement et fonctionnent avec les configurations single sign-on.

La version longue — limiter les tokens à un utilisateur de service, les faire tourner et en révoquer un qui a fuité — se trouve dans notre guide Jenkins API tokens: create, scope, rotate, and revoke (en anglais).

2. Saisir les informations du serveur

Ouvre BuildCaptain → Settings et saisis :

Server URL — p. ex. https://jenkins.example.com/. HTTPS est obligatoire pour les serveurs joints par nom d'hôte ; BuildCaptain refuse les noms d'hôte en HTTP clair pour protéger ton token. La seule exception : les instances Jenkins internes sur une adresse de réseau privé — p. ex. http://10.0.0.5:8080/, http://192.168.1.20/ ou http://localhost:8080/ — peuvent utiliser du HTTP clair, car ce trafic ne traverse jamais l'internet public. Nécessite BuildCaptain 26.8.3 ou une version ultérieure.
Username — ton identifiant Jenkins.
API token — le token de l'étape 1. Il est stocké dans le Keychain macOS.

Enregistre, et BuildCaptain valide la connexion immédiatement.

3. Vérifier le plugin

Le graphe d'étapes, les logs des steps et les fonctions d'arrêt et de relance viennent du plugin Pipeline Graph View. S'il manque, les pipelines se listent et se lancent toujours, mais la page du graphe signalera que l'endpoint est introuvable — demande à ton admin Jenkins de l'installer.

Permissions

Ton compte a besoin de Job/Read pour parcourir et suivre les pipelines. Lancer, arrêter et relancer des builds demandent en plus Job/Build et Job/Cancel. Si une action échoue avec une erreur de permission, BuildCaptain affiche la réponse du serveur dans les détails de l'erreur.

Un souci ?

Si la connexion échoue — une page de connexion d'un proxy, un problème de certificat, un 401 — consulte Résoudre les problèmes de connexion.