Jenkins
Fügen Sie Analyse zu Ihrer Pipeline hinzu
Fügen Sie den AppArch-Collector als Stage in Ihre Jenkins-Pipeline ein. Befunde fließen in das Panel, und Sie können den Build bei einem Richtlinienverstoß optional fehlschlagen lassen.
Authentifizierung: Pipeline-Anmeldedaten
Bildschirme aus einer laufenden Installation
So funktioniert die Verbindung
- 01
Stage hinzufügen
Fügen Sie den Collector als Stage in Ihre Pipeline ein.
- 02
Token bereitstellen
Eine Anmeldedaten, damit die Ergebnisse das Panel erreichen.
- 03
Beim Hub anmelden
Ein Benutzername-Passwort-Credential mit Installations-ID und Schlüssel meldet den Agenten bei hub.apparch.io an, von wo das Image gezogen wird. Das Projekt-Token ist kein Registry-Credential.
- 04
Ausführen
Die Analyse läuft bei jedem Build.
- 05
PR-Kontext übergeben
Jenkins stellt keine Merge-Request-Variablen des Providers bereit; für ein PR-Review übergeben Sie Provider, Repository und PR-Nummer ($CHANGE_ID in einer Multibranch-Pipeline) als Umgebungsvariablen. Ohne sie führt die Stage einen vollständigen Scan aus.
Was Sie erhalten
Pipeline-Stage
Ein einzelner Befehl führt die Analyse aus.
Bei Richtlinienverstoß abbrechen
Wird der Schwellenwert überschritten, schlägt der Build fehl.
Jeder Agent / OS
Das Docker-Image läuft auf jedem Jenkins-Agenten.
Ergebnisse im Panel
Bewertung und Befunde sammeln sich im zentralen Panel.
Kein Plugin nötig
Die Stage ist ein gewöhnliches docker run mit demselben Image wie in jedem anderen CI; ein Jenkins-Upgrade bricht sie nie, und das Jenkinsfile bleibt lesbar.
Exit-Code 4 heißt Richtlinienverstoß
Wird der Schwellenwert überschritten, endet der Container mit Code 4 und Jenkins markiert die Stage als fehlgeschlagen; ein Netzwerkfehler endet anders, ein Ausfall wird also nie für schlechten Code gehalten.
Wie es in AppArch funktioniert
Es gibt kein Plugin: Der Analyzer ist ein Container, den Ihr Jenkins-Agent ausführt. AppArch ruft Jenkins nie auf.
Was es liest
- Nichts: AppArch ruft Jenkins nie auf
Was der Job tut
- Startet das Collector-Image der Sprache per docker run und sendet die Befunde mit dem Projekt-Token
- Für ein MR-Review übergeben Sie den Kontext in APPARCH_Collector__Provider__*-Variablen
- Beendet sich mit Code 4, wenn ein Befund die Fail-on-Schwelle erreicht, nachdem die Ergebnisse gesendet wurden
Was es nie tut
- Kein Plugin, keine Build-Trigger und kein zurückgeschriebener Build-Status
Zwei Wertepaare: Installations-ID und -Schlüssel, um das Image von hub.apparch.io zu ziehen, und das Projekt-Token (aa_proj_) für Ihren AppArch-Server.
So sieht es im Produkt aus
Alle Screenshots
Jenkins verbinden
Verbinden Sie sich in Minuten - Ihr erstes Review erscheint bei der nächsten Änderung.