GitLab - Installation d'une plateforme DevOps

GitLab est une plateforme de gestion DevOps. Elle permet de coopérer sur le développement de projet, de suivre les modifications, de les acter ou les refuser, etc…

• Référence : GitLab

L'installation de GitLab nécessite quelques prérequis au niveau des paquets :

• Comme d'habitude, on commence par mettre à jour son dépôt :

apt-get update

• On installe les paquets prérequis :

apt-get install -y curl openssh-server ca-certificates

GitLab va aussi nécessiter une URL. Il va donc falloir la déclarer dans le DNS et s'assurer que la résolution fonctionne avant de lancer l'installation.

• On installe le dépôt de paquets de GitLab :

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | bash

• On indique l'URL choisi (celui qui a été déclaré) :

EXTERNAL_URL="http://gitlab.shyrkasys.local"

• On installe le paquet :

apt-get install -y gitlab-ee

• Si tout c'est correctement passé, un message nous indique l'installation correct de GitLab :

Chef Client finished, 547/1489 resources updated in 04 minutes 00 seconds
gitlab Reconfigured!

       *.                  *.
      ***                 ***
     *****               *****
    .******             *******
    ********            ********
   ,,,,,,,,,***********,,,,,,,,,
  ,,,,,,,,,,,*********,,,,,,,,,,,
  .,,,,,,,,,,,*******,,,,,,,,,,,,
      ,,,,,,,,,*****,,,,,,,,,.
         ,,,,,,,****,,,,,,
            .,,,***,,,,
                ,*,.
  


     _______ __  __          __
    / ____(_) /_/ /   ____ _/ /_
   / / __/ / __/ /   / __ `/ __ \
  / /_/ / / /_/ /___/ /_/ / /_/ /
  \____/_/\__/_____/\__,_/_.___/
  

Thank you for installing GitLab!
GitLab should be available at http://gitlab.shyrkasys.local

For a comprehensive list of configuration options please see the Omnibus GitLab readme
https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md

• GitLab est alors accessible depuis l'URL choisi. Ici : http://gitlab.shyrkasys.local

• Si l'installation ne parvient pas à trouver l'URL externe, il vous suffit de modifier le fichier /etc/gitlab/gitlab.rb :

nano /etc/gitlab/gitlab.rb

• Modifiez la valeur de external_url par l'URL choisi.
• Relancer la configuration de GitLab :

gitlab-ctl reconfigure

• Lors de la première connexion, GitLab vous demande de configurer le mot de passe de l'administrateur root :

• Une fois renseigné, on peut alors se connecter sur le compte root :

• Vous avez désormais accès à la page d’accueil de l'administrateur :

• De là, vous pouvez :
  • Créer des utilisateurs.
  • Créer des projets.
  • Configurer les paramètres spécifiques du GitLab, comme les notifications, les clés de sécurrité…

• GitLab a besoin d'envoyer des mails pour la création des comptes, les notifications, etc… Pour paramétrer l'envoi de mail, on va éditer le fichier /etc/gitlab/gitlab.rb :

nano /etc/gitlab/gitlab.rb

• On recherche avec CTRL+W, la section GitLab email server settings
• On décommente la ligne gitlab_rails['smtp_enable'].
• On décommente la ligne gitlab_rails['smtp_address'] et on modifie sa valeur par l'adresse du serveur SMTP.
• On décommente la ligne gitlab_rails['smtp_port'] et on modifie sa valeur par le port utilisé par le serveur SMTP.
• On décommente la ligne gitlab_rails['smtp_user_name'] et on modifie sa valeur par l'utilisateur utilisé pour l'authentification.
• On décommente la ligne gitlab_rails['smtp_password'] et on modifie sa valeur par le mot de passe de l'utilisateur.
• On décommente la ligne gitlab_rails['smtp_domain'] et on modifie sa valeur par le nom de domaine pour l'utilisateur.
• On décommente la ligne gitlab_rails['smtp_authentication']
• On décommente la ligne gitlab_rails['smtp_enable_starttls_auto']
• On décommente la ligne gitlab_rails['smtp_tls']
• Les modifications devraient ressembler à ça :

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "mail.shyrkasys.local"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "nekan"
gitlab_rails['smtp_password'] = "P@ssw0rd"
gitlab_rails['smtp_domain'] = "shyrkasys.local"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = false

• Par défaut, l'adresse d'expéditeur sera du type gitlab@hostname.domain.local, ce qui peut être rejeté par les serveurs SMTP externes. Pour y remédier, on va aussi modifier les lignes suivantes :
  • On recherche et on décommente gitlab_rails['gitlab_email_from'].
  • On modifie sa valeur par l'adresse mail qu'on a donné à GitLab.
  • On recherche et on décommente gitlab_rails['gitlab_email_reply_to'].
  • On modifie sa valeur par l'adresse mail qu'on a donné à GitLab.
• On enregistre avec CTRL+O et on quitte avec CTRL+X
• On relance la configuration de GitLab :

gitlab-ctl reconfigure

— Nicolas THOREZ 2020/02/21 09:21