Installer le package Linux sur OpenSUSE et SLES - Gitlabhq

Édition : Gratuite, GitLab Premium, GitLab Ultimate
Offre : GitLab Self-Managed

[!note] Consultez les plateformes prises en charge pour obtenir la liste complète des distributions et architectures prises en charge.

Prérequis {#prerequisites}

Prérequis du système d'exploitation :
- OpenSUSE Leap 15.6
- SLES 12
- SLES 15 SP6
Consultez les conditions d'installation pour en savoir plus sur les configurations matérielles minimales requises.
Avant de commencer, assurez-vous d'avoir correctement configuré votre DNS. Remplacez https://gitlab.example.com dans les commandes suivantes par l'URL GitLab de votre choix. GitLab est automatiquement configuré et démarré à cette adresse.
Pour les URL 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.
Les packages Linux et les autres fichiers de métadonnées associés sont stockés et distribués depuis Google Cloud Storage. Si vous utilisez un pare-feu, vous devrez autoriser l'accès aux préfixes d'URL suivants : - https://packages.gitlab.com/* - https://storage.googleapis.com/packages-ops/*

Activer SSH et ouvrir les ports du pare-feu {#enable-ssh-and-open-firewall-ports}

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 :
shell
```
sudo systemctl enable --now sshd
```

Avec firewalld installé, ouvrez les ports du pare-feu :

shell

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

Ajouter le dépôt de packages GitLab {#add-the-gitlab-package-repository}

Pour installer GitLab, commencez par ajouter le dépôt de packages GitLab.

Installez les packages nécessaires :
shell
```
sudo zypper install 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 rediriger vers bash) :

{{< tabs >}}

{{< tab title="Enterprise Edition" >}}
shell
```
curl --location "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.rpm.sh" | sudo bash
```
{{< /tab >}}

{{< tab title="Community Edition" >}}
shell
```
curl --location "https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh" | sudo bash
```
{{< /tab >}}

{{< /tabs >}}

Installer le package {#install-the-package}

Installez GitLab à l'aide du gestionnaire de packages de votre système.

[!note] La définition de EXTERNAL_URL est facultative, mais recommandée. Si vous ne la définissez pas pendant l'installation, vous pouvez la définir ultérieurement.

shell

sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ee

shell

sudo EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ce

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 :

Nom d'utilisateur : root
Mot de passe : consultez /etc/gitlab/initial_root_password

Après vous être connecté, modifiez votre mot de passe et votre adresse e-mail.

Configuration avancée {#advanced-configuration}

Vous pouvez personnaliser votre installation GitLab en définissant les variables d'environnement facultatives suivantes avant l'installation. These variables only work during the first installation et n'ont aucun effet sur les exécutions de reconfiguration ultérieures. 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`	E-mail personnalisé 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, la reconfiguration 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.rb en définissant gitlab_rails['initial_root_password'], cela n'est pas recommandé. C'est un risque de sécurité, car le mot de passe est en clair. Si vous avez configuré cela, assurez-vous de le supprimer après l'installation.

Choisissez votre édition de GitLab et personnalisez-la avec les variables d'environnement ci-dessus :

shell

sudo GITLAB_ROOT_EMAIL="[email protected]" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ee

shell

sudo GITLAB_ROOT_EMAIL="[email protected]" GITLAB_ROOT_PASSWORD="strongpassword" EXTERNAL_URL="https://gitlab.example.com" zypper install gitlab-ce

Configurer vos préférences de communication {#set-up-your-communication-preferences}

Visitez notre centre de préférences d'abonnement aux e-mails pour nous indiquer quand communiquer avec vous. Nous disposons d'une politique d'inscription explicite par e-mail, ce qui vous donne 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 que vous devez connaître, notamment les nouvelles fonctionnalités, intégrations, documentations et 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 de sécurité dédiée.

[!note] Si vous ne vous inscrivez pas à la newsletter de sécurité, vous ne recevrez pas d'alertes de sécurité.

Prochaines étapes recommandées {#recommended-next-steps}

Une fois votre installation terminée, consultez les prochaines étapes recommandées, notamment les options d'authentification et les restrictions des nouveaux comptes utilisateurs.