Configurer GitLab sur un serveur Linux – Héberge ta propre plateforme DevOps

Découvre comment installer efficacement GitLab sur Linux pour optimiser tes workflows DevOps et améliorer le travail d’équipe → En savoir plus

10 novembre 20267 min de lecture2 Vues0 utile

Introduction

GitLab est une plateforme DevOps complète qui permet aux équipes de collaborer sur le code, d’automatiser les workflows et de gérer efficacement l’ensemble du cycle de développement logiciel. Dans ce guide, nous t’expliquons comment installer GitLab sur un serveur Linux.

Installer GitLab avec les Applications en un clic

Tu peux installer GitLab directement via les Applications en un clic dans l’interface web de ton VPS. Après la configuration initiale des applications, ouvre le catalogue d’applications, recherche GitLab et lance le déploiement avec les paramètres de projet, d’environnement et de domaine de ton choix. Tu peux ainsi déployer et gérer GitLab rapidement et facilement, sans configuration manuelle en ligne de commande, tout en profitant de la gestion intégrée via le Web, de la prise en charge de domaines personnalisés et de la configuration SSL, lorsque disponible.

Préparation

Les exigences suivantes sont recommandées par l’équipe officielle GitLab. Il est fortement conseillé de les respecter pour éviter tout problème ou désagrément par la suite.

Matériel

Composants	Minimum	Recommandé
CPU	2x 2 GHz	4x 2,6+ GHz
RAM	4 GB	8 GB
Stockage	10 GB	50+ GB
Bande passante	100 Mbit/s (Up & Down)	100 Mbit/s (Up & Down)

Logiciels

Plateforme	Options
Système d’exploitation	Ubuntu (20.04, 22.04, 24.04), Debian (10, 11, 12), OpenSUSE (15.5)
Base de données	PostgreSQL 14.9+
Serveur web	NGINX (fourni avec GitLab), Puma 6.4.2+
Autres	Redis 7.x+, Sidekiq 7.3.2+, Prometheus 2.54.1+

Infos

Pour obtenir les spécifications les plus récentes et les plus exactes, consulte la documentation officielle GitLab Hardware Requirements.

Pour installer GitLab sur ton serveur Linux, tu dois te connecter à l’aide d’un client SSH. Consulte notre guide Premier accès (SSH) pour en savoir plus.

Une fois la connexion établie, tu peux installer les paquets nécessaires à l’installation de GitLab.

Étape 1 : Installer les dépendances

Tu dois d’abord installer quelques dépendances pour que le programme d’installation de GitLab fonctionne. Utilise les commandes suivantes pour installer les paquets nécessaires sur ton serveur Linux.

Mets à jour la liste des paquets et installe le serveur OpenSSH ainsi que les prérequis nécessaires avec la commande suivante. Cela permet d’héberger l’interface web de GitLab.

Code

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

Tu peux aussi installer Postfix (serveur SMTP) si tu souhaites envoyer des notifications par e-mail via GitLab.

Pour utiliser les notifications par e-mail, installe Postfix avec la commande suivante :

Code

sudo apt-get install -y postfix

Mets à jour la liste des paquets et installe le serveur OpenSSH ainsi que les prérequis nécessaires avec la commande suivante. Cela permet d’héberger l’interface web de GitLab.

Code

sudo apt update
sudo apt-get install -y curl openssh-server ca-certificates perl

Tu peux aussi installer Postfix (serveur SMTP) si tu souhaites envoyer des notifications par e-mail via GitLab.

Pour utiliser les notifications par e-mail, installe Postfix avec la commande suivante :

Code

sudo apt-get install -y postfix

Installe le serveur OpenSSH ainsi que les prérequis nécessaires avec la commande suivante. Cela permet d’héberger l’interface web de GitLab.

Code

sudo zypper install curl openssh perl

Assure-toi que le démon OpenSSH est activé :

Code

sudo systemctl status sshd
sudo systemctl enable sshd
sudo systemctl start sshd

Si tu utilises firewalld, assure-toi que les ports nécessaires sont ouverts.

Vérifie si firewalld est actif avec la commande suivante :

bash

sudo systemctl status firewalld

Si c’est le cas, ouvre les ports par défaut (80 et 443) :

Code

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld

Étape 2 : Installer GitLab

Une fois toutes les dépendances installées, tu peux installer GitLab.

Dans ce guide, nous installons GitLab directement depuis les dépôts officiels de paquets.

Le script suivant ajoute les dépôts GitLab au gestionnaire de paquets apt :

Code

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

Tu peux ensuite installer le paquet gitlab-ee :

bash

sudo apt-get install -y gitlab-ee

Le script suivant ajoute les dépôts GitLab au gestionnaire de paquets Zypper :

Code

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

Tu peux ensuite installer le paquet gitlab-ee :

bash

sudo zypper install gitlab-ee

Une fois cette opération terminée, GitLab devrait être prêt à fonctionner sur ton serveur Linux. Dans la section suivante, tu vas configurer les paramètres essentiels pour assurer le bon fonctionnement du serveur.

Étape 3 : Configurer GitLab

Pour que tout fonctionne correctement, tu dois apporter quelques modifications au fichier de configuration. Ouvre le fichier de configuration de GitLab avec l’éditeur de texte de ton choix. Dans cet exemple, nous utilisons l’éditeur nano, qui est préinstallé.

Code

sudo nano /etc/gitlab/gitlab.rb

Repère la ligne external_url et saisis ton domaine ou l’adresse IP de ton serveur Linux si tu ne souhaites pas utiliser de domaine pour GitLab.

Code

## GitLab URL
##! URL, unter der GitLab erreichbar sein wird.
##! Für mehr Details zur Konfiguration von external_url siehe:
##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab
##!
##! Hinweis: Während Installation/Updates wird der Wert der Umgebungsvariable
##! EXTERNAL_URL genutzt, um diesen Wert zu setzen/ersetzen.
##! Bei AWS EC2 Instanzen wird versucht, den öffentlichen Hostnamen/IP
##! von AWS abzurufen. Mehr Infos:
##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html
external_url 'http`s`://`Deine Domain / IPv4-Adresse deines Linux Servers`'

Nous te recommandons également de saisir ton adresse e-mail à la ligne letsencrypt['contact_emails']. Cela permettra à Let's Encrypt de t’informer et de te contacter au sujet des certificats SSL automatiques et gratuits.

Infos

Pour obtenir un certificat SSL gratuit de Let's Encrypt, tu as besoin d’un domaine. Tu ne peux pas demander de certificat directement pour une adresse IP.

Code

################################################################################
# Let's Encrypt Integration
################################################################################
# letsencrypt['enable'] = nil
# letsencrypt['contact_emails'] = [`Deine E-Mail hier`] # Das sollte ein Array von E-Mail-Adressen sein
# letsencrypt['group'] = 'root'
# letsencrypt['key_size'] = 2048
# letsencrypt['owner'] = 'root'
# letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www'
# Siehe https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically für mehr Infos
# letsencrypt['auto_renew'] = true
# letsencrypt['auto_renew_hour'] = 0
# letsencrypt['auto_renew_minute'] = nil # Sollte eine Zahl oder Cron-Ausdruck sein, falls angegeben.
# letsencrypt['auto_renew_day_of_month'] = "*/4"
# letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'
# letsencrypt['alt_names'] = []

Étape 4 : Accéder à l’interface web

Après l’initialisation, tu devrais pouvoir accéder au serveur depuis un navigateur web. Accède à ton site en saisissant ton domaine ou ton adresse IP :

Code

https://[deine_domain] ODER http://[deine_ip_adresse]

La page de connexion s’affiche lors du premier accès.

Pour ta première connexion, utilise l’utilisateur root.

Tu trouveras le mot de passe dans un fichier sur ton serveur Linux. Ouvre-le avec la commande suivante et repère le champ Password :

Code

sudo nano /etc/gitlab/initial_root_password

Code

# WARNUNG: Dieser Wert ist nur gültig unter folgenden Bedingungen

# 1. Wenn er manuell gesetzt wurde (entweder via `GITLAB_ROOT_PASSWORD` Umgebungsvariable oder `gitlab_rails['initial_root_password']` Einstellung in `gitlab.rb` vor der ersten Datenbankbefüllung).

# 2. Das Passwort wurde nicht manuell geändert, weder über UI noch Kommandozeile.

#

# Falls das hier angezeigte Passwort nicht funktioniert, musst du das Admin-Passwort zurücksetzen: https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: `[DEIN_PASSWORT_HIER]`

# HINWEIS: Diese Datei wird automatisch beim ersten Reconfigure-Lauf nach 24 Stunden gelöscht.

Saisis ton nom d’utilisateur et ton mot de passe sur la page de connexion pour accéder à ton tableau de bord GitLab pour la première fois. Tu devrais maintenant pouvoir accéder à ton panneau GitLab sur ton propre serveur Linux.

Nous te recommandons vivement de créer un nouvel utilisateur et/ou de modifier le mot de passe de l’utilisateur root. Pour cela, clique sur en bas à gauche, puis sur . Tu peux y gérer tous les utilisateurs de ton instance GitLab.

Facultatif : Configurer le pare-feu avec ufw

Tu peux ignorer cette étape si tu ne souhaites pas configurer de pare-feu ou si, par exemple, tu utilises déjà firewalld sur OpenSUSE. Assure-toi que les ports 80/443 et 22 sont ouverts.

Installer ufw

Si ufw est déjà installé, tu peux ignorer cette étape.

bash

sudo apt-get install -y ufw

bash

sudo zypper install ufw

Ouvrir les ports nécessaires

Code

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Activer le pare-feu

Attention

Par défaut, ufw bloque alors tous les ports, à l’exception de ceux que tu as autorisés. Vérifie que ta liste d’autorisations est correcte avant d’exécuter cette commande.

Active le pare-feu avec la commande suivante :

Code

sudo ufw enable

Conclusion

Félicitations, tu as installé GitLab avec succès ! Si tu as encore des questions ou si tu rencontres des problèmes, notre équipe d’assistance est disponible tous les jours pour t’aider.

Si tu souhaites effectuer d’autres réglages, nous te recommandons de consulter la documentation officielle de GitLab pour découvrir les prochaines étapes.

FAQ

Questions fréquentes

Tu peux installer GitLab directement depuis les Applications en un clic de l’interface web de ton VPS. Recherche GitLab dans le catalogue d’applications et lance le déploiement avec les paramètres de projet, d’environnement et de domaine de ton choix.

Le minimum requis est un CPU 2x 2 GHz, 4 GB de RAM, 10 GB de stockage et une bande passante de 100 Mbit/s (Up & Down). La configuration recommandée comprend un CPU 4x 2,6+ GHz, 8 GB de RAM et 50+ GB de stockage.

GitLab est une plateforme DevOps complète qui permet aux équipes de collaborer sur le code, d’automatiser les workflows et de gérer efficacement l’ensemble du cycle de développement logiciel.

Avis

Cet article t’a-t-il été utile ?

Ton avis nous aide à mieux définir les priorités et à améliorer les contenus.

0 de 0 Les personnes ayant donné leur avis ont trouvé cet article utile.

Aide personnalisée

Le guide ne suffit pas ?

Notre équipe d’assistance ZAP connaît ton produit : décris brièvement ta demande et nous t’aiderons personnellement.

Zappy connaît ce guide et te répond directement dans le chat.

## GitLab URL ##! URL, unter der GitLab erreichbar sein wird. ##! Für mehr Details zur Konfiguration von external_url siehe: ##! https://docs.gitlab.com/omnibus/settings/configuration.html#configuring-the-external-url-for-gitlab ##! ##! Hinweis: Während Installation/Updates wird der Wert der Umgebungsvariable ##! EXTERNAL_URL genutzt, um diesen Wert zu setzen/ersetzen. ##! Bei AWS EC2 Instanzen wird versucht, den öffentlichen Hostnamen/IP ##! von AWS abzurufen. Mehr Infos: ##! https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instancedata-data-retrieval.html external_url 'http`s`://`Deine Domain / IPv4-Adresse deines Linux Servers`'

################################################################################ # Let's Encrypt Integration ################################################################################ # letsencrypt['enable'] = nil # letsencrypt['contact_emails'] = [`Deine E-Mail hier`] # Das sollte ein Array von E-Mail-Adressen sein # letsencrypt['group'] = 'root' # letsencrypt['key_size'] = 2048 # letsencrypt['owner'] = 'root' # letsencrypt['wwwroot'] = '/var/opt/gitlab/nginx/www' # Siehe https://docs.gitlab.com/omnibus/settings/ssl/index.html#renew-the-certificates-automatically für mehr Infos # letsencrypt['auto_renew'] = true # letsencrypt['auto_renew_hour'] = 0 # letsencrypt['auto_renew_minute'] = nil # Sollte eine Zahl oder Cron-Ausdruck sein, falls angegeben. # letsencrypt['auto_renew_day_of_month'] = "*/4" # letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt' # letsencrypt['alt_names'] = []

Quels 🍪 cookies acceptes-tu ?

Configurer GitLab sur un serveur Linux – Héberge ta propre plateforme DevOps

Introduction

Installer GitLab avec les Applications en un clic

Préparation

Matériel

Logiciels

Étape 1 : Installer les dépendances

Étape 2 : Installer GitLab

Étape 3 : Configurer GitLab

Étape 4 : Accéder à l’interface web

Facultatif : Configurer le pare-feu avec ufw

Installer ufw

Ouvrir les ports nécessaires

Activer le pare-feu

Conclusion

Questions fréquentes

Logiciel

Installer GitLab avec les Applications en un clic

Étape 2 : Installer GitLab

Facultatif : Configurer le pare-feu avec ufw

Installer ufw

Ouvrir les ports nécessaires

Activer le pare-feu

Conclusion

Serveur de jeu

Serveurs et hébergement

ZAPX

Ressources

ZAP-Hosting

Étape 1 : Installer les dépendances

Étape 3 : Configurer GitLab

Étape 4 : Accéder à l’interface web