Différences

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

--- archives:adminsys:gogs [2016/04/09 10:13]
sebian syntax
+++ 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 9: / Ligne 21: @@
 admin@hermes:~$ sudo su - gogs
 </code>
-Généralement, il faut stasher nos changements, genre le thème de la page d'accueil et la conf : git stash
+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:~$ go get -u github.com/gogits/gogs
 gogs@hermes:~$ cd $GOPATH/src/github.com/gogits/gogs
+gogs@hermes:~$ git checkout master
+gogs@hermes:~$ git pull
+gogs@hermes:~$ go get -v -u github.com/gogits/gogs
 </code>
-On fait un « backup » de la version de prod (au cas où)
+==== 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:~/go/src/githyb.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>
-On ré-applique les changements locaux, via un git stash apply et merger les conflits, genre page d'accueil et conf
-Au besoin le logo est dispo ici:
+==== Mise à jour du code ====
-  * wget -O public/img/gogs-lg.png http://www.ffdn.org/sites/default/files/logo_ffdn_0.png
-Et la home page là:
+Enfin, on rebase la branche ''ffdn_prod'' sur la version désirée :
-  * vi templates/home.tmpl
+<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$ 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>
+==== Redémarrage du service ====
+Si tout s'est bien passé, on peut redémarrer le service (en étant root) :
+<code>
+# supervisorctl status
+# 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 :)
+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>