04.12.2024

Comment installer GitLab sur Ubuntu

GitLab est une puissante plateforme DevOps open-source qui fournit des outils de contrôle de version, d’intégration et de livraison continues (CI/CD) et de collaboration. L’installation de GitLab sur Ubuntu vous permet de gérer des projets et de collaborer avec des équipes de manière efficace. Ce guide vous guidera dans l’installation de GitLab sur un serveur Ubuntu.

1. Mise à jour des paquets système

Avant de commencer l’installation, assurez-vous que vos paquets système sont à jour :

sudo apt update && sudo apt upgrade -y

2. Installer les dépendances requises

GitLab nécessite quelques paquets supplémentaires pour fonctionner correctement. Installez-les en exécutant :

sudo apt install -y curl openssh-server ca-certificates tzdata perl

3. Ajouter le dépôt GitLab

GitLab propose un dépôt officiel qui simplifie le processus d’installation. Pour l’ajouter, téléchargez d’abord le script GitLab :

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

Ce script met en place le dépôt et vous permet d’installer GitLab directement à partir de la source officielle du paquetage.

4. Installer GitLab

Installez maintenant GitLab Community Edition (CE). Remplacez https://gitlab.example.com par l’URL souhaitée pour accéder à votre instance GitLab.

sudo EXTERNAL_URL=”https://gitlab.example.com” apt install gitlab-ce

Cette commande installe GitLab et le configure pour utiliser l’URL externe spécifiée. Si vous utilisez un serveur local, vous pouvez remplacer l’adresse IP de votre serveur.

5. Configurer GitLab

Après l’installation, configurez GitLab en utilisant la commande suivante :

sudo gitlab-ctl reconfigure

Cette commande configure GitLab avec les paramètres par défaut et génère tous les composants nécessaires, tels que les bases de données et les services.

6. Accéder à GitLab dans un navigateur web

Une fois GitLab installé et configuré, vous pouvez y accéder via l’URL que vous avez spécifiée (https://gitlab.example.com ou l’adresse IP de votre serveur).

Lorsque vous accédez à GitLab pour la première fois, vous êtes invité à définir un mot de passe administrateur. Après avoir défini le mot de passe, vous pouvez vous connecter avec :

Nom d’utilisateur : root
Mot de passe : (le mot de passe que vous venez de définir)

7. Configuration des notifications par courriel de GitLab (optionnel)

Si vous souhaitez que GitLab envoie des notifications par courriel, configurez les paramètres de courriel dans le fichier de configuration de GitLab situé dans /etc/gitlab/gitlab.rb.

Exemple de configuration de l’email :

gitlab_rails[‘smtp_enable’] = true gitlab_rails[‘smtp_address’] = “smtp.yourmailprovider.com” gitlab_rails[‘smtp_port’] = 587 gitlab_rails[‘smtp_user_name’] = “your_email@example.com” gitlab_rails[‘smtp_password’] = “your_email_password” gitlab_rails[‘smtp_domain’] = “example.com” gitlab_rails[‘smtp_authentication’] = “login” gitlab_rails[‘smtp_enable_startls_auto’] = true

Après avoir modifié le fichier de configuration, reconfigurez GitLab pour appliquer les changements :

sudo gitlab-ctl reconfigure

8. Gestion des services GitLab

GitLab fournit plusieurs commandes pour gérer ses services :

Démarrer GitLab :
sudo gitlab-ctl start
Arrêter GitLab :
sudo gitlab-ctl stop
Redémarrer GitLab :
sudo gitlab-ctl restart
Vérifier le statut de GitLab :
sudo gitlab-ctl status

9. Activation de HTTPS (optionnel)

Pour un accès sécurisé, il est recommandé d’activer HTTPS. Vous pouvez utiliser Let’s Encrypt, un fournisseur de certificat SSL gratuit, en modifiant /etc/gitlab/gitlab.rb.

Ajoutez la configuration suivante :

letsencrypt[‘enable’] = true letsencrypt[‘contact_emails’] = [‘you@example.com’] letsencrypt[‘auto_renew’] = true

Exécutez la commande de reconfiguration après avoir enregistré les modifications :

sudo gitlab-ctl reconfigure

Cette configuration permet d’activer HTTPS avec renouvellement automatique de votre certificat SSL.

10. Configuration de base de GitLab

Après l’installation, configurez GitLab pour votre organisation en mettant en place des groupes, des projets et des pipelines CI/CD si nécessaire. GitLab offre une interface web intuitive pour gérer les utilisateurs, créer des dépôts et définir les permissions.

Conclusion

L’installation de GitLab sur Ubuntu est simple et fournit une plateforme puissante pour DevOps, le contrôle de version et la gestion de projet. Avec GitLab en place, vous pouvez commencer à collaborer sur des projets, en utilisant les fonctionnalités robustes de GitLab pour la gestion du code et le CI/CD.