Hvernig á að setja upp GitLab Community Edition (CE) 11.x á CentOS 7

Síðan GitHub var keypt af Microsoft hafa allmargir forritarar ætlað að flytja eigin kóðageymslur frá github.com yfir í aðra sjálfhýsta lausn. GitLab Community Edition (CE) er algengasta valið. Sem háþróuð og sveigjanleg lausn er hægt að nota GitLab CE með ýmsum aðferðum, en aðeins verður fjallað um opinberlega ráðlagða aðferð, Omnibus pakkann uppsetningu.

Forkröfur

• Nýtt Vultr CentOS 7 netþjónstilvik með að minnsta kosti 4GB af minni. Mælt er með 8GB eða meira fyrir allt að 100 notendur. Segðu að IPv4 vistfang þess sé 203.0.113.1.
• A sudo notandi .
• Lén gitlab.example.comsem vísað er í tilvikið sem nefnt er hér að ofan.

Athugaðu: Þegar þú setur upp á eigin netþjónstilviki skaltu gæta þess að skipta út öllum dæmigildum fyrir raunveruleg.

Skref 1: Framkvæmdu grunnverkefni til að hýsa GitLab CE

Kveiktu á SSH flugstöð og skráðu þig inn á CentOS 7 netþjónstilvikið þitt sem sudo notandi.

Bættu við skiptisneiði og breyttu skiptistillingunni

Þegar GitLab CE 11.x er sett upp á vél með 4GB af minni þarf að setja upp 4GB skiptisneið til að ganga vel.

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

Athugið: Ef þú ert að nota aðra miðlarastærð getur stærð skiptingarinnar verið breytileg.

Fyrir afköst kerfisins er mælt með því að stilla skiptistillingu kjarnans á lágt gildi eins og 10:

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

Úttak catskipunarinnar verður 10.

Settu upp hýsingarheiti vélarinnar og fullgilt lén (FQDN)

Notaðu eftirfarandi skipanir til að setja upp hýsingarheiti, gitlab, og FQDN, gitlab.example.com, fyrir vélina:

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

Þú getur staðfest niðurstöðurnar:

hostname
hostname -f

Breyta eldveggsreglum

Leyfa HTTP og HTTPS umferð á heimleið:

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

Settu upp EPEL YUM endurhverfan og uppfærðu síðan kerfið

sudo yum install -y epel-release
sudo yum -y update && sudo shutdown -r now

Þegar kerfið er komið í gang aftur skaltu skrá þig aftur inn sem sami sudo notandi til að halda áfram.

Skref 2: Settu upp nauðsynlegar ósjálfstæði

Áður en þú setur upp GitLab CE þarftu að setja upp nauðsynlegar ósjálfstæði:

sudo yum install -y curl policycoreutils-python openssh-server openssh-clients

Einnig, ef þú vilt nota Postfix til að senda tilkynningaskilaboð, þarftu að setja upp Postfix og breyta eldveggsreglum sem hér segir:

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

Þegar Postfix hefur verið sett upp þarftu að stilla Postfix með því að breyta aðalstillingarskránni /etc/postfix/main.cfí samræmi við raunverulegar netþjónsstillingar þínar.

Athugið: Til viðbótar við ofangreindar leiðbeiningar þarftu að senda inn stuðningsmiða til að hætta við sjálfgefna blokk Vultr á SMTP tengi 25.

Að öðrum kosti, ef þú vilt nota aðra skilaboðalausn, skaltu bara sleppa því að setja upp Postfix og velja að nota ytri SMTP netþjón eftir að GitLab CE hefur verið sett upp.

Skref 3: Settu upp GitLab RPM endurhverfan og settu síðan upp GitLab CE

Settu upp GitLab CE RPM geymsluna á kerfinu þínu:

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

Næst skaltu setja upp GitLab CE 11.x:

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

Uppsetningin gæti tekið smá stund.

Að lokum skaltu benda uppáhalds vafranum þínum á http://gitlab.example.comog senda síðan inn nýtt lykilorð eins og beðið er um til að ljúka uppsetningunni.

Héðan í frá, notaðu eftirfarandi skilríki til að skrá þig inn sem stjórnandi:

• Notendanafn: root
• Lykilorð: <your-new-password>

Skref 4: Virkjaðu HTTPS aðgang með því að samþætta Let's Encrypt SSL vottorð

Í bili hefur þú sett upp GitLab CE 11.x á netþjónstilvikinu þínu og notendur geta nú þegar heimsótt síðuna með því að nota HTTP samskiptareglur. Í öryggisskyni er mælt með því að virkja HTTPS aðgang að GitLab þjóninum þínum með því að samþætta Let's Encrypt SSL vottorð.

Notaðu viritilinn til að opna GitLab CE stillingarskrána:

sudo vi /etc/gitlab/gitlab.rb

Finndu eftirfarandi tvær línur:

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

Skiptu þeim út í samræmi við það:

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

Vista og hætta:

:wq!

Keyrðu eftirfarandi skipun til að endurstilla GitLab CE með uppfærðu stillingunum:

sudo gitlab-ctl reconfigure

Endurstillingin mun taka smá stund.

Eftir að endurstillingunni er lokið munu allir notendur neyðast til að nota HTTPS samskiptareglur þegar þeir fara inn á GitLab síðuna.

Athugið: Eftir að skipt hefur verið úr HTTP yfir í HTTPS geta eldri vafrakökur valdið GitLab 422 villu. Að hreinsa vafrakökur lagar þetta mál.