doc-locale/fr-fr/install/package/debian.md
{{< details >}}
{{< /details >}}
[!note] Consultez les plateformes prises en charge pour obtenir la liste complète des distributions et architectures prises en charge.
https://gitlab.example.com dans les commandes suivantes par votre URL GitLab préférée. GitLab est automatiquement configuré et démarré à cette adresse.https://, GitLab demande automatiquement un certificat avec Let's Encrypt, ce qui nécessite un accès HTTP entrant et un nom d'hôte valide. Vous pouvez également utiliser votre propre certificat, ou simplement utiliser http:// (sans le s) pour une URL non chiffrée.https://packages.gitlab.com/*
- https://storage.googleapis.com/packages-ops/*Pour ouvrir les ports de pare-feu nécessaires (80, 443, 22) et pouvoir accéder à GitLab :
Activez et démarrez le démon du serveur OpenSSH :
sudo systemctl enable --now ssh
Avec ufw installé, ouvrez les ports du pare-feu :
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
Pour installer GitLab, commencez par ajouter le dépôt de packages GitLab.
Installez les packages nécessaires :
sudo apt install -y curl
Utilisez le script suivant pour ajouter le dépôt GitLab (vous pouvez coller l'URL du script dans votre navigateur pour voir ce qu'il fait avant de le diriger vers bash) :
{{< tabs >}}
{{< tab title="Enterprise Edition" >}}
curl --location "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh" | sudo bash
{{< /tab >}}
{{< tab title="Community Edition" >}}
curl --location "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh" | sudo bash
{{< /tab >}}
{{< /tabs >}}
Installez GitLab à l'aide du gestionnaire de packages de votre système.
[!note] La définition de
EXTERNAL_URLest facultative mais recommandée. Si vous ne le définissez pas lors de l'installation, vous pouvez le définir ultérieurement.
{{< tabs >}}
{{< tab title="Enterprise Edition" >}}
sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee
{{< /tab >}}
{{< tab title="Community Edition" >}}
sudo EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce
{{< /tab >}}
{{< /tabs >}}
GitLab génère un mot de passe et une adresse e-mail aléatoires pour le compte administrateur root, stockés dans /etc/gitlab/initial_root_password pendant 24 heures. Au bout de 24 heures, ce fichier est automatiquement supprimé pour des raisons de sécurité.
Une fois GitLab installé, accédez à l'URL que vous avez configurée et utilisez les identifiants suivants pour vous connecter :
root/etc/gitlab/initial_root_passwordAprès vous être connecté, modifiez votre mot de passe et votre adresse e-mail.
Vous pouvez personnaliser votre installation GitLab en définissant les variables d'environnement facultatives suivantes avant l'installation. Ces variables ne fonctionnent que lors de la première installation et n'ont aucun effet sur les exécutions ultérieures de reconfigure. Pour les installations existantes, utilisez le mot de passe de /etc/gitlab/initial_root_password ou réinitialisez le mot de passe root.
| Variable | Objectif | Obligatoire | Exemple |
|---|---|---|---|
EXTERNAL_URL | Définit l'URL externe de votre instance GitLab | Recommandé | EXTERNAL_URL="https://gitlab.example.com" |
GITLAB_ROOT_EMAIL | Adresse e-mail personnalisée pour le compte administrateur root | Facultatif | GITLAB_ROOT_EMAIL="[email protected]" |
GITLAB_ROOT_PASSWORD | Mot de passe personnalisé (8 caractères minimum) pour le compte administrateur root | Facultatif | GITLAB_ROOT_PASSWORD="strongpassword" |
Si GitLab ne parvient pas à détecter un nom d'hôte valide lors de l'installation, reconfigure ne s'exécutera pas automatiquement. Dans ce cas, transmettez les variables d'environnement nécessaires à votre première commande gitlab-ctl reconfigure.
[!warning] Bien que vous puissiez également définir le mot de passe initial dans
/etc/gitlab/gitlab.rben configurantgitlab_rails['initial_root_password'], cela n'est pas recommandé. Cela représente un risque de sécurité, car le mot de passe est en texte clair. Si vous avez configuré cela, assurez-vous de le supprimer après l'installation.
Choisissez votre édition GitLab et personnalisez-la avec les variables d'environnement ci-dessus :
{{< tabs >}}
{{< tab title="Enterprise Edition" >}}
sudo GITLAB_ROOT_EMAIL="[email protected]" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ee
{{< /tab >}}
{{< tab title="Community Edition" >}}
sudo GITLAB_ROOT_EMAIL="[email protected]" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" apt install gitlab-ce
{{< /tab >}}
{{< /tabs >}}
Visitez notre centre de préférences d'abonnement aux e-mails pour nous indiquer quand vous contacter. Nous appliquons une politique d'opt-in explicite par e-mail, afin que vous ayez un contrôle total sur ce que nous vous envoyons et à quelle fréquence.
Deux fois par mois, nous vous envoyons les actualités GitLab à ne pas manquer, notamment les nouvelles fonctionnalités, les intégrations, la documentation et les coulisses de nos équipes de développement. Pour les mises à jour de sécurité critiques liées aux bugs et aux performances du système, inscrivez-vous à notre newsletter dédiée à la sécurité.
[!note] Si vous ne vous abonnez pas à la newsletter de sécurité, vous ne recevrez pas d'alertes de sécurité.
Une fois votre installation terminée, consultez les prochaines étapes recommandées, incluant les options d'authentification et les restrictions pour les nouveaux comptes utilisateurs.