avivsinai/jenkins-cli

Was macht jenkins-cli?

GitHub-artige CLI für Jenkins — Kontexte, Läufe, Logs und Verwaltungsaufgaben direkt vom Terminal aus verwalten.

Verwendung

Kontexte verwalten

Füge einen neuen Jenkins-Kontext hinzu:

jenkins context add mein-kontext --url https://jenkins.example.com --user benutzername --token api-token

Wechsle zu einem anderen Kontext:

jenkins context use mein-kontext

Liste alle Kontexte auf:

jenkins context list

Läufe verwalten

Starte einen Build für einen Job:

jenkins run start mein-job

Starte einen Build mit Parametern:

jenkins run start mein-job --param KEY=VALUE --param ANDERER_SCHLÜSSEL=ANDERER_WERT

Zeige den Status eines Laufs an:

jenkins run status <lauf-id>

Logs anzeigen

Rufe das Log eines Laufs ab:

jenkins log <lauf-id>

Folge einem Log in Echtzeit:

jenkins log --follow <lauf-id>

Verwaltungsaufgaben

Liste alle installierten Plugins auf:

jenkins admin plugins

Starte Jenkins sicher neu:

jenkins admin restart

Installation

Mit Homebrew (empfohlen)

brew tap avivsinai/jenkins-cli
brew install jenkins-cli

Manuelle Installation

Lade die neueste Version von der Release-Seite herunter.

Konfiguration

Die CLI speichert Konfigurationsdateien in ~/.jenkins-cli/config.yaml. Du kannst sie direkt bearbeiten oder die CLI-Befehle verwenden.

Umgebungsvariablen

• JENKINS_URL: Standard-Jenkins-URL
• JENKINS_USER: Standard-Benutzername
• JENKINS_TOKEN: Standard-API-Token
• JENKINS_CONTEXT: Standard-Kontextname (überschreibt die URL/den Benutzer/den Token)

Beispiele

# Kontext hinzufügen und verwenden
jenkins context add prod --url https://jenkins.prod.example.com --user admin --token $JENKINS_TOKEN
jenkins context use prod

# Einen Parameter-Build starten
jenkins run start deploy --umgebung=staging --branch=main

# Build-Logs in Echtzeit verfolgen
jenkins log --follow 12345

# Alle Plugins auflisten
jenkins admin plugins

Lizenz

MIT