Différences

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

--- archives:adminsys:gogs [2016/07/31 13:09]
sebian
+++ archives:adminsys:gogs [2020/02/21 21:46] (Version actuelle)
cacatoes page obsolète (archivée)
@@ Ligne 1: / Ligne 1: @@
 ====== Gogs ======
+<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 =====
-===== Mise à jour de Gogs sur hermes =====
+<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 =====
 <code>
@@ Ligne 13: / Ligne 22: @@
 </code>
+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, en n'oubliant pas de stasher/destasher nos changements (le thème de la page d'accueil) :
+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 ====
-On fait un « backup » de la version de prod (au cas où) :
+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:~/go/src/github.com/gogits/gogs$ mv gogs gogs-$(./gogs -v | awk '{print $3}')
+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 ====
-Puis compilation de la nouvelle version :
+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ù) :
 <code>
-gogs@hermes:~/go/src/github.com/gogits/gogs$ go build
+gogs@hermes:~/go/src/github.com/gogits/gogs$ mv gogs gogs-$(./gogs -v | awk '{print $3}')
 </code>
+Puis compilation de la nouvelle version :
+<code>
+gogs@hermes:~/go/src/github.com/gogits/gogs$ go build
+</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 49: / Ligne 83: @@
 </code>
+Les logs sont consultables dans /home/gogs/log/gogs.log
 ===== Changements locaux =====