Sådan installeres GitLab Community Edition (CE) 11.x på Debian 9

Siden GitHub blev opkøbt af Microsoft, har en del udviklere planlagt at migrere deres egne kodelagre fra github.com til en alternativ selvhostet løsning. GitLab Community Edition (CE) er det mest almindelige valg.

Som en sofistikeret og fleksibel løsning kan GitLab CE implementeres ved hjælp af forskellige metoder, men kun den officielt anbefalede metode, Omnibus-pakkeinstallationen, vil blive dækket heri.

Forudsætninger

• En frisk Vultr Debian 9 x64-serverinstans med mindst 4 GB hukommelse. 8 GB eller mere anbefales til at betjene op til 100 brugere. Sig, at dens IPv4-adresse er 203.0.113.1.
• En sudo-bruger .
• Et domæne, gitlab.example.comder peger mod den ovenfor nævnte instans.

Bemærk: Når du installerer på din egen serverinstans, skal du sørge for at erstatte alle eksempelværdier med faktiske.

Trin 1: Udfør grundlæggende opgaver til hosting af GitLab CE

Tænd en SSH-terminal, og log ind på din Debian 9 x64-serverinstans som sudo-bruger.

Tilføj en swap-partition og juster swap-indstillingen

Når du implementerer GitLab CE 11.x på en maskine med 4 GB hukommelse, er det nødvendigt at konfigurere en 4 GB swap-partition for problemfri 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

Bemærk: Hvis du bruger en anden serverstørrelse, kan størrelsen af ​​swap-partitionen variere.

Af hensyn til systemets ydeevne anbefales det at konfigurere kernens swappiness-indstilling til en lav værdi som 10:

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

Outputtet af catkommandoen vil være 10.

Konfigurer maskinens værtsnavn og fuldt kvalificerede domænenavn (FQDN)

Brug følgende kommandoer til at konfigurere et værtsnavn, gitlab, og et FQDN, gitlab.example.com, for maskinen:

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

Du kan bekræfte resultaterne:

hostname
hostname -f

Konfigurer firewall regler

Opsæt rimelige firewallregler for at køre et websted:

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

Alle ovenstående indstillinger træder i kraft med det samme. Brug følgende kommando til at liste dem til gennemsyn:

sudo iptables -L -n

Brug iptable-persistentværktøjet til at gemme alle eksisterende iptables-regler i en fil /etc/iptables/rules.v4, hvilket gør alle iptables-regler vedvarende:

sudo apt install -y iptables-persistent

Under installationen bliver du spurgt, om du vil gemme aktuelle IPv4/IPv6-regler. Tryk ENTERto gange for at gemme både aktuelle IPv4- og IPv6-regler til /etc/iptables/rules.v4og /etc/iptables/rules.v6.

Hvis du forsøger at opdatere IPv4-reglerne senere, skal du bruge følgende til at gemme din opdatering:

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

Opdater systemet

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

Når systemet er oppe og køre igen, skal du logge ind igen som den samme sudo-bruger for at komme videre.

Trin 2: Installer nødvendige afhængigheder

Før du installerer GitLab CE, skal du installere de nødvendige afhængigheder:

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

Hvis du vil bruge Postfix til at sende meddelelser, skal du også installere Postfix:

sudo apt install -y postfix

Under installationen kan en konfigurationsskærm vises:

1. Tryk på for TABat fremhæve <OK>knappen på den første skærm, og tryk derefter på ENTER.
2. Vælg Internet Siteog tryk på ENTER.
3. Indtast mail namedin servers FQDN for feltet gitlab.example.com, og tryk på ENTER.
4. Hvis andre skærmbilleder vises, skal du trykke på for ENTERat acceptere standardindstillingerne.

Start og aktiver Postfix-tjenesten:

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

Rediger firewallregler for 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'

Når Postfix er installeret, skal du konfigurere Postfix ved at redigere dens hovedkonfigurationsfil /etc/postfix/main.cfi overensstemmelse med dine faktiske serverindstillinger.

Bemærk: Ud over ovenstående instruktioner skal du indsende en supportbillet for at annullere Vultrs standardblokering på SMTP-port 25.

Alternativt, hvis du vil bruge en anden beskedløsning, skal du bare springe over at installere Postfix og vælge at bruge en ekstern SMTP-server efter GitLab CE er blevet installeret.

Trin 3: Konfigurer GitLab APT-repoen og installer derefter GitLab CE

Opsæt GitLab CE APT-lageret på dit system:

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

Installer derefter GitLab CE 11.x:

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

Installationen kan tage et stykke tid.

Til sidst skal du pege på din foretrukne webbrowser http://gitlab.example.comog derefter indsende en ny adgangskode, når du bliver bedt om det, for at afslutte installationen.

Fra nu af skal du bruge legitimationsoplysningerne nedenfor til at logge på som administrator:

• Brugernavn: root
• Adgangskode: <your-new-password>

Trin 4: Aktiver HTTPS-adgang ved at integrere et Let's Encrypt SSL-certifikat

For nu har du installeret GitLab CE 11.x på din serverinstans, og brugere kan allerede besøge webstedet ved hjælp af HTTP-protokollen. Af sikkerhedsmæssige årsager anbefales det at aktivere HTTPS-adgang til din GitLab-server ved at integrere et Let's Encrypt SSL-certifikat.

Brug vieditoren til at åbne GitLab CE-konfigurationsfilen:

sudo vi /etc/gitlab/gitlab.rb

Find følgende to linjer:

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

Udskift dem i overensstemmelse hermed:

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

Gem og luk:

:wq!

Genkonfigurer GitLab CE ved hjælp af opdaterede indstillinger:

sudo gitlab-ctl reconfigure

Omkonfigurationen kan tage et stykke tid.

Efter omkonfigurationen er udført, vil alle brugere blive tvunget til at bruge HTTPS-protokollen, når de tilgår GitLab-siden.

Bemærk: Efter skift fra HTTP til HTTPS kan ældre cookies forårsage en GitLab 422-fejl. Sletning af cookies løser dette problem.