BuildCaptainRésoudre les problèmes de connexion
Que faire quand BuildCaptain ne parvient pas à joindre Jenkins : exigences HTTPS, proxys et pages de connexion, tokens, permissions et plugin manquant.
Écrit par Loris Siegenthaler · Créateur de BuildCaptainQuand la connexion casse, BuildCaptain affiche un bandeau orange dans la barre latérale avec la raison, plus des boutons de réessai et de réglages. Les erreurs du serveur ouvrent un dialogue avec un résumé en langage clair — déplie "What the server sent" pour voir la réponse brute, et utilise Copy Details pour signaler un problème.
« The Jenkins URL is invalid » / HTTP refusé
BuildCaptain accepte les URL https://, ainsi que — à partir de BuildCaptain 26.8.3 — le http:// en clair uniquement pour les adresses de réseau privé — des IP comme 10.x.x.x, 172.16–31.x.x, 192.168.x.x et localhost. Cela couvre les instances Jenkins internes dont le trafic ne quitte jamais ton LAN ou ton VPN. Un nom d'hôte en HTTP clair (p. ex. http://jenkins.example.com/) est refusé par principe, car il exposerait ton token d'API en transit — dans ce cas, connecte-toi via l'IP privée du serveur ou, mieux, place Jenkins derrière un reverse proxy qui termine le TLS.
Un proxy ou une page de connexion fait obstacle
Si le serveur répond avec quelque chose qui n'est pas Jenkins — Cloudflare Access, un portail VPN, une page SSO d'entreprise — BuildCaptain signale qu'un proxy ou une page de connexion intercepte peut-être la requête et montre la réponse reçue. Assure-toi que les requêtes API vers ton hôte Jenkins contournent la connexion interactive (p. ex. des en-têtes de token de service sur le proxy, ou connecte-toi d'abord au VPN).
401 — token rejeté
Le couple utilisateur/token est incorrect ou le token a été révoqué. Crée un nouveau token d'API dans Jenkins (ton nom → Security → API Token) et ressaisis-le dans les réglages. Attention : utilise le token, pas le mot de passe de ton compte.
403 — pas de permission
Il manque à ton compte une permission pour cette action — lire demande Job/Read ; lancer/arrêter/relancer demandent Job/Build et Job/Cancel. Le message du serveur se trouve dans les détails de l'erreur.
404 sur le graphe — plugin manquant
Si les pipelines se listent bien mais que la vue des étapes signale un endpoint introuvable, le plugin Pipeline Graph View n'est pas installé sur Jenkins.
« Reconnecte-toi » après une mise à jour
Si BuildCaptain signale que le token d'API enregistré est introuvable, ouvre les réglages et ressaisis-le — le champ du token est le seul à remplir ; le serveur et le nom d'utilisateur sont mémorisés.
Toujours bloqué ?
La page Logs enregistre chaque requête avec son code de statut (les tokens et les corps de réponse ne sont jamais journalisés). Copie-le et envoie-le-nous.