Comment installer et configurer gitlab sur Ubuntu 18.04

GitLab est un gestionnaire de référentiel Git open source basé sur le Web écrit en Ruby, comprenant le wiki, la gestion des problèmes, la révision du code, la surveillance et l'intégration et le déploiement continus. Il permet aux développeurs de créer, réviser et déployer leurs projets.

Il existe trois éditions différentes de GitLab disponibles, Community Edition (CE), Enterprise Edition (EE) et une version hébergée par GitLab.

GitLab est le choix numéro un si vous souhaitez vous éloigner de GitHub. Il peut importer des projets et des problèmes à partir de différentes sources, y compris GitHub, ce qui rend le processus de migration sans tracas. L'interface GitLab est bien conçue, propre, intuitive et proche de GitHub en termes d'expérience utilisateur et de fonctionnalité.

Il existe plusieurs façons d'installer GitLab en fonction du cas d'utilisation requis. Ce didacticiel couvre les étapes nécessaires à l'installation et à la configuration de GitLab (CE) sur un système Ubuntu 18.04 à l'aide des packages Omnibus.

Conditions préalables

Ce tutoriel suppose que vous avez une nouvelle installation d'Ubuntu 18.04. Selon la page des exigences de GitLab, il est recommandé d'utiliser un serveur avec:

• au moins 4 Go de mémoire RAM. 2 cœurs de processeur. au moins 2 Go d'espace d'échange. (facultatif) Domaine ou sous-domaine pointant vers l'adresse IP du serveur.

Pour une couche de sécurité supplémentaire, il est recommandé de configurer un pare-feu de base. Vous pouvez suivre les étapes de notre guide Comment configurer un pare-feu avec UFW sur Ubuntu 18.04.

Avant de commencer le didacticiel, assurez-vous que vous êtes connecté en tant qu'utilisateur avec les privilèges sudo.

Installation des dépendances requises

Actualisez l'index du package local et installez les dépendances avec les commandes suivantes:

sudo apt update sudo apt install curl openssh-server ca-certificates

Pour que GitLab puisse envoyer des e-mails de notification, vous pouvez soit installer et utiliser Postfix, soit utiliser un service de messagerie transactionnel tel que SendGrid, MailChimp, MailGun ou SES, auquel cas vous pouvez ignorer l'étape suivante et configurer (https: // docs.gitlab.com/omnibus/settings/smtp.html) une fois l'installation terminée.

Exécutez les commandes suivantes pour installer Postfix sur votre serveur Ubuntu:

debconf-set-selections <<< "postfix postfix/mailname string $(hostname -f)" debconf-set-selections <<< "postfix postfix/main_mailer_type string 'Internet Site'" sudo apt install postfix

Pour plus d'informations sur la configuration de votre propre serveur de messagerie, consultez cette série.

Installer GitLab

L'installation de GitLab est un processus assez simple. Nous allons installer le package GitLab CE à l'aide du gestionnaire de packages apt .

Commencez par ajouter le référentiel GitLab à votre liste de sources système à l'aide de la commande curl suivante:

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash Une fois le référentiel activé, installez le package GitLab en exécutant la commande suivante.

sudo apt install gitlab-ce

Le processus d'installation peut prendre un certain temps et après une installation réussie, vous verrez la sortie suivante:

Thank you for installing GitLab!

Ajustement des règles de pare-feu

Le guide sur la configuration d'un pare-feu de base est lié dans la section des prérequis. Pour pouvoir accéder à l'interface GitLab, nous devons ouvrir les ports 80 et 443 :

sudo ufw allow OpenSSH sudo ufw allow sudo ufw allow

Pour être sûr que les ports requis sont ouverts, vous pouvez vérifier l'état du pare-feu avec:

sudo ufw status

Status: active To Action From -- ------ ---- 80/tcp ALLOW Anywhere 443/tcp ALLOW Anywhere OpenSSH ALLOW Anywhere 80/tcp (v6) ALLOW Anywhere (v6) 443/tcp (v6) ALLOW Anywhere (v6) OpenSSH (v6) ALLOW Anywhere (v6)

Définissez l'URL de GitLab

Avant d'accéder à l'interface Web de GitLab, nous devons définir l'URL sur laquelle GitLab sera accessible. Ouvrez le fichier de configuration de Gitlab et apportez les modifications suivantes:

sudo nano /etc/gitlab/gitlab.rb

En haut du fichier de configuration, vous verrez une ligne commençant par external_url . Modifiez la valeur pour qu'elle corresponde à votre domaine / sous-domaine ou à votre adresse IP. Si vous avez un domaine, utilisez https et si vous souhaitez accéder à l'interface GitLab via l'adresse IP de votre serveur, utilisez http .

/etc/gitlab/gitlab.rb

external_url 'https://gitlab.example.com'

Recherchez ensuite «Intégration de Let's Encrypt», décommentez la ligne commençant par letsencrypt et définissez-la sur true. Facultativement, si vous souhaitez recevoir des e-mails de Let's Encrypt concernant votre domaine, décommentez la ligne commençant par letsencrypt et ajoutez votre adresse e-mail.

/etc/gitlab/gitlab.rb

letsencrypt = true letsencrypt = # This should be an array of email addresses to add as contacts

Enfin, enregistrez et fermez le fichier et exécutez la commande suivante pour reconfigurer Gitlab:

sudo gitlab-ctl reconfigure

La commande va reconfigurer vos paramètres GitLab et générer un certificat SSL Let's encrypt gratuit.

Configurer GitLab via l'interface Web

Maintenant que vous avez configuré l'URL de GitLab, vous pouvez commencer par la configuration initiale via l'interface Web de GitLab.

Lancez votre navigateur Web et accédez à:

https://your_gitlab_domain_or_server_IP.com

1. Définition du mot de passe du compte administratif

La première fois que vous accédez à l'interface Web, vous serez invité à définir le mot de passe du compte administratif.

Vous devriez maintenant pouvoir pousser et extraire les modifications de votre projet depuis votre ordinateur local sans avoir à fournir les informations d'identification de votre compte GitLab.

Conclusion

Ce tutoriel vous a guidé à travers l'installation et la configuration de GitLab sur Ubuntu 18.04. Vous avez également appris comment modifier vos paramètres de profil, comment changer le nom d'utilisateur et ajouter une clé SSH. Vous pouvez maintenant créer votre premier projet et commencer à utiliser votre GitLab.

ubuntu git gitlab