GitLab Community Edition (CE) 11.x:n asentaminen CentOS 7:ään

Sen jälkeen kun Microsoft osti GitHubin, monet kehittäjät ovat suunnitelleet siirtävänsä omat koodivarastonsa github.comista vaihtoehtoiseen itseisännöimään ratkaisuun. GitLab Community Edition (CE) on yleisin valinta. Hienostunut ja joustava ratkaisu, GitLab CE voidaan ottaa käyttöön useilla menetelmillä, mutta vain virallisesti suositeltu menetelmä, Omnibus-paketin asennus, käsitellään tässä.

Edellytykset

• Tuore Vultr CentOS 7 -palvelinesiintymä, jossa on vähintään 4 Gt muistia. 8 Gt tai enemmän suositellaan palvelemaan jopa 100 käyttäjää. Oletetaan, että sen IPv4-osoite on 203.0.113.1.
• Sudo käyttäjä .
• Verkkotunnus gitlab.example.comon osoitettu edellä mainittuun ilmentymään.

Huomautus: Kun otat käyttöön omassa palvelinesiintymässäsi, muista korvata kaikki esimerkkiarvot todellisilla arvoilla.

Vaihe 1: Suorita perustehtävät GitLab CE:n isännöimiseksi

Käynnistä SSH-pääte ja kirjaudu sisään CentOS 7 -palvelinesiintymään sudo-käyttäjänä.

Lisää swap-osio ja säädä swapppiness-asetusta

Kun GitLab CE 11.x otetaan käyttöön koneessa, jossa on 4 Gt muistia, sinun on määritettävä 4 Gt:n sivutusosio sujuvan toiminnan varmistamiseksi.

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

Huomautus: Jos käytät eri palvelinkokoa, sivutusosion koko voi vaihdella.

Järjestelmän suorituskyvyn vuoksi on suositeltavaa määrittää ytimen vaihtoasetus pieneksi, kuten 10:

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

Ulostulon catkomento on 10.

Aseta koneen isäntänimi ja täydellinen toimialueen nimi (FQDN)

Käytä seuraavia komentoja gitlabasettaaksesi gitlab.example.comkoneen isäntänimen ja FQDN:n, :

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

Voit vahvistaa tulokset:

hostname
hostname -f

Muokkaa palomuurisääntöjä

Salli saapuva HTTP- ja HTTPS-liikenne:

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

Asenna EPEL YUM -repo ja päivitä sitten järjestelmä

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

Kun järjestelmä on taas käynnissä, kirjaudu takaisin sisään samana sudo-käyttäjänä jatkaaksesi.

Vaihe 2: Asenna tarvittavat riippuvuudet

Ennen kuin asennat GitLab CE:n, sinun on asennettava tarvittavat riippuvuudet:

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

Lisäksi, jos haluat käyttää Postfixiä ilmoitusviestien lähettämiseen, sinun on asennettava Postfix ja muutettava palomuurisääntöjä seuraavasti:

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

Kun Postfix on asennettu, sinun on määritettävä Postfix muokkaamalla sen pääasetustiedostoa /etc/postfix/main.cftodellisten palvelinasetustesi mukaisesti.

Huomautus: Yllä olevien ohjeiden lisäksi sinun on lähetettävä tukilippu peruuttaaksesi Vultrin oletuseston SMTP-portissa 25.

Vaihtoehtoisesti, jos haluat käyttää toista viestintäratkaisua, ohita Postfixin asennus ja valitse ulkoisen SMTP-palvelimen käyttö GitLab CE:n asennuksen jälkeen.

Vaihe 3: Asenna GitLab RPM -repo ja asenna sitten GitLab CE

Asenna GitLab CE RPM -tietovarasto järjestelmässäsi:

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

Asenna seuraavaksi GitLab CE 11.x:

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

Asennus voi kestää hetken.

Osoita lopuksi suosikkiselaimesi kohtaan http://gitlab.example.comja lähetä sitten uusi salasana kehotteen mukaisesti asennuksen viimeistelemiseksi.

Tästä eteenpäin kirjaudu sisään järjestelmänvalvojana alla olevilla tunnuksilla:

• Käyttäjätunnus: root
• Salasana: <your-new-password>

Vaihe 4: Ota HTTPS-käyttö käyttöön integroimalla Let's Encrypt SSL -varmenne

Toistaiseksi olet onnistuneesti asentanut GitLab CE 11.x:n palvelimeesi, ja käyttäjät voivat jo vierailla sivustolla HTTP-protokollan avulla. Turvallisuussyistä on suositeltavaa sallia HTTPS-yhteys GitLab-palvelimellesi integroimalla Let's Encrypt SSL-sertifikaatti.

Käytä vieditorin avaa GitLab CE config file:

sudo vi /etc/gitlab/gitlab.rb

Etsi seuraavat kaksi riviä:

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

Vaihda ne vastaavasti:

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

Tallenna ja lopeta:

:wq!

Suorita seuraava komento määrittääksesi GitLab CE uudelleen päivitetyillä asetuksilla:

sudo gitlab-ctl reconfigure

Uudelleenkonfigurointi kestää jonkin aikaa.

Uudelleenmäärityksen jälkeen kaikki käyttäjät pakotetaan käyttämään HTTPS-protokollaa päästäessään GitLab-sivustolle.

Huomautus: Kun olet vaihtanut HTTP:stä HTTPS:ään, vanhat evästeet voivat aiheuttaa GitLab 422 -virheen. Evästeiden poistaminen korjaa tämän ongelman.