Kuidas installida GitLab Community Edition (CE) 11.x Debian 9

Pärast seda, kui Microsoft omandas GitHubi, on üsna paljud arendajad plaaninud oma koodihoidlad saidilt github.com üle viia alternatiivsele isehostitavale lahendusele. GitLab Community Edition (CE) on kõige levinum valik.

Keeruka ja paindliku lahendusena saab GitLab CE-d juurutada erinevatel meetoditel, kuid siin käsitletakse ainult ametlikult soovitatud meetodit, Omnibusi paketi installimist.

Eeltingimused

• Värske Vultr Debian 9 x64 serveri eksemplar vähemalt 4 GB mäluga. Kuni 100 kasutaja teenindamiseks on soovitatav 8 GB või rohkem. Oletame, et selle IPv4-aadress on 203.0.113.1.
• Sudo kasutaja .
• Domeen, mis gitlab.example.comon suunatud ülalmainitud eksemplarile.

Märkus. Kui juurutate oma serveri eksemplari, asendage kindlasti kõik näidisväärtused tegelike väärtustega.

1. samm: tehke GitLab CE hostimiseks põhitoimingud

Käivitage SSH-terminal ja logige oma Debian 9 x64 serveri eksemplari sisse sudo kasutajana.

Lisage vahetussektsioon ja muutke vahetusseadistust

GitLab CE 11.x juurutamisel 4 GB mäluga masinas tuleb sujuvaks tööks seadistada 4 GB vahetussektsioon.

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

Märkus. Kui kasutate erineva suurusega serverit, võib vahetuspartitsiooni suurus erineda.

Süsteemi jõudluse huvides on soovitatav konfigureerida kerneli vahetussätted madalale väärtusele, näiteks 10:

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

catKäsu väljundiks on 10.

Seadistage masina hostinimi ja täielikult kvalifitseeritud domeeninimi (FQDN)

Kasutage masinale hostinime gitlabja FQDN-i seadistamiseks järgmisi käske gitlab.example.com:

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

Saate tulemusi kinnitada:

hostname
hostname -f

Tulemüüri reeglite seadistamine

Seadistage veebisaidi käitamiseks mõistlikud tulemüürireeglid:

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

Kõik ülaltoodud seaded jõustuvad kohe. Nende ülevaatamiseks loetlemiseks kasutage järgmist käsku:

sudo iptables -L -n

Kasutage seda iptable-persistenttööriista kõigi olemasolevate iptablesi reeglite salvestamiseks faili /etc/iptables/rules.v4, muutes kõik iptablesi reeglid püsivaks:

sudo apt install -y iptables-persistent

Installimise ajal küsitakse teilt, kas soovite salvestada kehtivad IPv4/IPv6 reeglid. Vajutage ENTERkaks korda, et salvestada nii praegused IPv4 kui ka IPv6 reeglid asukohta /etc/iptables/rules.v4ja /etc/iptables/rules.v6.

Kui proovite IPv4 reegleid hiljem värskendada, kasutage värskenduse salvestamiseks järgmist.

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

Uuenda süsteemi

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

Kui süsteem uuesti tööle hakkab, logige edasi liikumiseks sisse sama sudo kasutajana.

2. samm: installige vajalikud sõltuvused

Enne GitLab CE installimist peate installima vajalikud sõltuvused:

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

Samuti, kui soovite Postfixi kasutada teavitussõnumite saatmiseks, peate installima Postfixi:

sudo apt install -y postfix

Installimise ajal võib ilmuda konfiguratsiooniekraan:

1. Vajutage nuppu, TABet tõsta esile <OK>esimesel ekraanil olev nupp, ja seejärel vajutage ENTER.
2. Valige Internet Siteja vajutage ENTER.
3. Sest mail namevaldkonnas, sisestada oma serveri FQDN, gitlab.example.comja vajutage ENTER.
4. Kui ilmuvad muud ekraanid, vajutage ENTERvaikesätetega nõustumiseks.

Käivitage ja lubage Postfix teenus:

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

Muutke Postfixi tulemüürireegleid:

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'

Kui Postfix on installitud, peate Postfixi konfigureerima, muutes selle peamist konfiguratsioonifaili /etc/postfix/main.cfvastavalt teie tegelikele serveriseadetele.

Märkus . Lisaks ülaltoodud juhistele peate esitama tugipileti, et tühistada Vultri vaikeblokeering SMTP-pordis 25.

Teise võimalusena, kui soovite kasutada mõnda muud sõnumsidelahendust, jätke Postfixi installimine vahele ja valige pärast GitLab CE installimist välise SMTP-serveri kasutamine.

3. samm: seadistage GitLabi APT repo ja seejärel installige GitLab CE

Seadistage oma süsteemis GitLab CE APT hoidla:

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

Järgmisena installige GitLab CE 11.x:

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

Installimine võib veidi aega võtta.

Lõpuks suunake oma lemmikveebibrauser aadressile http://gitlab.example.comja esitage installimise lõpetamiseks uus parool, nagu kuvatakse.

Nüüdsest kasutage administraatorina sisselogimiseks allolevaid mandaate:

• Kasutajanimi: root
• Parool: <your-new-password>

4. toiming: lubage HTTPS-i juurdepääs, integreerides Let's Encrypt SSL-sertifikaadi

Praeguseks olete oma serveri eksemplari edukalt installinud GitLab CE 11.x ja kasutajad saavad saiti juba HTTP-protokolli kasutades külastada. Turvalisuse huvides on soovitatav lubada HTTPS-i juurdepääs oma GitLabi serverile, integreerides Let's Encrypt SSL-sertifikaadi.

viGitLab CE konfiguratsioonifaili avamiseks kasutage redaktorit:

sudo vi /etc/gitlab/gitlab.rb

Otsige üles järgmised kaks rida:

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

Asendage need vastavalt:

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

Salvestage ja lõpetage:

:wq!

GitLab CE konfigureerimine värskendatud sätete abil uuesti:

sudo gitlab-ctl reconfigure

Ümberseadistamine võib veidi aega võtta.

Pärast ümberseadistamist on kõik kasutajad sunnitud kasutama GitLabi saidile juurdepääsuks HTTPS-protokolli.

Märkus. Pärast HTTP-lt HTTPS-ile üleminekut võivad pärandküpsised põhjustada GitLabi 422 tõrke. Küpsiste kustutamine lahendab selle probleemi.