Jenkins
Ajoutez l'analyse à votre pipeline
Ajoutez le collector AppArch comme étape de votre pipeline Jenkins. Les constats arrivent dans le panneau, et vous pouvez éventuellement faire échouer le build en cas de violation de règle.
Authentification : Identifiant de pipeline
Écrans d'une installation en fonctionnement
Comment ça se connecte
- 01
Ajouter l'étape
Ajoutez le collector comme étape dans votre pipeline.
- 02
Fournir un token
Un identifiant pour que les résultats atteignent le panneau.
- 03
Se connecter au hub
Un identifiant nom d'utilisateur/mot de passe contenant l'id et la clé d'installation connecte l'agent à hub.apparch.io, d'où l'image est tirée. Le token du projet n'est pas un identifiant de registre.
- 04
Exécuter
L'analyse s'exécute à chaque build.
- 05
Fournir le contexte de la PR
Jenkins n'expose aucune variable de merge request du fournisseur ; pour une revue de PR, passez le fournisseur, le dépôt et le numéro de PR ($CHANGE_ID dans un pipeline multibranche) en variables d'environnement. Sans elles, l'étape lance une analyse complète.
Ce que vous obtenez
Étape de pipeline
Une seule commande lance l'analyse.
Échec en cas de violation de règle
Si le seuil est dépassé, le build passe au rouge.
N'importe quel agent / OS
L'image Docker s'exécute sur n'importe quel agent Jenkins.
Résultats dans le panneau
Le score et les constats se regroupent dans le panneau central.
Aucun plugin à installer
L'étape est un simple docker run avec la même image que tous les autres CI ; une mise à jour de Jenkins ne la casse jamais et le Jenkinsfile reste lisible.
Code de sortie 4 = violation de règle
Au-delà du seuil, le conteneur se termine avec le code 4 et Jenkins marque l'étape en échec ; une erreur réseau se termine autrement, une panne n'est donc jamais prise pour du mauvais code.
Comment cela fonctionne dans AppArch
Il n'y a pas de plugin : l'analyseur est un conteneur que votre agent Jenkins exécute. AppArch n'appelle jamais Jenkins.
Ce qu'il lit
- Rien : AppArch n'appelle jamais Jenkins
Ce que fait le job
- Lance l'image collector du langage avec docker run et envoie les constats avec le jeton du projet
- Pour une revue de MR, vous passez le contexte via les variables APPARCH_Collector__Provider__*
- Se termine avec le code 4 quand un constat atteint le seuil fail-on, après l'envoi des résultats
Ce qu'il ne fait jamais
- Pas de plugin, pas de déclenchement de build ni de statut renvoyé
Deux paires de valeurs : l'ID et la clé d'installation pour tirer l'image de hub.apparch.io, et le jeton du projet (aa_proj_) pour parler à votre serveur AppArch.
Voir dans le produit
Toutes les captures
Connecter Jenkins
Connectez-vous en quelques minutes - votre première revue arrive dès la prochaine modification.