Как да инсталирате GitLab Community Edition (CE) 11.x на CentOS 7

Тъй като GitHub беше придобит от Microsoft, доста разработчици планираха да мигрират собствените си хранилища на код от github.com към алтернативно самостоятелно хоствано решение. GitLab Community Edition (CE) е най-често срещаният избор. Като сложно и гъвкаво решение, GitLab CE може да бъде разгърнат с помощта на различни методи, но тук ще бъде обхванат само официално препоръчания метод, инсталирането на пакет Omnibus.

Предпоставки

• Нов Vultr CentOS 7 сървърен екземпляр с поне 4 GB памет. 8GB или повече се препоръчват за обслужване на до 100 потребители. Да кажем, че неговият IPv4 адрес е 203.0.113.1.
• А потребителското Sudo .
• Домейн gitlab.example.com, насочен към гореспоменатия екземпляр.

Забележка: Когато разгръщате на вашия собствен сървърен екземпляр, не забравяйте да замените всички примерни стойности с действителни.

Стъпка 1: Изпълнете основни задачи за хостване на GitLab CE

Задействайте SSH терминал и влезте във вашия сървър на CentOS 7 като потребител на sudo.

Добавете суап дял и настройте настройката за размяна

Когато разгръщате GitLab CE 11.x на машина с 4GB памет, е необходимо да настроите суап дял от 4GB за безпроблемна работа.

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

Забележка: Ако използвате различен размер на сървъра, размерът на суап дяла може да варира.

За целите на производителността на системата се препоръчва да конфигурирате настройката за размяна на ядрото на ниска стойност като 10:

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

Резултатът от catкомандата ще бъде 10.

Настройте името на хоста на машината и пълното име на домейн (FQDN)

Използвайте следните команди, за да настроите име на хост, gitlab, и FQDN, gitlab.example.com, за машината:

sudo hostnamectl set-hostname gitlab
cat <<EOF | sudo tee /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
203.0.113.1 gitlab.example.com gitlab
EOF

Можете да потвърдите резултатите:

hostname
hostname -f

Променете правилата на защитната стена

Разрешаване на входящ HTTP и HTTPS трафик:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld.service

Инсталирайте репото на EPEL YUM и след това актуализирайте системата

sudo yum install -y epel-release
sudo yum -y update && sudo shutdown -r now

Когато системата работи отново, влезте отново като същия потребител на sudo, за да продължите.

Стъпка 2: Инсталирайте необходимите зависимости

Преди да инсталирате GitLab CE, трябва да инсталирате необходимите зависимости:

sudo yum install -y curl policycoreutils-python openssh-server openssh-clients

Освен това, ако искате да използвате Postfix за изпращане на уведомителни съобщения, трябва да инсталирате Postfix и да промените правилата на защитната стена, както следва:

sudo yum install -y postfix
sudo systemctl enable postfix.service
sudo systemctl start postfix.service
sudo firewall-cmd --permanent --add-service=smtp
sudo firewall-cmd --permanent --add-service=pop3
sudo firewall-cmd --permanent --add-service=imap
sudo firewall-cmd --permanent --add-service=smtps
sudo firewall-cmd --permanent --add-service=pop3s
sudo firewall-cmd --permanent --add-service=imaps
sudo firewall-cmd --reload

След като инсталирате Postfix, трябва да конфигурирате Postfix, като редактирате основния му конфигурационен файл /etc/postfix/main.cfв съответствие с действителните настройки на вашия сървър.

Забележка: В допълнение към горните инструкции, трябва да изпратите билет за поддръжка, за да отмените блокирането по подразбиране на Vultr на SMTP порт 25.

Като алтернатива, ако искате да използвате друго решение за съобщения, просто пропуснете инсталирането на Postfix и изберете да използвате външен SMTP сървър, след като GitLab CE е инсталиран.

Стъпка 3: Настройте репозиторията на GitLab RPM и след това инсталирайте GitLab CE

Настройте GitLab CE RPM хранилище на вашата система:

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

След това инсталирайте GitLab CE 11.x:

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

Инсталацията може да отнеме известно време.

Накрая насочете любимия си уеб браузър към http://gitlab.example.comи след това изпратете нова парола, като бъдете подканени да завършите инсталацията.

Отсега нататък използвайте следните идентификационни данни, за да влезете като администратор:

• потребителско име: root
• парола: <your-new-password>

Стъпка 4: Активирайте HTTPS достъпа чрез интегриране на Let's Encrypt SSL сертификат

Засега успешно сте инсталирали GitLab CE 11.x на вашия сървърен екземпляр и потребителите вече могат да посещават сайта, използвайки HTTP протокола. От съображения за сигурност се препоръчва да активирате HTTPS достъп до вашия GitLab сървър чрез интегриране на Let's Encrypt SSL сертификат.

Използвайте viредактора, за да отворите конфигурационния файл на GitLab CE:

sudo vi /etc/gitlab/gitlab.rb

Намерете следните два реда:

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

Сменете ги съответно:

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

Запазете и излезте:

:wq!

Изпълнете следната команда, за да преконфигурирате GitLab CE, като използвате актуализираните настройки:

sudo gitlab-ctl reconfigure

Преконфигурирането ще отнеме известно време.

След като преконфигурирането бъде извършено, всички потребители ще бъдат принудени да използват HTTPS протокола при достъп до сайта на GitLab.

Забележка: След преминаване от HTTP към HTTPS, наследените бисквитки могат да причинят грешка в GitLab 422. Изчистването на бисквитките решава този проблем.