Sådan installeres GitLab Community Edition (CE) 11.x på CentOS 7

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 CentOS 7-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 CentOS 7-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 påkrævet at konfigurere en 4 GB swap-partition for en jævn kørsel.

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
cat <<EOF | sudo tee /etc/hosts
127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
203.0.113.1 gitlab.example.com gitlab
EOF

Du kan bekræfte resultaterne:

hostname
hostname -f

Rediger firewall-regler

Tillad indgående HTTP- og HTTPS-trafik:

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo systemctl reload firewalld.service

Installer EPEL YUM repo og opdater derefter systemet

sudo yum install -y epel-release
sudo yum -y update && 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 yum install -y curl policycoreutils-python openssh-server openssh-clients

Hvis du også vil bruge Postfix til at sende meddelelser, skal du installere Postfix og ændre firewallreglerne som følger:

sudo yum install -y postfix
sudo systemctl enable postfix.service
sudo systemctl start postfix.service
sudo firewall-cmd --permanent --add-service=smtp
sudo firewall-cmd --permanent --add-service=pop3
sudo firewall-cmd --permanent --add-service=imap
sudo firewall-cmd --permanent --add-service=smtps
sudo firewall-cmd --permanent --add-service=pop3s
sudo firewall-cmd --permanent --add-service=imaps
sudo firewall-cmd --reload

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 RPM-repoen og installer derefter GitLab CE

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

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

Installer derefter GitLab CE 11.x:

sudo EXTERNAL_URL="http://gitlab.example.com" yum 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 nedenstående 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'] = ['admin@example.com']

Gem og luk:

:wq!

Kør følgende kommando for at genkonfigurere GitLab CE ved hjælp af de opdaterede indstillinger:

sudo gitlab-ctl reconfigure

Omkonfigurationen vil 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.