Hvordan installere GitLab Community Edition (CE) 11.x på Ubuntu 18.04 LTS

Siden GitHub ble kjøpt opp av Microsoft, har ganske mange utviklere planlagt å migrere sine egne kodelagre fra github.com til en alternativ selvhostet løsning. GitLab Community Edition (CE) er det vanligste valget.

Som en sofistikert og fleksibel løsning kan GitLab CE distribueres ved hjelp av ulike metoder, men bare den offisielt anbefalte metoden, Omnibus-pakkeinstallasjonen, vil bli dekket her.

Forutsetninger

• En fersk Vultr Ubuntu 18.04 LTS x64-serverforekomst med minst 4 GB minne. 8 GB eller mer anbefales for å betjene opptil 100 brukere. Si at IPv4-adressen er 203.0.113.1.
• En sudo-bruker .
• Et domene gitlab.example.comsom peker mot forekomsten nevnt ovenfor.

Merk: Når du distribuerer på din egen serverforekomst, må du passe på å erstatte alle eksempelverdier med faktiske.

Trinn 1: Utfør grunnleggende oppgaver for å være vert for GitLab CE

Fyr opp en SSH-terminal, og logg på Ubuntu 18.04 LTS x64-serverforekomsten som en sudo-bruker.

Legg til en swap-partisjon og juster swapness-innstillingen

Når du distribuerer GitLab CE 11.x på en maskin med 4 GB minne, er det nødvendig å sette opp en 4 GB byttepartisjon for jevn 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

Merk: Hvis du bruker en annen serverstørrelse, kan størrelsen på swap-partisjonen variere.

For systemytelsesformål, anbefales det å konfigurere kjernens swappiness-innstilling til en lav verdi som 10:

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

Utgangen av catkommandoen vil være 10.

Konfigurer maskinens vertsnavn og fullt kvalifiserte domenenavn (FQDN)

Bruk følgende kommandoer for å sette opp et vertsnavn, 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 bekrefte resultatene:

hostname
hostname -f

Endre brannmurregler

Tillat innkommende SSH-, HTTP- og HTTPS-trafikk

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

Oppdater systemet

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

Under oppgraderingen kan du bli informert om at den installerte versjonen av grub-konfigurasjonsfilen har blitt endret lokalt. Siden vi faktisk ikke er ansvarlige for endringen, bruk UPpilen for å markere install the package maintainer's versionalternativet, og trykk deretter ENTER.

Når systemet er oppe og går igjen, logger du på igjen som samme sudo-bruker for å gå videre.

Trinn 2: Installer nødvendige avhengigheter

Før du installerer GitLab CE, må du installere nødvendige avhengigheter:

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

Hvis du vil bruke Postfix til å sende varslingsmeldinger, må du også installere Postfix:

sudo apt install -y postfix

Under installasjonen kan et konfigurasjonsskjermbilde vises:

1. Trykk på for TABå utheve <OK>knappen på den første skjermen, og trykk deretter på ENTER.
2. Velg Internet Siteog trykk ENTER.
3. For mail namefeltet, skriv inn serverens FQDN gitlab.example.comog trykk ENTER.
4. Hvis andre skjermer vises, trykk for ENTERå godta standardinnstillingene.

Start og aktiver Postfix-tjenesten:

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

Endre brannmurregler for Postfix:

sudo ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

Etter å ha installert Postfix, må du konfigurere Postfix ved å redigere hovedkonfigurasjonsfilen /etc/postfix/main.cfi samsvar med dine faktiske serverinnstillinger.

Merk: I tillegg til instruksjonene ovenfor, må du sende inn en støttebillett for å kansellere Vultrs standardblokkering på SMTP-port 25.

Alternativt, hvis du ønsker å bruke en annen meldingsløsning, hopper du over installasjonen av Postfix og velger å bruke en ekstern SMTP-server etter at GitLab CE er installert.

Trinn 3: Sett opp GitLab APT-repoen og installer deretter GitLab CE

Sett opp GitLab CE APT-depotet på systemet ditt:

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

Installer deretter GitLab CE 11.x:

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

Installasjonen kan ta en stund.

Til slutt, pek på favorittnettleseren din http://gitlab.example.com, og send deretter inn et nytt passord når du blir bedt om å fullføre installasjonen.

Fra nå av, bruk følgende legitimasjon for å logge på som administrator:

• Brukernavn: root
• Passord: <your-new-password>

Trinn 4: Aktiver HTTPS-tilgang ved å integrere et Let's Encrypt SSL-sertifikat

Foreløpig har du installert GitLab CE 11.x på serverinstansen din, og brukere kan allerede besøke nettstedet ved å bruke HTTP-protokollen. Av sikkerhetshensyn anbefales det å aktivere HTTPS-tilgang til GitLab-serveren din ved å integrere et Let's Encrypt SSL-sertifikat.

Bruk vieditoren til å åpne GitLab CE-konfigurasjonsfilen:

sudo vi /etc/gitlab/gitlab.rb

Finn 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

Erstatt dem tilsvarende:

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

Lagre og avslutt:

:wq!

Rekonfigurer GitLab CE ved å bruke oppdaterte innstillinger:

sudo gitlab-ctl reconfigure

Rekonfigurasjonen kan ta en stund.

Etter at omkonfigureringen er fullført, vil alle brukere bli tvunget til å bruke HTTPS-protokollen når de får tilgang til GitLab-siden.

Merk: Etter å ha byttet fra HTTP til HTTPS, kan eldre informasjonskapsler forårsake en GitLab 422-feil. Sletting av informasjonskapsler løser dette problemet.