Comment installer GitLab Community Edition (CE) 11.x sur Debian 9

• Conditions préalables
• Étape 1: effectuer des tâches de base pour l'hébergement de GitLab CE
• Étape 2: installer les dépendances requises
• Étape 3: configurer le référentiel GitLab APT, puis installer GitLab CE
• Étape 4: Activez l'accès HTTPS en intégrant un certificat SSL Let's Encrypt

Depuis l'acquisition de GitHub par Microsoft, plusieurs développeurs ont prévu de migrer leurs propres référentiels de code de github.com vers une autre solution auto-hébergée. GitLab Community Edition (CE) est le choix le plus courant.

En tant que solution sophistiquée et flexible, GitLab CE peut être déployé à l'aide de différentes méthodes, mais seule la méthode officiellement recommandée, l'installation du package Omnibus, sera couverte ici.

Conditions préalables

• Une nouvelle instance de serveur Vultr Debian 9 x64 avec au moins 4 Go de mémoire. 8 Go ou plus est recommandé pour desservir jusqu'à 100 utilisateurs. Supposons que son adresse IPv4 soit 203.0.113.1.
• Un utilisateur sudo .
• Un domaine gitlab.example.compointé vers l'instance mentionnée ci-dessus.

Remarque: lors du déploiement sur votre propre instance de serveur, veillez à remplacer toutes les valeurs d'exemple par des valeurs réelles.

Étape 1: effectuer des tâches de base pour l'hébergement de GitLab CE

Lancez un terminal SSH et connectez-vous à votre instance de serveur Debian 9 x64 en tant qu'utilisateur sudo.

Ajouter une partition de swap et modifier le paramètre de swapiness

Lors du déploiement de GitLab CE 11.x sur une machine avec 4 Go de mémoire, il est nécessaire de configurer une partition de swap de 4 Go pour un bon fonctionnement.

sudo dd if=/dev/zero of=/swapfile count=4096 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

Remarque: Si vous utilisez une taille de serveur différente, la taille de la partition de swap peut varier.

Pour des raisons de performances du système, il est recommandé de configurer le paramètre de permutation du noyau sur une valeur faible comme 10:

echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
cat /proc/sys/vm/swappiness

La sortie de la catcommande sera 10.

Configurez le nom d'hôte de la machine et le nom de domaine complet (FQDN)

Utilisez les commandes suivantes pour configurer un nom d'hôte gitlab, et un nom de domaine complet gitlab.example.com, pour la machine:

sudo hostnamectl set-hostname gitlab
sudo sed -i "1 i\203.0.113.1 gitlab.example.com gitlab" /etc/hosts

Vous pouvez confirmer les résultats:

hostname
hostname -f

Configurer les règles de pare-feu

Configurez des règles de pare-feu raisonnables pour exécuter un site Web:

sudo iptables -F
sudo iptables -X
sudo iptables -Z
sudo iptables -A INPUT -s $(echo $(w -h ${USER}) | cut -d " " -f3) -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -i lo -j ACCEPT
sudo iptables -A INPUT -d 127.0.0.0/8 -j REJECT
sudo iptables -A INPUT -p tcp ! --syn -m state --state NEW -j DROP
sudo iptables -A INPUT -p tcp --tcp-flags ALL NONE -j DROP
sudo iptables -A INPUT -p tcp --tcp-flags ALL ALL -j DROP
sudo iptables -A INPUT -m state --state ESTABLISHED,RELATED -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 80 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -p icmp --icmp-type echo-request -j ACCEPT
sudo iptables -P INPUT DROP
sudo iptables -P OUTPUT ACCEPT
sudo iptables -P FORWARD DROP

Tous les paramètres ci-dessus prendront effet immédiatement. Utilisez la commande suivante pour les répertorier pour examen:

sudo iptables -L -n

Utilisez l' iptable-persistentoutil pour enregistrer toutes les règles iptables existantes dans un fichier /etc/iptables/rules.v4, rendant toutes les règles iptables persistantes:

sudo apt install -y iptables-persistent

Pendant l'installation, il vous sera demandé si vous souhaitez enregistrer les règles IPv4 / IPv6 actuelles. Appuyez ENTERdeux fois pour enregistrer les règles IPv4 et IPv6 actuelles dans /etc/iptables/rules.v4et /etc/iptables/rules.v6.

Si vous essayez de mettre à jour les règles IPv4 ultérieurement, utilisez ce qui suit pour enregistrer votre mise à jour:

sudo bash -c 'iptables-save > /etc/iptables/rules.v4'

Mettre à jour le système

sudo apt update
sudo apt upgrade -y && sudo shutdown -r now

Lorsque le système est de nouveau opérationnel, reconnectez-vous en tant que même utilisateur sudo pour continuer.

Étape 2: installer les dépendances requises

Avant d'installer GitLab CE, vous devez installer les dépendances requises:

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

De plus, si vous souhaitez utiliser Postfix pour envoyer des messages de notification, vous devez installer Postfix:

sudo apt install -y postfix

Pendant l'installation, un écran de configuration peut apparaître:

1. Appuyez sur TABpour mettre en surbrillance le <OK>bouton sur le premier écran, puis appuyez sur ENTER.
2. Sélectionnez Internet Siteet appuyez sur ENTER.
3. Pour le mail namechamp, saisissez le nom de domaine complet de votre serveur gitlab.example.com, et appuyez sur ENTER.
4. Si d'autres écrans apparaissent, appuyez sur ENTERpour accepter les paramètres par défaut.

Démarrez et activez le service Postfix:

sudo systemctl enable postfix.service
sudo systemctl start postfix.service

Modifiez les règles de pare-feu pour Postfix:

sudo iptables -A INPUT -i eth0 -p tcp --dport 25 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 143 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 993 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 110 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo iptables -A INPUT -i eth0 -p tcp --dport 995 -m state --state NEW,ESTABLISHED -j ACCEPT
sudo bash -c 'iptables-save > /etc/iptables/rules.v4'

Après avoir installé Postfix, vous devez configurer Postfix en modifiant son fichier de configuration principal /etc/postfix/main.cfconformément aux paramètres réels de votre serveur.

Remarque: En plus des instructions ci-dessus, vous devez soumettre un ticket de support pour annuler le blocage par défaut de Vultr sur le port SMTP 25.

Alternativement, si vous souhaitez utiliser une autre solution de messagerie, ignorez simplement l'installation de Postfix et choisissez d'utiliser un serveur SMTP externe après l'installation de GitLab CE.

Étape 3: configurer le référentiel GitLab APT, puis installer GitLab CE

Configurez le référentiel GitLab CE APT sur votre système:

cd
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Ensuite, installez GitLab CE 11.x:

sudo EXTERNAL_URL="http://gitlab.example.com" apt install -y gitlab-ce

L'installation peut prendre un certain temps.

Enfin, pointez votre navigateur Web préféré sur http://gitlab.example.com, puis soumettez un nouveau mot de passe lorsque vous y êtes invité pour terminer l'installation.

À partir de maintenant, utilisez les informations d'identification ci-dessous pour vous connecter en tant qu'administrateur:

• Nom d'utilisateur: root
• Mot de passe: <your-new-password>

Étape 4: Activez l'accès HTTPS en intégrant un certificat SSL Let's Encrypt

Pour l'instant, vous avez correctement installé GitLab CE 11.x sur votre instance de serveur et les utilisateurs peuvent déjà visiter le site en utilisant le protocole HTTP. Pour des raisons de sécurité, il est recommandé d'activer l'accès HTTPS à votre serveur GitLab en intégrant un certificat SSL Let's Encrypt.

Utilisez l' viéditeur pour ouvrir le fichier de configuration GitLab CE:

sudo vi /etc/gitlab/gitlab.rb

Trouvez les deux lignes suivantes:

external_url 'http://gitlab.example.com'
# letsencrypt['contact_emails'] = [] # This should be an array of email addresses to add as contacts

Remplacez-les en conséquence:

external_url 'https://gitlab.example.com'
letsencrypt['contact_emails'] = ['[email protected]']

Sauvegarder et quitter:

:wq!

Reconfigurez GitLab CE à l'aide des paramètres mis à jour:

sudo gitlab-ctl reconfigure

La reconfiguration peut prendre un certain temps.

Une fois la reconfiguration terminée, tous les utilisateurs seront obligés d'utiliser le protocole HTTPS lors de l'accès au site GitLab.

Remarque: après le passage de HTTP à HTTPS, les cookies hérités peuvent provoquer une erreur GitLab 422. L'effacement des cookies résout ce problème.