ContextQMD
Back to Gitlabhq

Installer le paquet Linux sur Amazon Linux 2023

doc-locale/fr-fr/install/package/amazonlinux_2023.md

19.3.07.7 KB
Original Source

{{< details >}}

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

{{< /details >}}

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

Prérequis {#prerequisites}

  • Exigences du système d'exploitation :
    • Amazon Linux 2023
  • 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 paquets Linux et autres fichiers de métadonnées associés sont stockés et servis 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 du pare-feu nécessaires (80, 443, 22) et pouvoir accéder à GitLab :

  1. Activez et démarrez le démon du serveur OpenSSH :

    shell
    sudo systemctl enable --now sshd

  2. 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 paquets GitLab {#add-the-gitlab-package-repository}

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

  1. Installez les paquets nécessaires :

    shell
    sudo dnf install -y curl

  2. 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 transmettre à bash via un pipe) :

    {{< 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 paquet {#install-the-package}

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

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

{{< tabs >}}

{{< tab title="Enterprise Edition" >}}

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

{{< /tab >}}

{{< tab title="Community Edition" >}}

shell
sudo EXTERNAL_URL="https://gitlab.example.com" dnf 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. Après 24 heures, ce fichier est automatiquement supprimé pour des raisons de sécurité.

Première connexion {#initial-sign-in}

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 : voir /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. Ces variables ne fonctionnent que lors de la première 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.

VariableObjectifObligatoireExemple
EXTERNAL_URLDéfinit l'URL externe de votre instance GitLabRecommandéEXTERNAL_URL="https://gitlab.example.com"
GITLAB_ROOT_EMAILE-mail personnalisé pour le compte administrateur rootFacultatifGITLAB_ROOT_EMAIL="[email protected]"
GITLAB_ROOT_PASSWORDMot de passe personnalisé (8 caractères minimum) pour le compte administrateur rootFacultatifGITLAB_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 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" >}}

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

{{< /tab >}}

{{< tab title="Community Edition" >}}

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

{{< /tab >}}

{{< /tabs >}}

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 vous contacter. Nous appliquons une politique d'opt-in explicite aux e-mails, ce qui vous donne un contrôle total sur le contenu et la fréquence des e-mails que nous vous envoyons.

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 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.