Jenkins-Server verbinden

BuildCaptain verbindet sich direkt mit deinem Jenkins-Server — kein Zwischenhändler, kein Cloud-Account. Du brauchst drei Dinge: die Server-URL, deinen Benutzernamen und ein API-Token.

1. Jenkins-API-Token erstellen

Klicke in Jenkins auf deinen Namen (oben rechts) → Security (oder Configure bei älteren Versionen) → API Token → Add new token. Gib ihm einen Namen wie "BuildCaptain" und kopiere den generierten Wert — Jenkins zeigt ihn nur ein einziges Mal an.

Verwende ein API-Token, nicht dein Passwort. Tokens lassen sich einzeln widerrufen und funktionieren auch mit Single-Sign-on-Setups.

Die ausführliche Fassung – Tokens auf einen Service-Benutzer beschränken, rotieren und ein durchgesickertes Token widerrufen – steht in unserem Guide Jenkins API tokens: create, scope, rotate, and revoke (auf Englisch).

2. Serverdaten eingeben

Öffne BuildCaptain → Settings und gib ein:

• Server URL — z. B. https://jenkins.example.com/. HTTPS ist Pflicht für Server, die über einen Hostnamen erreicht werden; reine HTTP-Hostnamen lehnt BuildCaptain ab, um dein Token zu schützen. Die eine Ausnahme: interne Jenkins-Instanzen unter einer privaten Netzwerkadresse — z. B. http://10.0.0.5:8080/, http://192.168.1.20/ oder http://localhost:8080/ — dürfen reines HTTP verwenden, weil dieser Verkehr nie das öffentliche Internet durchquert. Setzt BuildCaptain 26.8.3 oder neuer voraus.
• Username — dein Jenkins-Anmeldename.
• API token — das Token aus Schritt 1. Es wird im macOS Keychain gespeichert.

Speichere, und BuildCaptain prüft die Verbindung sofort.

3. Plugin prüfen

Der Stage-Graph, die Step-Logs sowie die Stop- und Rerun-Funktionen stammen aus dem Pipeline Graph View-Plugin. Fehlt es, werden Pipelines weiterhin aufgelistet und lassen sich starten, aber die Graph-Seite meldet, dass der Endpunkt nicht gefunden wurde — bitte deinen Jenkins-Admin, es zu installieren.

Berechtigungen

Dein Account braucht Job/Read, um Pipelines zu durchsuchen und zu beobachten. Für das Starten, Stoppen und erneute Ausführen von Builds sind zusätzlich Job/Build und Job/Cancel nötig. Schlägt eine Aktion mit einem Berechtigungsfehler fehl, zeigt BuildCaptain die Antwort des Servers in den Fehlerdetails an.

Probleme?

Wenn die Verbindung fehlschlägt — eine Proxy-Anmeldeseite, ein Zertifikatsproblem, ein 401 — sieh dir Verbindungsprobleme beheben an.