Ako nainštalovať GitLab Community Edition (CE) 11.x na CentOS 7

Odkedy GitHub získal Microsoft, nemálo vývojárov plánovalo migrovať svoje vlastné úložiská kódu z github.com na alternatívne riešenie s vlastným hosťovaním. GitLab Community Edition (CE) je najbežnejšou voľbou. Ako sofistikované a flexibilné riešenie je možné GitLab CE nasadiť pomocou rôznych metód, ale tu bude zahrnutá iba oficiálne odporúčaná metóda, inštalácia balíka Omnibus.

Predpoklady

• Čerstvá inštancia servera Vultr CentOS 7 s najmenej 4 GB pamäte. Na obsluhu až 100 používateľov sa odporúča 8 GB alebo viac. Povedzme, že jeho adresa IPv4 je 203.0.113.1.
• Sudo používateľ .
• Doména gitlab.example.comsmerujúca k inštancii uvedenej vyššie.

Poznámka: Pri nasadzovaní na vlastnej inštancii servera nezabudnite nahradiť všetky vzorové hodnoty skutočnými.

Krok 1: Vykonajte základné úlohy pre hosťovanie GitLab CE

Spustite terminál SSH a prihláste sa do svojej inštancie servera CentOS 7 ako používateľ sudo.

Pridajte odkladací oddiel a upravte nastavenie výmeny

Pri nasadzovaní GitLab CE 11.x na stroji so 4 GB pamäte je potrebné nastaviť 4 GB odkladací oddiel pre 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: Ak používate inú veľkosť servera, veľkosť odkladacieho oddielu sa môže líšiť.

Na účely výkonu systému sa odporúča nakonfigurovať nastavenie swappiness jadra na nízku hodnotu, ako napríklad 10:

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

Výstupom catpríkazu bude 10.

Nastavte názov hostiteľa zariadenia a úplný názov domény (FQDN)

Na nastavenie názvu hostiteľa gitlaba FQDN gitlab.example.compre počítač použite nasledujúce prí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 potvrdiť:

hostname
hostname -f

Upravte pravidlá brány firewall

Povoliť prichádzajúce prenosy HTTP a HTTPS:

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

Nainštalujte EPEL YUM repo a potom aktualizujte systém

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

Keď je systém opäť v prevádzke, prihláste sa ako ten istý používateľ sudo, aby ste mohli pokračovať.

Krok 2: Nainštalujte požadované závislosti

Pred inštaláciou GitLab CE musíte nainštalovať požadované závislosti:

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

Tiež, ak chcete použiť Postfix na odosielanie správ s upozornením, musíte si nainštalovať Postfix a upraviť pravidlá brány firewall takto:

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 nainštalovaní Postfixu musíte Postfix nakonfigurovať úpravou jeho hlavného konfiguračného súboru /etc/postfix/main.cfv súlade so skutočnými nastaveniami servera.

Poznámka: Okrem vyššie uvedených pokynov musíte odoslať podporný lístok na zrušenie predvoleného blokovania Vultr na porte SMTP 25.

Prípadne, ak chcete použiť iné riešenie na odosielanie správ, jednoducho preskočte inštaláciu Postfixu a vyberte použitie externého SMTP servera po inštalácii GitLab CE.

Krok 3: Nastavte GitLab RPM repo a potom nainštalujte GitLab CE

Nastavte úložisko GitLab CE RPM na vašom systéme:

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

Ďalej nainštalujte GitLab CE 11.x:

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

Inštalácia môže chvíľu trvať.

Nakoniec nasmerujte svoj obľúbený webový prehliadač na http://gitlab.example.coma potom odošlite nové heslo podľa výzvy na dokončenie inštalácie.

Odteraz použite na prihlásenie sa ako správca nižšie uvedené prihlasovacie údaje:

• Používateľské meno: root
• heslo: <your-new-password>

Krok 4: Povoľte prístup HTTPS integráciou certifikátu Let's Encrypt SSL

Zatiaľ ste úspešne nainštalovali GitLab CE 11.x na svoju inštanciu servera a používatelia už môžu navštíviť stránku pomocou protokolu HTTP. Z bezpečnostných dôvodov sa odporúča povoliť prístup HTTPS na váš server GitLab integráciou certifikátu Let's Encrypt SSL.

Pomocou vieditora otvorte konfiguračný súbor GitLab CE:

sudo vi /etc/gitlab/gitlab.rb

Nájdite nasledujúce dva riadky:

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

Vymeňte ich podľa toho:

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

Uložiť a ukončiť:

:wq!

Spustite nasledujúci príkaz na prekonfigurovanie GitLab CE pomocou aktualizovaných nastavení:

sudo gitlab-ctl reconfigure

Rekonfigurácia bude chvíľu trvať.

Po vykonaní rekonfigurácie budú všetci používatelia nútení pri prístupe na stránku GitLab používať protokol HTTPS.

Poznámka: Po prepnutí z HTTP na HTTPS môžu staršie súbory cookie spôsobiť chybu GitLab 422. Tento problém rieši vymazanie súborov cookie.