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. Mettre à jour les 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, il vous sera demandé de 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. Configurer les notifications par courriel de GitLab (optionnel)

Si vous voulez que GitLab envoie des notifications par email, configurez les paramètres d’email dans le fichier de configuration de GitLab situé dans /etc/gitlab/gitlab.rb. Exemple de configuration d’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. Gérer les services de 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. Activer 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 pour 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.