Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

GitLab er ókeypis og opinn uppspretta kóðageymsla á netinu fyrir samvinnuhugbúnaðarþróun fyrir DevOps, skrifuð á Ruby og Go forritunarmálum. Helstu einkunnarorð GitLab er „Komdu með hraða með sjálfstrausti, öryggi án fórna og sýnileika inn í velgengni DevOps. Það er nokkuð vinsæll valkostur við GitHub sem býður upp á wiki, málrakningu og samfellda samþættingu og dreifingu leiðslueiginleika, með því að nota opið leyfi, þróað af GitLab Inc.

Í eftirfarandi námskeiði muntu læra hvernig á að setja upp GitLab á Debian 11 Bullseye kerfinu þínu, ásamt því hvernig á að byrja með því að skrá þig inn með rót svo þú getir byrjað að setja upp GitLab að þínum smekk eða fyrir kröfur liðsins þíns.

Forsendur

  • Mælt með stýrikerfi: Debian 11 Bullseye
  • Notendareikningur: Notendareikningur með sudo réttindi or rótaraðgangur (su skipun).

Uppfærir stýrikerfi

Uppfærðu þína Debian 11 Bullseye stýrikerfi til að tryggja að allir núverandi pakkar séu uppfærðir:

sudo apt update && sudo apt upgrade

Root eða Sudo Access

Sjálfgefið, þegar þú býrð til reikninginn þinn við ræsingu með Debian miðað við aðrar dreifingar, fær hann ekki sjálfkrafa sudoers stöðu. Þú verður annað hvort að hafa aðgang að rót lykilorð til að nota su skipunin eða farðu á námskeiðið okkar á Hvernig á að bæta notanda við Sudoers á Debian.

Settu upp Dependencies fyrir GitLab

Áður en þú setur upp GitLab á Debian 11 Bullseye stýrikerfinu þínu þarftu að setja upp ósjálfstæðin fyrir það svo að þú getir sett upp og stjórnað GitLab.

Opnaðu flugstöðina þína og keyrðu eftirfarandi skipun:

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

Fáðu


Búðu til og flyttu inn GitLab geymslu

Sjálfgefið er að GitLab er ekki pakkað í Debian 11 sjálfgefna geymslum. Þetta þýðir að þú þarft að búa til einn handvirkt. Hins vegar, GitLab hefur búið til handhægt APT forskrift fyrir þig til að hlaða niður og framkvæma til að aðstoða þig við þetta verkefni.

Sæktu GitLab APT handritið með því að nota krulla stjórn:

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

Dæmi úttak úr handritinu:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Nú, áður en þú heldur áfram, þarftu að breyta geymslunni sem GitLab var búið til. Þetta er vegna þess að Debian 11 Bullseye er nýútgefin og þeir hafa ekki búið til geymslu fyrir það ennþá. Hins vegar geturðu samt sett upp GitLab og fengið uppfærslur með því að breyta uppruna geymslunnar í Debian 10 Buster.

Til að gera þetta skaltu fyrst opna „gitlab_gitlab-ce.list“ skrá með hvaða textaritli sem er:

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

Næst skaltu skipta um tvær geymslulínur frá „bullseye aðal“ til "buster main."

Dæmi frá:

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

Dæmi um:

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

Myndrænt dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Þegar búið er að gera CTRL + O sleppir síðan skránni með CTRL + X.

Keyrðu nú apt update skipunina til að staðfesta og samstilla nýju geymsluna.

sudo apt update

Athugið að þetta gæti breyst í framtíðinni og kennsluefnið verður uppfært þegar þetta gerist.

Settu upp Gitlab

Næsti hluti kennslunnar er að setja upp GitLab og þú ættir nú þegar að hafa notað apt update skipunina til að samstilla nýstofnaða og breytta geymslu. Framkvæmdu nú uppsetningarskipunina með því að nota eftirfarandi:

sudo apt install gitlab-ce

Dæmi um úttak og ósjálfstæði sem á að setja upp með GitLab:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Gerð "J," ýttu síðan á „SLAÐA LYKILL“ til að halda áfram með uppsetninguna. Athugið að uppsetningarstærðin er 2.5GB, svo hægar nettengingar gætu beðið um stund þar til niðurhali og uppsetningu lýkur.

Þegar uppsetningunni er lokið ættirðu að fá eftirfarandi úttak í flugstöðinni þinni.

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) ...

Fáðu


Hvernig á að stilla GitLab

Með GitLab uppsett geturðu nú stillt SSL, lénið eða lykilorð undirléns og margt fleira. Kennsluefnið mun fara yfir helstu uppsetningarvalkosti sem ætti að gera. Hins vegar geturðu gert aðrar stillingar en þær sem taldar eru upp hér að neðan.

Fyrst skaltu opna „gitlab.rb“ stillingarskrá með hvaða textaritli sem er:

sudo nano nano /etc/gitlab/gitlab.rb

Fyrsta stillingin mun vera að stilla lénið, fletta niður á línu 36 og finna eftirfarandi.

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

Breyttu þessu í undirlénið þitt.

Dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Næst skaltu setja upp TLS/SSL með Let's Encrypt, sem byrjar á línu 2297.

Sjálfgefið er að allar stillingar séu skrifaðar út með „#“. Þú þarft að afskrifa eftirfarandi línur.

 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'

Dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Þegar búið er að gera CTRL + O sleppir síðan skránni með CTRL + X.

Keyrðu nú endurstilla skipunina sem hér segir.

sudo gitlab-ctl reconfigure

Að lokum færðu eftirfarandi skilaboð í flugstöðinni þinni.

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.

Til að skoða rótina (GitLab) lykilorð, keyrðu eftirfarandi skipun.

cat /etc/gitlab/initial_root_password

Dæmi úttak:

# 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.

Eins og hér að ofan geturðu séð lykilorðið er “SGGg/WQ9+N1JdgouIbPftla+Kt8Qcyr+HL5oJfRbBmM=” og að þessari skrá verði eytt sjálfkrafa eftir 24 klukkustundir.

Hvernig á að fá aðgang að GitLab

Nú þegar stuðningurinn er stilltur er kominn tími til að skrá þig inn og sjá GitLab þitt.

Fyrst skaltu opna lénsslóðina þar sem GitLab var úthlutað í stillingarskránni.

Dæmi:

https://gitlab.example.com

Næst skaltu skrá þig inn með notendanafninu „Rót“ og lykilorðið sem þú fékkst, sem í kennslutilvikinu var “SGGg/WQ9+N1JdgouIbPftla+Kt8Qcyr+HL5oJfRbBmM=”.

Dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Þú hefur skráð þig inn sem rótarreikninginn og þú munt smella á sjálfgefna áfangasíðuna.

Dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Héðan geturðu haldið áfram að setja upp og stilla GitLab til að henta þínum þörfum eða teymi þínu. Eitt af því fyrsta sem þú ættir að gera er að fara í stjórnunarhlutann og stilla öryggið, svo sem 2FA, breyta rót lykilorðum og margt fleira áður en þú bætir við liðsmönnum. Þetta er allt hægt að finna með því að smella á Valmynd > Stjórnandi efst til vinstri horn á síðunni.

Dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Fáðu


Búðu til Cronjob fyrir GitLab Auto Backup

Sjálfgefið er að engin afrit eru búin til eða stillt. Þetta ætti að vera stillt með því að nota cronjob, og tíðnin stillir gildi sem hentar framboði þínu á auðlindum og tíðni GitLab breytinga.

Fyrst skaltu opna crontab þinn.

sudo crontab -e

Næst skaltu bæta við eftirfarandi dæmi og breyta tímanum til að henta þínum þörfum. Ef þú ert svolítið óviss um tímasetninguna skaltu heimsækja crontab.guru.

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

Ofangreint býr til öryggisafrit nákvæmlega á 3ja tíma fresti.

Dæmi:

Hvernig á að setja upp og stilla GitLab á Debian 11 Bullseye

Þegar búið er að gera CTRL + O sleppir síðan skránni með CTRL + X.

Að öðrum kosti geturðu keyrt verkefnið hvenær sem er handvirkt með því að framkvæma eftirfarandi skipun.

sudo gitlab-rake gitlab:backup:create

Þegar öryggisafritinu hefur verið lokið færðu eftirfarandi skilaboð í flugstöðinni þinni.

Backup task is done.

Athugasemdir og niðurstaða

Í eftirfarandi kennslu hefurðu lært hvernig á að setja upp GitLab á Debian 11 Bullseye, setja upp TLS/SSL með Lets Encrypt og búa til öryggisafrit af cron starf. Á heildina litið getur sjálfhýsing GitLab verið mikilvæg en að treysta á þriðja aðila ef friðhelgi einkalífsins er verulegt áhyggjuefni og getur gert þróun auðveldari og hraðari.

Leyfi a Athugasemd