Sådan installeres GitLab Community Edition (CE) 11.x på Ubuntu 18.04 LTS

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 Ubuntu 18.04 LTS 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 Ubuntu 18.04 LTS 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

Rediger firewall-regler

Tillad indgående SSH-, HTTP- og HTTPS-trafik

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

Opdater systemet

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

Under opgraderingen kan du blive informeret om, at den aktuelt installerede version af grub-konfigurationsfilen er blevet ændret lokalt. Da vi faktisk ikke er ansvarlige for ændringen, skal du bruge UPpilen til at fremhæve install the package maintainer's versionindstillingen og derefter trykke på ENTER.

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. For mail namefeltet skal du indtaste din servers FQDN gitlab.example.comog trykke 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 ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

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 følgende legitimationsoplysninger 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'] = ['[email protected]']

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.