diff --git a/HowtoJenkins.md b/HowtoJenkins.md index 9b706194..764d5838 100644 --- a/HowtoJenkins.md +++ b/HowtoJenkins.md @@ -20,7 +20,7 @@ On recommande en : * Debian 10 avec du Java 11 et une version supérieure à 2.164.1 de Jenkins * Debian 11 avec du Java 11 et une version supérieure à 2.332.1 de Jenkins -Notons qu'il n'est pas compatible avec Java 9 et 10. +Notons qu'il n'est pas compatible avec Java 9 et 10. ## Installation @@ -135,7 +135,7 @@ Avec une requête curl : ~~~ # curl -u "admin_user:password" 'http://localhost:8080/crumbIssuer/api/xml?xpath=concat(//crumbRequestField,":",//crumb)' -~~~ +~~~ Avec une requête wget : @@ -179,9 +179,13 @@ C’est sur ces nœuds que s’exécuterons effectivement les tests. D’après le [projet amont](https://www.jenkins.io/doc/book/using/using-agents/#environment), Java est nécessaire pour faire fonctionner les agents (mais il y a moyen de s’en passer comme décrit par -[Debian](https://salsa.debian.org/qa/jenkins.debian.net/-/blob/master/INSTALL). +[Debian](https://salsa.debian.org/qa/jenkins.debian.net/-/blob/master/INSTALL)). -Docker est pratique aussi pour certaines constructions. +Docker est pratique aussi pour certaines constructions. Cela nécessite +l’installation des plugins +[Docker](https://plugins.jenkins.io/docker-plugin/) et +[Docker Pipeline](https://plugins.jenkins.io/docker-workflow/) sur le +contrôleur. ~~~ # apt install default-jre-headless docker.io @@ -222,5 +226,56 @@ Build Executor Status (en bas à gauche) > Save ~~~ -Maintenant que le nœud est créé, il est possible de configurer une forge -contenant les dépôts que l’on souhaite tester. +## Lien avec une forge + +Maintenant que l’agent est connecté, il est possible de configurer une +forge contenant les dépôts que l’on souhaite tester. + +Pour se connecte à Gitea (par exemple), l’installation d’un +[plugin](https://plugins.jenkins.io/gitea/) est +nécessaire. Cela peut être réalisé dans l’interface web de Jenkins. + +~~~ +Manage Jenkins +> Manage Plugins + > Available + > Search > Gitea + > Gitea Plugin (cocher la case de la colonne « Install » initiale) + > Install without restart + > Restart Jenkins when installation is complete and no jobs are running +~~~ + +Dans Gitea, il faut créer un utilisateur (par exemple « jenkins ») et +lui donner accès aux organisations et dépôts que l’on souhait tester +(par exemple en l’ajoutant aux équipes existantes, ou en créant une +nouvelle équipe, par exemple « ci »). +Une fois connecté en tant que ce nouvel utilisateur dans Gitea, il faut +créer un jeton. + +~~~ +Profiles and Settings… (tout en haut à droite) +> Settings + > Applications + > Manage Access Tokens > Generate Token (noter le jeton) +~~~ + +Dans Jenkins, l’organisation correspondante peut être créée et associée. + +~~~ +New Item +> Enter an item name (par exemple l’URL de la forge) + > Organisation Folder + > OK + > Projects + > Repository Sources + > Add + > Gitea Organization + > Credentials + > Add + > Kind + > Gitea Personnal Access Token + > Token (choisir le jeton juste défini) + > Add + > Owner (indiquer le nom d’utilisateur associé au jeton). + > Save +~~~