Jak nainstalovat GitLab Community Edition (CE) 11.x na Ubuntu 18.04 LTS

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 Ubuntu 18.04 LTS x64 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 Ubuntu 18.04 LTS x64 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
sudo sed -i "1 i\203.0.113.1 gitlab.example.com gitlab" /etc/hosts

Výsledky můžete potvrdit:

hostname
hostname -f

Upravte pravidla brány firewall

Povolit příchozí provoz SSH, HTTP a HTTPS

sudo ufw allow OpenSSH
sudo ufw allow http
sudo ufw allow https
sudo ufw enable

Aktualizujte systém

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

Během upgradu můžete být informováni, že aktuálně nainstalovaná verze konfiguračního souboru grub byla lokálně upravena. Protože za úpravu ve skutečnosti neneseme odpovědnost, pomocí UPšipky zvýrazněte install the package maintainer's versionmožnost a stiskněte ENTER.

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 apt install -y curl openssh-server ca-certificates

Také, pokud chcete používat Postfix k odesílání zpráv s upozorněním, musíte nainstalovat Postfix:

sudo apt install -y postfix

Během instalace se může zobrazit konfigurační obrazovka:

1. Stisknutím TABzvýrazněte <OK>tlačítko na první obrazovce a poté stiskněte ENTER.
2. Vyberte Internet Sitea stiskněte ENTER.
3. Do mail namepole zadejte FQDN vašeho serveru gitlab.example.coma stiskněte ENTER.
4. Pokud se objeví další obrazovky, stiskněte ENTERpro potvrzení výchozího nastavení.

Spusťte a povolte službu Postfix:

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

Upravte pravidla brány firewall pro Postfix:

sudo ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

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 APT a poté nainstalujte GitLab CE

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

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

Dále nainstalujte GitLab CE 11.x:

sudo EXTERNAL_URL="http://gitlab.example.com" apt 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!

Překonfigurujte GitLab CE pomocí aktualizovaných nastavení:

sudo gitlab-ctl reconfigure

Rekonfigurace může 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.