Différences

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

--- archives:adminsys:gogs [2016/06/18 14:41]
zorun
+++ archives:adminsys:gogs [2020/02/21 21:46] (Version actuelle)
cacatoes page obsolète (archivée)
@@ Ligne 1: / Ligne 1: @@
 ====== Gogs ======
-Gogs est le logiciel qui fait tourner https://code.ffdn.org
+<note warning>Page obsolète, code.ffdn.org a migré vers Gitlab en 2018.</note>
+Gogs est le logiciel qui fait tourner [[https://code.ffdn.org|https://code.ffdn.org]]
+===== Configuration =====
+<code>
+$ ssh hermes.aquilenet.fr
+admin@hermes:~$ sudo su - gogs
+gogs@hermes:~$ cd go/src/github.com/gogits/gogs
+</code>
+La configuration se fait dans ''custom/conf/app.ini''.  Il y a principalement les clés de configuration qui changent par rapport à la configuration par défaut (dans ''conf/app.ini'').
 ===== Mise à jour de Gogs sur hermes =====
@@ Ligne 10: / Ligne 22: @@
 </code>
-Pour mettre à jour, en n'oubliant pas de stasher/destasher nos changements (le thème de la page d'accueil) :
+Les modifications locales sont dans une branche "ffdn_prod".  Il y a le thème de la page d'accueil, et également de temps à autre des patches.
+Pour mettre à jour, ça se fait en plusieurs étapes :
+==== Mise à jour des dépendances ====
+On commence par revenir sur la branche master, et mettre à jour gogs ainsi que ses dépendances :
 <code>
 gogs@hermes:~$ cd $GOPATH/src/github.com/gogits/gogs
-gogs@hermes:~$ git stash
+gogs@hermes:~$ git checkout master
-gogs@hermes:~$ go get -u github.com/gogits/gogs
+gogs@hermes:~$ git pull
-gogs@hermes:~$ git stash pop
+gogs@hermes:~$ go get -v -u github.com/gogits/gogs
 </code>
+==== Choix d'une version ====
+Pour choisir la version cible, on regarde la dernière release sur Github https://github.com/gogits/gogs/releases, il suffit alors de noter le nom du tag.  Ou alors, si on est joueur, on peut aussi se placer sur un commit en particulier, voire même ''master''.
+==== Entretien de la configuration ====
+On regarde les nouveaux paramètres de configuration introduits, et si les valeurs par défaut ne conviennent pas, on rajoute de la configuration dans ''custom/conf/app.ini'' :
+<code>
+gogs@hermes:~$ VERSION="v10.x" # Remplacer par la version désirée
+gogs@hermes:~$ git log -p ffdn_prod..$VERSION conf/app.ini
+gogs@hermes:~$ vim custom/conf/app.ini
+</code>
+==== Mise à jour du code ====
+Enfin, on rebase la branche ''ffdn_prod'' sur la version désirée :
+<code>
+gogs@hermes:~$ git checkout ffdn_prod
+gogs@hermes:~$ git rebase $VERSION
+</code>
+==== Compilation ====
 On fait un « backup » de la version de prod (au cas où) :
@@ Ligne 31: / Ligne 74: @@
 </code>
-Et on redémarre le service
+==== Redémarrage du service ====
+Si tout s'est bien passé, on peut redémarrer le service (en étant root) :
 <code>
@@ Ligne 37: / Ligne 82: @@
 # supervisorctl restart gogs
 </code>
+Les logs sont consultables dans /home/gogs/log/gogs.log
 ===== Changements locaux =====
 Sebian nous a fait une super page d'accueil :)
@@ Ligne 44: / Ligne 92: @@
 Au besoin le logo est dispo ici:
 <code>
 cd $GOPATH/src/github.com/gogits/gogs
 wget -O public/img/gogs-lg.png http://www.ffdn.org/sites/default/files/logo_ffdn_0.png
 </code>
 Et la home page là :
 <code>
 vi templates/home.tmpl
 </code>