Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

GitLab je besplatno web-bazirano spremište koda otvorenog koda za kolaborativni razvoj softvera za DevOps, napisano u Ruby i Go programskim jezicima. Glavni moto GitLaba je "Unesite brzinu s povjerenjem, sigurnost bez žrtava i vidljivost u uspjeh DevOps-a." To je prilično popularna alternativa GitHubu koja nudi značajke wikija, praćenja problema i kontinuirane integracije i implementacije, koristeći licencu otvorenog koda, koju je razvio GitLab Inc.

U sljedećem vodiču naučit ćete kako instalirati GitLab na vaš Debian 11 Bullseye sustav, zajedno s time kako započeti prijavom s root-om kako biste mogli početi postavljati GitLab po svom ukusu ili prema zahtjevima vašeg tima.

Preduvjeti

  • Preporučeni OS: Debian 11 Bullseye
  • Korisnički račun: Korisnički račun sa sudo privilegije or root pristup (su naredba).

Ažuriranje operativnog sustava

Ažurirajte svoj Debian 11 Bullseye operativni sustav kako biste bili sigurni da su svi postojeći paketi ažurirani:

sudo apt update && sudo apt upgrade

Root ili Sudo pristup

Prema zadanim postavkama, kada kreirate svoj račun pri pokretanju s Debianom u usporedbi s drugim distribucijama, on ne dobiva automatski status sudoers. Morate imati pristup root lozinka koristiti naredba su ili posjetite naš vodič na Kako dodati korisnika u Sudoers na Debianu.

Instalirajte ovisnosti za GitLab

Prije nego što instalirate GitLab na svoj operativni sustav Debian 11 Bullseye, morat ćete instalirati ovisnosti za njega kako biste mogli instalirati i upravljati GitLabom.

Otvorite svoj terminal i izvršite sljedeću naredbu:

sudo apt install curl ca-certificates apt-transport-https gnupg2 -y

Oglas


Kreirajte i uvezite GitLab spremište

Prema zadanim postavkama, GitLab ne dolazi zapakiran u Debian 11 zadanim spremištima. To znači da ćete ga morati izraditi ručno. Međutim, GitLab je stvorio zgodnu APT skriptu koju možete preuzeti i izvršiti kako bi vam pomogao u ovom zadatku.

Preuzmite GitLab APT skriptu pomoću naredba curl:

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

Primjer izlaza iz skripte:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Sada, prije nego što nastavite, morat ćete izmijeniti spremište koje je GitLab stvorio. To je zbog toga što je Debian 11 Bullseye tek objavljen, a još nisu napravili spremište za njega. Međutim, još uvijek možete instalirati GitLab i primati ažuriranja promjenom izvora spremišta u Debian 10 Buster.

Da biste to učinili, prvo otvorite “gitlab_gitlab-ce.list” datoteku pomoću bilo kojeg uređivača teksta:

sudo nano /etc/apt/sources.list.d/gitlab_gitlab-ce.list

Zatim zamijenite dvije linije spremišta iz “glavni metak” do “buster main.”

Primjer iz:

deb https://packages.gitlab.com/gitlab/gitlab-ce/debian/ bullseye main
deb-src https://packages.gitlab.com/gitlab/gitlab-ce/debian/ bullseye main

primjer za:

deb https://packages.gitlab.com/gitlab/gitlab-ce/debian/ buster main
deb-src https://packages.gitlab.com/gitlab/gitlab-ce/debian/ buster main

Grafički primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Nakon što učinite, CTRL + O zatim izlazi iz datoteke sa CTRL + X.

Sada pokrenite naredbu apt update za provjeru i sinkronizaciju novog spremišta.

sudo apt update

Imajte na umu da se to može promijeniti u budućnosti, a vodič će se ažurirati kada se to dogodi.

Instalirajte Gitlab

Sljedeći dio vodiča je instalacija GitLaba, a trebali ste već koristiti naredbu apt update za sinkronizaciju novostvorenog i modificiranog spremišta. Sada izvršite naredbu za instalaciju koristeći sljedeće:

sudo apt install gitlab-ce

Primjer izlaza i ovisnosti koje treba instalirati uz GitLab:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Tip "Y", a zatim pritisnite "ENTER TIPKA" za nastavak instalacije. Imajte na umu da je veličina instalacije 2.5GB, pa bi spore internetske veze mogle pričekati neko vrijeme da se preuzimanje i instalacija dovrše.

Nakon što je instalacija dovršena, trebali biste dobiti sljedeći izlaz u svom terminalu.

It looks like GitLab has not been configured yet; skipping the upgrade script.

       *.                  *.
      ***                 ***
     *****               *****
    .******             *******
    ********            ********
   ,,,,,,,,,***********,,,,,,,,,
  ,,,,,,,,,,,*********,,,,,,,,,,,
  .,,,,,,,,,,,*******,,,,,,,,,,,,
      ,,,,,,,,,*****,,,,,,,,,.
         ,,,,,,,****,,,,,,
            .,,,***,,,,
                ,*,.
  


     _______ __  __          __
    / ____(_) /_/ /   ____ _/ /_
   / / __/ / __/ /   / __ `/ __ \
  / /_/ / / /_/ /___/ /_/ / /_/ /
  \____/_/\__/_____/\__,_/_.___/
  

Thank you for installing GitLab!
GitLab was unable to detect a valid hostname for your instance.
Please configure a URL for your GitLab instance by setting `external_url`
configuration in /etc/gitlab/gitlab.rb file.
Then, you can start your GitLab instance by running the following command:
  sudo gitlab-ctl reconfigure

For a comprehensive list of configuration options please see the Omnibus GitLab 
readme
https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/README.md

Help us improve the installation experience, let us know how we did with a 1 min
ute survey:
https://gitlab.fra1.qualtrics.com/jfe/form/SV_6kVqZANThUQ1bZb?installation=omnib
us&release=14-3

Processing triggers for man-db (2.9.4-2) ...
Processing triggers for ufw (0.36-7.1) ...

Oglas


Kako konfigurirati GitLab

S instaliranim GitLab-om sada možete konfigurirati SSL, lozinke naziva domene ili naziva poddomene i još mnogo toga. Vodič će proći kroz osnovne opcije postavljanja koje treba napraviti. Međutim, možete napraviti alternativne postavke za one navedene u nastavku.

Prvo otvorite “gitlab.rb” konfiguracijska datoteka pomoću bilo kojeg uređivača teksta:

sudo nano nano /etc/gitlab/gitlab.rb

Prva postavka bit će postavljanje domene, navigacija do 36. retka i pronalaženje sljedećeg.

external_url 'https://gitlab.linuxcapable.com'

Promijenite ovo u naziv svoje poddomene.

Primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Zatim postavite TLS/SSL s Let's Encrypt, koji počinje na liniji 2297.

Prema zadanim postavkama, sve su postavke komentirane s "#". Morat ćete dekomentirati sljedeće retke.

 letsencrypt['enable'] = true
 letsencrypt['contact_emails'] = ['youremail@yourdomain.com']
 letsencrypt['auto_renew'] = true
 letsencrypt['auto_renew_hour'] = 4
 letsencrypt['auto_renew_day_of_month'] = "*/4"
 letsencrypt['auto_renew_log_directory'] = '/var/log/gitlab/lets-encrypt'

Primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Nakon što učinite, CTRL + O zatim izlazi iz datoteke sa CTRL + X.

Sada pokrenite naredbu reconfigure na sljedeći način.

sudo gitlab-ctl reconfigure

Na kraju ćete na svom terminalu dobiti sljedeću poruku.

Notes:
Default admin account has been configured with following details:
Username: root
Password: You didn't opt-in to print initial root password to STDOUT.
Password stored to /etc/gitlab/initial_root_password. This file will be cleaned up in first reconfigure run after 24 hours.

NOTE: Because these credentials might be present in your log files in plain text, it is highly recommended to reset the password following https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Running handlers complete
Chef Infra Client failed. 218 resources updated in 41 seconds

Notes:
Default admin account has been configured with following details:
Username: root
Password: You didn't opt-in to print initial root password to STDOUT.
Password stored to /etc/gitlab/initial_root_password. This file will be cleaned up in first reconfigure run after 24 hours.

NOTE: Because these credentials might be present in your log files in plain text, it is highly recommended to reset the password following https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Za pregled korijena (GitLab) lozinku, pokrenite sljedeću naredbu.

cat /etc/gitlab/initial_root_password

Primjer rezultata:

# WARNING: This value is valid only in the following conditions
#          1. If provided manually (either via `GITLAB_ROOT_PASSWORD` environment variable or via `gitlab_rails['initial_root_password']` setting in `gitlab.rb`, it was provided before database was seeded for the first time (usually, the first reconfigure run).
#          2. Password hasn't been changed manually, either via UI or via command line.
#
#          If the password shown here doesn't work, you must reset the admin password following https://docs.gitlab.com/ee/security/reset_user_password.html#reset-your-root-password.

Password: SGGg/WQ9+N1JdgouIbPftla+Kt8Qcyr+HL5oJfRbBmM=

# NOTE: This file will be automatically deleted in the first reconfigure run after 24 hours.

Kao što je gore, možete vidjeti lozinku je “SGGg/WQ9+N1JdgouIbPftla+Kt8Qcyr+HL5oJfRbBmM=” i da će ova datoteka biti automatski izbrisana za 24 sata.

Kako pristupiti GitLabu

Sada kada je backend postavljen, vrijeme je da se prijavite i vidite svoj GitLab.

Prvo otvorite put domene gdje je GitLab dodijeljen u konfiguracijskoj datoteci.

Primjer:

https://gitlab.example.com

Zatim se prijavite pomoću korisničkog imena "Korijen" i lozinku koju ste primili, što je u tutorialu bilo “SGGg/WQ9+N1JdgouIbPftla+Kt8Qcyr+HL5oJfRbBmM=”.

Primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Uspješno ste prijavljeni kao root račun i doći ćete na zadanu odredišnu stranicu.

Primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Odavde možete nastaviti s postavljanjem i konfiguriranjem GitLaba kako bi odgovarao vašim zahtjevima ili vašem timu. Jedna od prvih stvari koje trebate učiniti je otići na odjeljak administratora i konfigurirati sigurnost, kao što je 2FA, promjena root lozinki i još mnogo toga prije dodavanja bilo kojeg člana tima. Sve to možete pronaći klikom na Izbornik > Administrator u gornjem lijevom kutu kut stranice.

Primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Oglas


Napravite Cronjob za GitLab Auto Backup

Prema zadanim postavkama, nema kreiranih ili konfiguriranih sigurnosnih kopija. To bi trebalo postaviti pomoću cronjob-a, a frekvenciju postaviti na vrijednost koja odgovara vašoj dostupnosti resursa i učestalosti GitLab promjena.

Prvo otvorite svoj crontab.

sudo crontab -e

Zatim dodajte sljedeći primjer i promijenite vrijeme kako bi odgovaralo vašim potrebama. Ako niste sigurni u vrijeme, posjetite crontab.guru.

00 */3 * * *   root gitlab-rake gitlab:backup:create

Gore navedeno stvara sigurnosnu kopiju točno svaka 3 sata.

Primjer:

Kako instalirati i konfigurirati GitLab na Debian 11 Bullseye

Nakon što učinite, CTRL + O zatim izlazi iz datoteke sa CTRL + X.

Alternativno, zadatak možete pokrenuti u bilo kojem trenutku ručno izvršavanjem sljedeće naredbe.

sudo gitlab-rake gitlab:backup:create

Nakon što je sigurnosna kopija dovršena, dobit ćete sljedeću poruku na svom terminalu.

Backup task is done.

Komentari i zaključak

U sljedećem vodiču naučili ste kako instalirati GitLab na Debian 11 Bullseye, postaviti TLS/SSL s Lets Encrypt i stvoriti backup cron posao. Općenito, GitLab koji samostalno hostira može biti značajan od oslanjanja na treću stranu ako je privatnost važna briga i može učiniti razvoj lakšim i bržim.

Ostavite komentar