Back to Gitlabhq

Installer le package Linux sur Amazon Linux 2

doc-locale/fr-fr/install/package/amazonlinux_2.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}

  • Prérequis du système d'exploitation :
    • Amazon Linux 2
  • 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 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 packages GitLab {#add-the-gitlab-package-repository}

Pour installer GitLab, ajoutez d'abord le dépôt de packages GitLab.

  1. Installez les packages nécessaires :

    shell
    sudo yum 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 passer à 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 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 le définissez pas lors de l'installation, vous pouvez le définir ultérieurement.

{{< tabs >}}

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

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

{{< /tab >}}

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

shell
sudo EXTERNAL_URL="https://gitlab.example.com" yum 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_EMAILAdresse e-mail personnalisée 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é. Cela représente un risque de sécurité, car le mot de passe est en texte clair. Si vous avez configuré cela, veillez à 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" yum 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" yum 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 pour les 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 système, inscrivez-vous à notre newsletter de sécurité dédiée.

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

Après avoir terminé votre installation, consultez les prochaines étapes recommandées, notamment les options d'authentification et les restrictions sur les nouveaux comptes utilisateurs.