Différences

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

--- admin:services:gitlab [2015/05/16 11:20] – [LDAP] simplification bertrand.bonnefoy-claudet
+++ admin:services:gitlab [2016/04/09 13:39] – gabriel.detraz
@@ Ligne 1: / Ligne 1: @@
-====== GitLab de FedeRez ======
+====== GitLab ======
-GitLab est installé sur [[admin:serveurs:baldrick|Baldrick]].  Il est utilisé pour les projets de FedeRez et ceux des associations membres.
+GitLab est installé sur [[admin:serveurs:octogon|Octogon]] et est disponible à l'adresse https://gitlab.federez.net.  Il est utilisé pour les projets de FedeRez et ceux des associations membres.
-==== Installation ====
+===== Installation =====
-=== Méthode ===
+Il a été décidé d'utiliser l'installateur omnibus.
-Il y a deux méthodes principales d'installation de GitLab : par les sources et par Omnibus.  Cette dernière méthode imposant le serveur web et le serveur de base de données à utiliser, ces l'installation par sources qui a été retenue.
+On a donc la vm octogon, 2 gigas de ram et 1 coeurs sous debian 8, puis on suit le tuto gitlab.
+==== Installation de gitlab avec omnibus sur octogon ====
+<code>
+sudo apt-get install curl openssh-server ca-certificates postfix
+</code>
+Puis on install les sources gitlab :
+<code>
+curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
+sudo apt-get install gitlab-ce
+</code>
+Enfin,
+<code>
+sudo gitlab-ctl reconfigure
+</code>
+Puis on va sur octogon.crans.org, et on setup le mdp admin gitlab, et c'est tout !
+==== Migration des données depuis baldrick ====
+Sur baldrick, on avait un gitlab avec mysql et sources. On passe de mysql à postgresql en passant par ce tuto. Les 2 gitlab sont mis à la meme version, la migration se passe bien.
+https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/mysql_to_postgresql.md
+==== Ajout de l'auth ldap ====
+On édite les lignes qui vont bien dans le fichier /etc/gitlab/gitlab.rb
+http://doc.gitlab.com/ee/integration/ldap.html#enabling-ldap-sign-in-for-existing-gitlab-users
+Notamment le serveur ldap, le mot de passe, la base de recherche.
+<code>
+...
+production:
+  ...
+  ldap:
+    enabled: true
+    servers:
+      main:
+        label: 'LDAP'
+        host: 'ldap.federez.net'
+        port: 389
+        uid: 'uid'
+        method: 'tls'
+        bind_dn: 'cn=gitlab,ou=service-users,dc=federez,dc=net'
+        password: 'secret'
+        active_directory: false
+        block_auto_created_users: false
+        base: 'ou=users,dc=federez,dc=net'
+...
+</code>
+Et on lance
+<code>
+gitlab-ctl reconfigure
+</code>
+==== Https ====
+Dans un premier temps, on utilise le serveur nginx build-in de l'omnibus. Cela dit il est désactivable si on veut le faire à la main suivant le tuto : http://doc.gitlab.com/omnibus/settings/nginx.html#using-a-non-bundled-web-server
+Enfin, on active le https. Pour cela, on suit le tuto de Zertrin pour mettre LE et le script d'automatisation.
+http://doc.gitlab.com/omnibus/settings/nginx.html#enable-https
+En gros, dans /etc/gitlab/gitlab.rb :
+<code>
+# note the 'https' below
+external_url "https://gitlab.federez.net"
+</code>
+Puis :
+<code>
+sudo mkdir -p /etc/gitlab/ssl
+sudo chmod 700 /etc/gitlab/ssl
+</code>
+Attention, ne pas faire ce que dis la doc :
+<code>
+sudo cp gitlab.example.com.key gitlab.example.com.crt /etc/gitlab/ssl/</code>
+Au lieu de bourinnement cp les certifs comme ces gorets le suggèrent, je fais des liens symboliques.
+<code>
+lrwxrwxrwx 1 root root   55 avril  9 13:22 gitlab.federez.net.crt -> /etc/letsencrypt/live/octogon.federez.net/fullchain.pem
+lrwxrwxrwx 1 root root   54 avril  5 20:02 gitlab.federez.net.key -> ../../letsencrypt/live/octogon.federez.net/privkey.pem
+</code>
+Enfin on reconfigure et c'est bon !
+==== Mettre à jour ====
+Rien de plus simple : sudo apt-get upgrade ...
+===== Bot irc ======
+Kgb-bot et kgb client sont en place. Leur configuration, simple à comprendre, se trouve dans /etc/kgb-bot et /etc/kgb-client.
+Pour /etc/kgb/kgb-bot.conf
+<code>
+# vim: filetype=yaml
+---
+soap:
+  #server_addr: 0.0.0.0
+  server_addr: 127.0.0.1
+  server_port: 5391
+  service_name: KGB
+queue_limit: 150
+log_file: "/var/log/kgb-bot.log"
+include: "/etc/kgb-bot/kgb.conf.d"
+repositories:
+  saclay:
+    password: plop
+  admin:
+    password: plop
+networks:
+  rezosup-saclay:
+    nick: DGSI-Paris-Saclay
+    ircname: DGSI-Paris-Saclay
+    username: dgsi-paris-saclay
+    password: ~
+    nickserv_password: ~
+    server: irc.ensc.rezosup.org
+    port: 6667
+  rezosup-federez:
+    nick: DGSI-FedeRez
+    ircname: DGSI-FedeRez
+    username: dgsi-federez
+    password: ~
+    nickserv_password: ~
+    server: irc.ensc.rezosup.org
+    port: 6667
+channels:
+  - name: '#saclay'
+    network: rezosup-saclay
+    repos:
+      - saclay
+  - name: '#ares'
+    network: rezosup-saclay
+    repos:
+      - saclay
+  - name: '#federez-admin'
+    network: rezosup-federez
+    repos:
+      - admin
+pid_dir: /var/run/kgb-bot
+min_protocol_ver: 1
+</code>
+Pour faire appel à kgb, il faut modifier le post-receive dans un projet gitlab (dossier repositories).
+Les scripts sont dans /var/opt/gitlab-scripts-custom et linkés par liens symboliques.
+===== Ancien setup avec les sources (obsolète !) =====
+==== Méthode ====
+Il y a deux méthodes principales d'installation de GitLab : par les sources et par Omnibus.  Cette dernière méthode imposant le serveur web et le serveur de base de données à utiliser, c'est l'installation par sources qui a été retenue.
 Le guide suivi est https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md.  Les différences sont dans les sections suivantes.
-=== Ruby ===
+==== Ruby ====
 Contrairement à ce que suggère le guide, Ruby a été installé via les dépôts (version 2.1.5 dans Jessie) :
-  apt-get install ruby
+  apt-get install ruby ruby-dev
-=== Base de données ===
+==== Base de données ====
 MySQL a été choisi plutôt que PosgreSQL.  Les instructions sont dans le guide suivant : https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/database_mysql.md.
-=== Ruby-dev ===
+==== Serveur web ====
-Ca se gate au moment d'installer gems, il est apparu que le paquet RedCloth -v '4.2.9' était manquant.
-Il nous a fallu réinstaller ruby-dev et ruby pour solutionner le problème.
-=== Serveur web ===
 On utilise Apache au lieu de Nginx.
@@ Ligne 68: / Ligne 231: @@
 </file>
-==== LDAP ====
+===== LDAP =====
 Les utilisateurs sont authentifiés avec le serveur LDAP de FedeRez.  On configure donc GitLab pour s'en servir :
@@ Ligne 96: / Ligne 259: @@
 ===== Mise à jour =====
-Il faut git puller l'archive, en ayant pris soin de lire les changelogs....
+Pour mettre à jour GitLab, lire le [[https://gitlab.com/gitlab-org/gitlab-ce/blob/master/CHANGELOG|changelog]], mettre à jour les dépôts dans ''/home/git'' et relancer les services.  Le mieux est de suivre ce tuto : http://doc.gitlab.com/ce/update/patch_versions.html
+Suivi de la taille du dossier ''/home/git'' :
+  * 2015-06-11 : 752 Mio (7.10.4 -> 7.11.4)