Comment installer GitLab sur Rocky Linux 8
GitLab est un outil gratuit de gestion des dépôts git qui te permet de créer et de gérer des dépôts git. Il fournit des outils pour tout ce dont un développeur open-source a besoin.
Gitlab a tout ce qui permet à un développeur de gérer facilement son projet. Tu peux créer des problèmes, suivre tes bogues ou tes commentaires liés à ton projet, organiser les versions et avoir des fonctionnalités bien plus utiles que celles que tu trouves sur GitHub. Il s’intègre parfaitement à d’autres outils de développement comme CodeShip, qui rend les déploiements faciles et rapides.
La différence entre GitLab et GitHub est la suivante : GitHub est une application web tandis que GitLab est une application open-source. GitHub est actuellement le choix le plus populaire parmi les développeurs.
Les deux services sont populaires pour héberger des projets de toutes sortes. Cependant, GitHub est plus populaire parmi les projets open-source. Si tu fais une recherche sur Google avec « GitHub » ou « GitLab », GitLab renvoie presque quatre fois moins de résultats que GitHub. Cela ne signifie pas que GitLab n’est pas bon. GitLab est le meilleur choix pour les dépôts privés auto-hébergés.
Conditions préalables
Pour installer GitLab sur Rocky Linux 8.4, tu dois avoir :
- Un serveur exécutant Rocky Linux 8.4. Si tu n’as pas encore de serveur, tu peux créer un serveur cloud sur le Web avec l’un des nombreux fournisseurs qui proposent des VPS Rocky Linux.
- Un accès racine au serveur pour installer le logiciel.
- Un nom de domaine pleinement qualifié (FQDN) pointant de préférence vers l’adresse IP de ton serveur. Un sous-domaine fonctionnera aussi très bien.
- Configuration requise : selon Gitlab, la version actuelle de GitLab nécessite au moins 2 cœurs et 8 Go de mémoire (RAM). Tu as besoin d’au moins 15 Go d’espace libre pour le bootstrap et les dépendances sur l’espace du disque dur.
Mise à jour du système
Il est recommandé de mettre à jour ton système avant d’installer un nouveau logiciel, surtout si tu prévois d’installer GitLab. Exécute la commande suivante pour mettre à jour ton système.
sudo dnf check-update
sudo dnf update -y
sudo dnf -y upgrade
Une fois que tu as mis à jour ton système, tu dois installer les dépendances requises. Exécute la commande suivante pour les installer.
sudo dnf install -y curl openssh-server policycoreutils perl
sudo systemctl enable --now sshd
sudo dnf -y install postfix
sudo systemctl enable --now postfix
sudo dnf -y install chrony
sudo systemctl enable chronyd
Une fois la commande ci-dessus terminée, exécute la commande suivante pour définir ton nom d’hôte. Parce que le nom d’hôte peut être défini sur localhost par défaut, et cela créera des conflits avec d’autres applications que tu pourrais installer à l’avenir. N’oublie pas de remplacer git.example.com par le FQDN de ton choix.
sudo hostnamectl set-hostname git.example.com
Tu dois aussi définir le bon fuseau horaire sur ton serveur. Exécute la commande suivante pour répertorier tous les fuseaux horaires disponibles.
sudo timedatectl list-timezones
Tu obtiendras une liste de tous les fuseaux horaires disponibles sur ton système, comme indiqué ci-dessous.
Choisis un fuseau horaire que tu veux utiliser et exécute la commande suivante avec le fuseau horaire correspondant. N’oublie pas de remplacer America/New_York par ton fuseau horaire. Le paramètre de configuration du fuseau horaire sera défini dans un fichier sous config/gitlab.yml.
sudo timedatectl set-timezone America/New_York
Enfin, configure ton chrony en tant que serveur NTP (Network Time Protocol) afin de pouvoir synchroniser l’horloge du système avec les serveurs. Exécute la commande suivante pour ce faire.
sudo timedatectl set-local-rtc 0
sudo timedatectl set-ntp yes
sudo chronyc sources
Exécute la commande timedatectl sans options pour vérifier l’état actuel de la synchronisation NTP.
timedatectl
Tu verras l’état de ta synchronisation NTP comme indiqué ci-dessous.
Ajouter le référentiel GitLab
Il est maintenant temps d’ajouter le dépôt officiel de GitLab pour que tu puisses installer GitLab. GitLab existe en deux versions, Community Edition(CE) et Enterprise Edition(EE). Nous allons utiliser la version CE. La version CE de GitLab est la version open-source que tu peux utiliser sur ton propre serveur et qui est gratuite à télécharger et à utiliser. Pour ajouter le référentiel GitLab CE, exécute la commande suivante.
sudo tee /etc/yum.repos.d/gitlab_gitlab-ce.repo<<EOL
[gitlab_gitlab-ce]
name=gitlab_gitlab-ce
baseurl=https://packages.gitlab.com/gitlab/gitlab-ce/el/8/\$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://packages.gitlab.com/gitlab/gitlab-ce/gpgkey
https://packages.gitlab.com/gitlab/gitlab-ce/gpgkey/gitlab-gitlab-ce-3D645A26AB9FBD22.pub.gpg
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
EOL
Maintenant, exécute la commande suivante pour vérifier si le référentiel GitLab a été ajouté ou non.
sudo dnf repolist
Tu verras le dépôt gitlab_gitlab-ce comme référentiel, comme indiqué ci-dessous.
Ensuite, exécute la commande suivante pour vérifier si le référentiel est activé ou non.
sudo dnf repolist enabled
Tu verras une sortie comme indiqué ci-dessous.
Ne continue pas avant d’avoir vu que le référentiel gitlab_gitlab-ce est activé. Exécute la commande ci-dessous pour que le référentiel soit activé.
sudo dnf config-manager --set-enabled gitlab_gitlab-ce
Installation de GitLab sur Rocky Linux 8.4
Il est maintenant temps d’installer GitLab sur ton système. Exécute la commande suivante pour le faire. Remplace gitlab.example.com dans la commande par ton FQDN.
sudo EXTERNAL_URL="http://gitlab.example.com" dnf install -y gitlab-ce
L’installation peut prendre un certain temps selon la vitesse de ta connexion Internet et la charge du serveur. Tu verras le résultat ci-dessous une fois la commande terminée, ne ferme pas encore le terminal car il reste encore quelques choses à faire.
Configuration des règles du pare-feu
Maintenant, il est temps de configurer le Pare-feu dans Rocky Linux. Si tu exécutes ton serveur derrière un pare-feu, tu dois autoriser le trafic http et https car nous allons utiliser le protocole HTTP/HTTPS pour accéder à l’interface Web de GitLab. Exécute la commande suivante pour ouvrir les ports HTTP et HTTPS sur ton pare-feu.
sudo firewall-cmd --permanent --add-service=ssh
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
Exécute la commande suivante pour appliquer de nouvelles règles de pare-feu.
sudo systemctl reload firewalld
Accéder à l’interface Web de GitLab
Maintenant que l’installation est terminée, tu peux accéder à l’interface Web en utilisant ton FQDN.
Ouvre ton navigateur préféré et entre FQDN dans la barre d’adresse. Tu verras une page de connexion comme illustré ci-dessous.
Pour te connecter, tu auras besoin d’un mot de passe temporaire, que tu peux obtenir en exécutant la commande ci-dessous dans le terminal. Ce mot de passe a été créé automatiquement pendant le processus d’installation mais ne s’affiche pas. Le développeur Gitlab fait cela pour des raisons de sécurité.
sudo cat /etc/gitlab/initial_root_password
Tu verras apparaître un mot de passe comme indiqué ci-dessous. Copie et enregistre ce mot de passe dans un endroit sûr.
Maintenant, retourne à la page de connexion, où tu dois entrer le nom d’utilisateur ‘root’ et le mot de passe temporaire que tu as copié. Clique sur Connexion.
Une fois la connexion réussie, tu accèderas au tableau de bord Gitlab comme indiqué ci-dessous.
Pour modifier le mot de passe temporaire, clique sur Profil et Modifier le profil en haut à droite. Puis clique sur le lien Mot de passe sur le côté gauche comme indiqué ci-dessous.
Tu seras dirigé vers la page Modifier le mot de passe. Indique ton mot de passe actuel, ton nouveau mot de passe et confirme-le. Puis clique sur Enregistrer le mot de passe comme indiqué ci-dessous.
Tu dois aussi configurer les restrictions d’inscription pour désactiver les nouvelles inscriptions. C’est risqué si tu autorises de nouveaux utilisateurs à s’inscrire car n’importe qui peut alors accéder à ton serveur GitLab. Clique sur Menu, puis va dans la zone Admin en haut à gauche, comme indiqué ci-dessous.
Sur la page suivante, clique sur S’inscrire dans la section Caractéristiques comme indiqué ci-dessous.
Sur la page suivante, tu verras tous les paramètres des restrictions d’inscription. Tu peux désactiver les nouvelles inscriptions en décochant la case Inscription activée. Ensuite, clique sur le bouton Enregistrer les modifications en bas de la page.
Ces étapes ne sont que des configurations de base. Tu peux configurer GitLab plus en détail en cliquant sur le menu ou en allant sur le lien Paramètres. Pour plus de détails, consulte la documentation officielle de GitLab, qui présente toutes les tâches que tu peux effectuer depuis l’interface Web.
Conclusion
Dans ce tutoriel, nous t’avons montré comment installer GitLab sur un serveur Rocky Linux 8.4. Nous espérons que ce tutoriel t’a aidé à démarrer avec GitLab.
Pour une aide et un soutien supplémentaires, consulte la documentation officielle de GitLab. Si tu as des questions ou des commentaires, commente ci-dessous.