Différences

Ci-dessous, les différences entre deux révisions de la page.

--- documentation_technique:gitea [01/23/2019 19:31:45] – Ajout du chapitre personnalisation bfaverdin
+++ documentation_technique:gitea [10/23/2026 10:08:42] (Version actuelle) – typo thomas
@@ Ligne 264: / Ligne 264: @@
 ====== Procédure de mise à jour ======
+  * Set target version number (latest release on github
+<code>
+export VERSION=X.X.X
+</code>
   * Arrêter le service :
@@ Ligne 278: / Ligne 283: @@
   * Télécharger le dernier binaire en date depuis le site de gitea :
 <code>
-# cd /var/lib/gitea && wget https://dl.gitea.io/gitea/1.x.x/gitea-1.x.x-linux-amd64
+# cd /var/lib/gitea && wget https://github.com/go-gitea/gitea/releases/download/v${VERSION}/gitea-${VERSION}-linux-amd64
 </code>
   * Changer les droits :
 <code>
-# chown git: gitea-1.x.x-linux-amd64 && chmod u+x gitea-1.x.x-linux-amd64
+# chown git: gitea-${VERSION}-linux-amd64 && chmod u+x gitea-${VERSION}-linux-amd64
 </code>
@@ Ligne 289: / Ligne 294: @@
 <code>
-# cd /usr/local/bin && unlink gitea && ln -s /var/lib/gitea/gitea-1.x.x-linux-amd64 gitea
+# cd /usr/local/bin && unlink gitea && ln -s /var/lib/gitea/gitea-${VERSION}-linux-amd64 gitea
+</code>
+  * vérifier et mettre à jour la base de donnée:
+<code>
+sudo -u git gitea doctor check --config /etc/gitea/app.ini
+sudo -u git gitea migrate --config /etc/gitea/app.ini
 </code>
@@ Ligne 299: / Ligne 311: @@
 En cas de problème lors de la mise à jour, arrêter le service, restaurer la base de données et faire pointer le lien symbolique sur la version précédente du binaire.
+Ça peut aider de jeter un oeil dans les logs aussi (/var/lib/gitea/log/gitea.log) et d'utiliser la commande gitea doctor
+**Penser à supprimer les version n-2**
 ====== Personnalisation ======
@@ Ligne 315: / Ligne 331: @@
 ==== Logo & favicon ====
+: la technique permettant de changer le logo ne marche plus. Corrigé en faisant un lien symbolique ''gitea-sm.png -> logo_hadoly.png'' dans /var/lib/gitea/custom/img
 Afin de mettre le logo Hadoly dans le menu et en favicon, il suffit de remplacer le fichier ''%%/var/lib/gitea/custom/public/img/favicon.png%%''.
 Concernant le logo de la page de garde, il faut modifier l'image pointée par la class //CSS// //"logo"// du fichier ''%%home.tmpl%%'' (par défaut utilise le //favicon//).
+==== Liste des utilistateurs ====
+Par défault, la liste des utilisateurs est publique, et visible y compris aux persononnes non authentifiées. (sur https://git.hadoly.fr/explore/users)
+Ce n'est pas configurable pour le moment, cf [[https://github.com/go-gitea/gitea/issues/2908 | Issue 2908]]
+Il est possible de passer REQUIRE_SIGNIN_VIEW à true, mais cela empêche alors d'avoir des dépots publics.
+Pour masquer la liste des utilisateurs dans l'interface web, on crée le fichier ''%%/var/lib/gitea/custom/templates/explore/users.tmpl%%'' :
+<code>
+{{template "base/head" .}}
+<div class="explore users">
+	{{template "explore/navbar" .}}
+	<div class="ui container">
+		<div class="ui user list">
+                La liste des utilisateurs n'est pas disponible.
+		</div>
+	</div>
+</div>
+{{template "base/footer" .}}
+</code>
+Il faut aussi bloquer le endpoint d'API ''api/v1/users/search'' qui permet de récupérer un beau json avec la liste des utilisateurs, (Login, Nom, Prénom, email, date de création, date dernier login...)
+Pour tester: ''curl -X GET "https://git.hadoly.Fr/api/v1/users/search" -H  "accept: application/json" | jq''
+Pour bloquer  cela, il n'existe pas de bonne sollution sans impacter le fonctionnement de l'appli. Bloquer tout users/search/ empeche d'ajouter des utilisateurs à sur un dépot. Et casse peut être d'autres choses...
+Le comportement par default de l'API, si on fait une requète avec n'importe quoi sur ce endpoint est de retourner la liste complète des users. Ça rend quasiment impossible de bloquer correctement avec une regex et la logique nginx. (en tout cas je n'y suis pas arrivé).
+Sollution très imparfaite qui bloque un petit peu, et laisse la recherche fonctionner du moment qu'on fournis au moins 3 lettres ou chiffres.
+<code>
+        location ~ ^/api/v1/users/search/?$ {
+                if ($args ~* "^q?=?[a-z0-9]{0,3}$") {
+                        return 403;
+                }
+</code>