Hur man installerar GitLab Community Edition (CE) 11.x på Debian 9

Sedan GitHub köptes upp av Microsoft har en hel del utvecklare planerat att migrera sina egna kodlager från github.com till en alternativ lösning som är självvärd. GitLab Community Edition (CE) är det vanligaste valet.

Som en sofistikerad och flexibel lösning kan GitLab CE distribueras med olika metoder, men endast den officiellt rekommenderade metoden, Omnibus-paketinstallationen, kommer att täckas här.

Förutsättningar

• En ny Vultr Debian 9 x64-serverinstans med minst 4 GB minne. 8 GB eller mer rekommenderas för upp till 100 användare. Säg att dess IPv4-adress är 203.0.113.1.
• En sudo-användare .
• En domän gitlab.example.compekar mot den ovan nämnda instansen.

Obs: När du distribuerar på din egen serverinstans, se till att ersätta alla exempelvärden med faktiska.

Steg 1: Utför grundläggande uppgifter för att vara värd för GitLab CE

Starta en SSH-terminal och logga in på din Debian 9 x64-serverinstans som sudo-användare.

Lägg till en växlingspartition och justera växlingsinställningen

När du distribuerar GitLab CE 11.x på en maskin med 4 GB minne, krävs det att du konfigurerar en 4 GB swap-partition för smidig drift.

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

Obs: Om du använder en annan serverstorlek kan storleken på växlingspartitionen variera.

För systemprestandasyften rekommenderas det att konfigurera kärnans swappiness-inställning till ett lågt värde som 10:

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

Utdata från catkommandot blir 10.

Ställ in maskinens värdnamn och fullt kvalificerade domännamn (FQDN)

Använd följande kommandon för att ställa in ett värdnamn, gitlab, och ett FQDN, gitlab.example.com, för maskinen:

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

Du kan bekräfta resultaten:

hostname
hostname -f

Konfigurera brandväggsregler

Ställ in rimliga brandväggsregler för att köra en webbplats:

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

Alla ovanstående inställningar träder i kraft omedelbart. Använd följande kommando för att lista dem för granskning:

sudo iptables -L -n

Använd iptable-persistentverktyget för att spara alla befintliga iptables-regler i en fil /etc/iptables/rules.v4, vilket gör alla iptables-regler beständiga:

sudo apt install -y iptables-persistent

Under installationen kommer du att bli tillfrågad om du vill spara aktuella IPv4/IPv6-regler. Tryck ENTERtvå gånger för att spara både aktuella IPv4- och IPv6-regler till /etc/iptables/rules.v4och /etc/iptables/rules.v6.

Om du försöker uppdatera IPv4-reglerna senare, använd följande för att spara din uppdatering:

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

Uppdatera systemet

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

När systemet är igång igen, logga in igen som samma sudo-användare för att gå vidare.

Steg 2: Installera nödvändiga beroenden

Innan du installerar GitLab CE måste du installera nödvändiga beroenden:

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

Om du vill använda Postfix för att skicka aviseringsmeddelanden måste du installera Postfix:

sudo apt install -y postfix

Under installationen kan en konfigurationsskärm visas:

1. Tryck på för TABatt markera <OK>knappen på den första skärmen och tryck sedan på ENTER.
2. Välj Internet Siteoch tryck på ENTER.
3. För mail namefältet anger du din servers FQDN gitlab.example.com, och trycker på ENTER.
4. Om andra skärmar visas trycker du på för ENTERatt acceptera standardinställningarna.

Starta och aktivera Postfix-tjänsten:

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

Ändra brandväggsregler för Postfix:

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'

Efter att ha installerat Postfix måste du konfigurera Postfix genom att redigera dess huvudkonfigurationsfil /etc/postfix/main.cfi enlighet med dina faktiska serverinställningar.

Obs: Förutom instruktionerna ovan måste du skicka in en supportärende för att avbryta Vultrs standardblock på SMTP-port 25.

Alternativt, om du vill använda en annan meddelandelösning, hoppa över installationen av Postfix och välj att använda en extern SMTP-server efter att GitLab CE har installerats.

Steg 3: Ställ in GitLab APT-repo och installera sedan GitLab CE

Ställ in GitLab CE APT-förvaret på ditt system:

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

Installera sedan GitLab CE 11.x:

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

Installationen kan ta ett tag.

Slutligen pekar du på din favoritwebbläsare http://gitlab.example.comoch skickar sedan in ett nytt lösenord när du uppmanas att slutföra installationen.

Från och med nu, använd inloggningsuppgifterna nedan för att logga in som administratör:

• Användarnamn: root
• Lösenord: <your-new-password>

Steg 4: Aktivera HTTPS-åtkomst genom att integrera ett Let's Encrypt SSL-certifikat

För närvarande har du framgångsrikt installerat GitLab CE 11.x på din serverinstans, och användare kan redan besöka webbplatsen med hjälp av HTTP-protokollet. Av säkerhetsskäl rekommenderas det att aktivera HTTPS-åtkomst till din GitLab-server genom att integrera ett Let's Encrypt SSL-certifikat.

Använd viredigeraren för att öppna GitLab CE-konfigurationsfilen:

sudo vi /etc/gitlab/gitlab.rb

Hitta följande två rader:

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

Byt ut dem i enlighet med detta:

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

Spara och avsluta:

:wq!

Konfigurera om GitLab CE med uppdaterade inställningar:

sudo gitlab-ctl reconfigure

Omkonfigurationen kan ta en stund.

Efter att omkonfigurationen är klar kommer alla användare att tvingas använda HTTPS-protokollet när de kommer åt GitLab-webbplatsen.

Obs: Efter byte från HTTP till HTTPS kan äldre cookies orsaka ett GitLab 422-fel. Att rensa cookies åtgärdar det här problemet.