Jak nainstalovat GitLab Community Edition (CE) 11.x na CentOS 7

Od té doby, co GitHub získal Microsoft, nemálo vývojářů plánovalo migrovat svá vlastní úložiště kódu z github.com na alternativní řešení s vlastním hostitelem. Nejběžnější volbou je GitLab Community Edition (CE). Jako sofistikované a flexibilní řešení lze GitLab CE nasadit pomocí různých metod, ale zde bude popsána pouze oficiálně doporučená metoda, instalace balíčku Omnibus.

Předpoklady

• Čerstvá instance serveru Vultr CentOS 7 s alespoň 4 GB paměti. Pro obsluhu až 100 uživatelů se doporučuje 8 GB nebo více. Řekněme, že jeho adresa IPv4 je 203.0.113.1.
• Uživatel sudo .
• Doména gitlab.example.comsměřující k výše uvedené instanci.

Poznámka: Při nasazení na vlastní instanci serveru nezapomeňte nahradit všechny vzorové hodnoty skutečnými.

Krok 1: Proveďte základní úkoly pro hostování GitLab CE

Spusťte SSH terminál a přihlaste se k instanci serveru CentOS 7 jako uživatel sudo.

Přidejte swapovací oddíl a upravte nastavení swappiness

Při nasazování GitLab CE 11.x na počítači se 4 GB paměti je nutné nastavit 4GB odkládací oddíl pro hladký chod.

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

Poznámka: Pokud používáte jinou velikost serveru, může se velikost odkládacího oddílu lišit.

Pro účely výkonu systému se doporučuje nakonfigurovat nastavení swappiness jádra na nízkou hodnotu, jako je 10:

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

Výstupem catpříkazu bude 10.

Nastavte název hostitele počítače a plně kvalifikovaný název domény (FQDN)

K nastavení názvu hostitele gitlaba FQDN gitlab.example.compro počítač použijte následující příkazy :

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

Výsledky můžete potvrdit:

hostname
hostname -f

Upravte pravidla brány firewall

Povolit příchozí provoz HTTP a HTTPS:

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

Nainstalujte EPEL YUM repo a poté aktualizujte systém

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

Až bude systém znovu spuštěn, přihlaste se jako stejný uživatel sudo, abyste mohli pokračovat.

Krok 2: Nainstalujte požadované závislosti

Před instalací GitLab CE je třeba nainstalovat požadované závislosti:

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

Také, pokud chcete používat Postfix k odesílání zpráv s upozorněním, musíte nainstalovat Postfix a upravit pravidla brány firewall následovně:

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

Po instalaci Postfixu musíte Postfix nakonfigurovat úpravou jeho hlavního konfiguračního souboru /etc/postfix/main.cfv souladu s vaším skutečným nastavením serveru.

Poznámka: Kromě výše uvedených pokynů musíte odeslat lístek podpory ke zrušení výchozího blokování Vultr na portu SMTP 25.

Případně, pokud chcete použít jiné řešení pro zasílání zpráv, stačí přeskočit instalaci Postfixu a po instalaci GitLab CE zvolit použití externího SMTP serveru.

Krok 3: Nastavte repo GitLab RPM a poté nainstalujte GitLab CE

Nastavte úložiště GitLab CE RPM na vašem systému:

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

Dále nainstalujte GitLab CE 11.x:

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

Instalace může chvíli trvat.

Nakonec nasměrujte svůj oblíbený webový prohlížeč na http://gitlab.example.coma poté po zobrazení výzvy k dokončení instalace odešlete nové heslo.

Od této chvíle použijte k přihlášení jako správce následující přihlašovací údaje:

• uživatelské jméno: root
• Heslo: <your-new-password>

Krok 4: Povolte přístup HTTPS integrací certifikátu Let's Encrypt SSL

Prozatím jste úspěšně nainstalovali GitLab CE 11.x na svou instanci serveru a uživatelé již mohou stránky navštěvovat pomocí protokolu HTTP. Z bezpečnostních důvodů se doporučuje povolit přístup HTTPS na váš server GitLab integrací certifikátu Let's Encrypt SSL.

Pomocí vieditoru otevřete konfigurační soubor GitLab CE:

sudo vi /etc/gitlab/gitlab.rb

Najděte následující dva řádky:

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

Vyměňte je podle toho:

external_url 'https://gitlab.example.com'
letsencrypt['contact_emails'] = ['admin@example.com']

Uložit a ukončit:

:wq!

Spuštěním následujícího příkazu překonfigurujte GitLab CE pomocí aktualizovaných nastavení:

sudo gitlab-ctl reconfigure

Rekonfigurace bude chvíli trvat.

Po dokončení rekonfigurace budou všichni uživatelé nuceni při přístupu na stránky GitLab používat protokol HTTPS.

Poznámka: Po přepnutí z HTTP na HTTPS mohou starší soubory cookie způsobit chybu GitLab 422. Tento problém řeší vymazání souborů cookie.