Présentation de GitLab
GitLab est une plateforme DevOps qui réunit en une seule application l'hébergement de dépôts Git, les merge requests, le suivi des tickets, le registre de paquets et l'intégration continue (CI/CD). L'édition Community (CE) est open source. Elle convient aux équipes de développement, aux agences et aux petites entreprises qui veulent garder leur code et leurs pipelines sur un serveur qu'elles contrôlent.
À la livraison, le VPS Linux (Debian 12 ou 13, Ubuntu 20.04, 22.04 ou 24.04) contient GitLab CE installé depuis le dépôt officiel packages.gitlab.com, via le paquet Omnibus. Un certificat TLS auto-signé, valable 10 ans, est généré pour l'adresse IP publique du serveur. L'URL externe est configurée en https://SERVER_IP, et le HTTP est redirigé vers le HTTPS.
Le compte administrateur est root. Son mot de passe initial est écrit dans /etc/gitlab/initial_root_password. La recette demande au moins 4 Go de RAM (8 Go recommandés) et 2 cœurs CPU : GitLab est gourmand, dimensionnez le VPS en conséquence.
Ce que vous pouvez faire avec GitLab
Installation Omnibus officielle
GitLab CE est installé depuis le dépôt apt de GitLab, puis configuré avec
gitlab-ctl reconfigure. Les mises à jour passent ensuite par apt.HTTPS dès la livraison
Un certificat auto-signé RSA 2048 est créé dans
/etc/gitlab/ssl/pour l'IP du serveur. Nginx redirige le HTTP vers le HTTPS.Mot de passe root généré
Le mot de passe initial du compte
rootest stocké dans/etc/gitlab/initial_root_password, sans valeur par défaut connue.Dépôts, revues et CI/CD
Merge requests, tickets, wikis, registre de paquets et pipelines CI/CD sont disponibles dans la même interface, sans outil tiers à brancher.
Configuration dans un seul fichier
Tout le réglage passe par
/etc/gitlab/gitlab.rb, suivi d'ungitlab-ctl reconfigure. C'est simple à versionner et à reproduire.
Démarrer avec GitLab
De la commande à la mise en production, en quelques minutes.
- 1
Commander le VPS avec GitLab
Choisissez un [VPS Linux](/vps-linux) à Paris ou Francfort avec au moins 4 Go de RAM (8 Go recommandés). Dans l'onglet « Applications » du formulaire de commande, cochez GitLab.
- 2
Attendre la livraison et se connecter
L'installation et la première configuration prennent plusieurs minutes après le démarrage. Suivez-les en SSH, puis récupérez le mot de passe root une fois terminé.
Bashssh root@SERVER_IP tail -f /var/log/cloud-init-output.log sudo cat /etc/gitlab/initial_root_password - 3
Ouvrir GitLab et se connecter
Allez sur https://SERVER_IP et acceptez l'avertissement du navigateur, lié au certificat auto-signé. Connectez-vous avec
rootet le mot de passe lu plus haut, puis changez-le dans votre profil.Bashsudo gitlab-ctl status - 4
Sécuriser pour la production
Pointez un nom de domaine vers le serveur, puis remplacez
external_urldans/etc/gitlab/gitlab.rbparhttps://YOUR_DOMAIN. Activez Let's Encrypt (letsencrypt['enable'] = true) ou installez votre certificat, puis appliquez la configuration. Limitez l'accès avec un pare-feu (ports 22, 80 et 443) et planifiez des sauvegardes.Bashsudo nano /etc/gitlab/gitlab.rb sudo gitlab-ctl reconfigure sudo gitlab-backup create
Cas d’usage de GitLab
Forge Git privée pour une équipe
Hébergez le code source de vos projets sur un serveur européen que vous administrez, avec des droits par groupe et par projet.
Pipelines CI/CD internes
Lancez vos tests et vos déploiements depuis des fichiers
.gitlab-ci.ymlversionnés avec le code, sur vos propres runners.Migration depuis un service hébergé
Importez vos dépôts depuis GitHub ou un autre GitLab pour reprendre la main sur vos données et vos règles d'accès.
Environnement d'apprentissage et de test
Essayez la configuration GitLab, les sauvegardes ou une montée de version sur un serveur dédié avant de toucher à la production.
Questions fréquentes sur GitLab
La recette indique 4 Go minimum et 8 Go recommandés, avec au moins 2 cœurs CPU. En dessous, l'installation peut échouer ou l'interface devenir très lente. Prévoyez 8 Go si vous utilisez la CI/CD régulièrement.
En savoir plus sur GitLab
Remplacer le certificat auto-signé
Le certificat fourni est lié à l'adresse IP : les navigateurs affichent donc un avertissement. Pour le supprimer, utilisez un nom de domaine (voir /web-domains) et modifiez /etc/gitlab/gitlab.rb :
Rubyexternal_url 'https://YOUR_DOMAIN' letsencrypt['enable'] = true letsencrypt['contact_emails'] = ['admin@YOUR_DOMAIN']
Lancez ensuite sudo gitlab-ctl reconfigure. Le domaine doit déjà pointer vers le serveur, et les ports 80 et 443 doivent être joignables pour la validation.
Ressources et mémoire
GitLab lance plusieurs services (Puma, Sidekiq, PostgreSQL, Redis, Nginx, Gitaly). Avec 4 Go de RAM, l'instance fonctionne pour une petite équipe, mais un swap et un peu de marge sont utiles. Passez à 8 Go dès que vous avez des pipelines fréquents ou plusieurs dizaines d'utilisateurs.
Sauvegardes et mises à jour
La commande sudo gitlab-backup create crée une archive des données applicatives. Sauvegardez aussi /etc/gitlab/gitlab.rb et /etc/gitlab/gitlab-secrets.json, qui ne sont pas inclus dans cette archive. Pour mettre à jour, utilisez sudo apt update && sudo apt install gitlab-ce. Lisez d'abord le chemin de mise à jour officiel, car GitLab impose parfois des versions intermédiaires.
