HowtoJenkins: Document Gitea link

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
+## Lien avec une forge
-contenant les dépôts que l’on souhaite tester.
+
+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
+~~~