Git
Chapters ▾ 2nd Edition

4.8 Git на Сервер - GitLab

GitLab

Сепак, GitWeb е прилично симплистички. Ако барате посовремен, целосно опремен сервер Git, постојат неколку решенија со отворен код таму што можете да ги инсталирате. Бидејќи GitLab е една од најпопуларните, ние ќе го покриеме инсталирањето и користењето како пример. Ова е малку покомплексно од опцијата GitWeb и веројатно бара повеќе одржување, но тоа е многу попосебна опција.

Инсталација

GitLab е web-апликација поддржана од база на податоци, па затоа нејзината инсталација е малку повеќе вклучена од некои други Git сервери. За среќа, овој процес е многу добро документиран и поддржан.

Постојат неколку методи што можете да ги извршите за да го инсталирате GitLab. За да добиете нешто брзо и трчање, можете да преземете слика од виртуелната машина или да инсталирате еден клик од https://bitnami.com/stack/gitlab [] и да ја конфигурирате конфигурацијата за да одговараат на одредена околина. Еден убав допир Bitnami вклучен е екранот за најава (достапен со внесување alt + →); тоа ви ја раскажува IP адресата и стандардното корисничко име и лозинка за инсталираниот GitLab.

  1. Екран за најавување на виртуелната машина на Bitnami GitLab. image::images/bitnami.png[The Bitnami GitLab virtual machine login screen.]

За ништо друго, следете ги упатствата во Readme Community Edition Edition, кое може да се најде на https://gitlab.com/gitlab-org/gitlab-ce/tree/master []. Таму ќе најдете помош за инсталирање на GitLab со користење на рецепти за готвачи, виртуелна машина на дигитален океан и пакети RPM и DEB (кои, од ова пишување, се во бета верзија). Исто така има и ‘` неофицијални '’ насоки за добивање на GitLab со нестандардни оперативни системи и бази на податоци, целосно рачно инсталирано скрипта и многу други теми.

Администрација

Административниот интерфејс на GitLab се пристапува преку интернет. Едноставно насочете го вашиот прелистувач до името на домаќинот или IP адресата каде е инсталиран GitLab и се најавите како администраторски корисник. Стандардното корисничко име е admin @ local.host, а стандардната лозинка е` 5iveL! Fe` (што ќе ви биде побарано да се промени веднаш штом ќе го внесете). Откако ќе се најавите, кликнете на иконата "Административна област" во менито во горниот десен агол.

  1. Објектот "Административна област" во менито GitLab. image::images/gitlab-menu.png[The “Admin area” item in the GitLab menu.]

Корисници

Корисниците во GitLab се сметки кои одговараат на луѓето. Корисничките сметки немаат многу сложеност; главно, тоа е збирка на лични информации приложени за податоците за најава. Секоја корисничка сметка доаѓа со * именски простор *, што е логично групирање на проекти кои му припаѓаат на тој корисник. Ако корисникот + jane + имал проект наречен + проект +, URL-то на проектот ќе биде http: // server / jane / project [].

The GitLab user administration screen.
Figure 47. The GitLab user administration screen.

Отстранувањето на корисникот може да се направи на два начина. ‘` Блокирање '’ корисникот ги спречува да се логираат во GitLab пример, но сите податоци под именскиот простор на тој корисник ќе бидат зачувани, а обврските потпишани со е-поштенската адреса на тој корисник сепак ќе се поврзат со нивниот профил.

Уништувањето на корисникот, од друга страна, целосно ги отстранува од базата на податоци и датотечниот систем. Сите проекти и податоци во нивниот именски простор се отстранети, и сите групи што ги поседуваат исто така ќе бидат отстранети. Ова очигледно е многу потрајна и деструктивна акција, а нејзината употреба е ретка.

Groups

Група GitLab е збир на проекти, заедно со податоци за тоа како корисниците можат да пристапат кон овие проекти. Секоја група има именски простор на проектот (на ист начин како што го прават корисниците), па ако групата + обука + има проект + материјали +, нејзиниот URL би бил http: // server / training / materials [].

The GitLab group administration screen.
Figure 48. The GitLab group administration screen.

Секоја група е поврзана со голем број на корисници, од кои секоја има ниво на дозволи за проектите на групата и самата група. Тие се движат од ‘` Guest ’ (прашања и разговор само) до `` Owner ' (целосна контрола на групата, нејзините членови и нејзините проекти). Видовите на дозволи се премногубројни за да се наведат овде, но GitLab има корисна врска на административниот екран.

Проекти

Проектот GitLab приближно одговара на едно Git складиште. Секој проект припаѓа на еден именски простор, или корисник или група. Ако проектот му припаѓа на корисник, сопственикот на проектот има директна контрола врз тоа кој има пристап до проектот; ако проектот припаѓа на група, дозволите на ниво на корисникот ќе станат ефекти.

Секој проект, исто така, има ниво на видливост, кое контролира кој има пристап до читање на страниците и складиштето на тој проект. Ако проектот е Private, сопственикот на проектот мора експлицитно да му даде пристап на одредени корисници. Проектот Internal е видлив за секој најавен корисник, а проектот _Public е видлив за секого. Забележете дека ова го контролира и пристапот "git fetch", како и пристап до веб-интерфејсот за тој проект.

Куки

GitLab вклучува поддршка за куки, како на проект, така и на системско ниво. За било која од овие, серверот GitLab ќе изврши HTTP POST со некој описен JSON секогаш кога ќе се појават релевантни настани. Ова е одличен начин за поврзување на вашите Git складишта и GitLab инстанца со остатокот од вашата автоматизација на развојот, како што се CI сервери, виртуелни простории за разговор или алатки за распоредување.

Основна употреба

Првото нешто што ќе сакате да го направите со GitLab е да создадете нов проект. Ова се постигнува со кликање на иконата "` + "на алатникот. Ќе ви биде побарано името на проектот, на кој именски простор треба да му припаѓате, и што треба да биде нејзиното ниво на видливост. Поголемиот дел од она што го наведете овде не е трајно, и може повторно да се прилагоди подоцна преку интерфејсот за поставувања. Кликнете ‘` Креирај проект '’, и ќе завршиш.

Откако проектот постои, најверојатно ќе сакате да го поврзете со локално Git складиштето. Секој проект е достапен преку HTTPS или SSH, од кои било кој може да се користи за конфигурирање на далечинско Git. УРЛ-адресите се видливи на врвот на почетната страница на проектот. За постоечко локално складиште, оваа команда ќе создаде оддалечен име gitlab на локацијата што се хостира:

$ git remote add gitlab https://server/namespace/project.git

Ако немате локална копија од складиштето, можете едноставно да го направите ова:

$ git clone https://server/namespace/project.git

Веб интерфејсот обезбедува пристап до неколку корисни погледи на самата складиште. Почетната страница на секој проект покажува неодамнешна активност, а линковите по должината на врвот ќе ве доведат до погледи на датотеките на проектот и дневникот за извршување.

Работете заедно

Наједноставниот начин на заедничко работење на GitLab проектот е давање на друг корисник директен пристап до Git складиштето. Можете да додадете корисник на проект со одење во делот "Членови" во поставките на тој проект и поврзување на новиот корисник со ниво на пристап (различните нивоа на пристап се дискутираат малку во << _ gitlab_groups_section >>). Со давање на корисник ниво на пристап на ‘` Developer '’ или погоре, тој корисник може да ги притисне обврските и филијалите директно во складиштето со неказнивост.

Друг, поделеран начин на соработка е со користење на барања за спојување. Оваа карактеристика му овозможува на секој корисник кој може да го види проектот за да придонесе кон него на контролиран начин. Корисниците со директен пристап можат едноставно да креираат гранка, да извршат притисок и да отворат барање за спојување од нивната гранка назад во господар или било која друга гранка. Корисниците кои немаат дозволи за притискање за складиштето, можат да го "вилушкаат" (создадат своја копија), притисни обврски за that copy, и да отворат барање за спојување од нивната вилушка назад кон главниот проект. Овој модел му овозможува на сопственикот да биде во целосна контрола на она што оди во складиштето и кога, притоа дозволувајќи им на придонеси од недоверливи корисници.

Барањата и прашањата за спојување се главните единици на долготрајната дискусија во GitLab. Секое барање за спојување дозволува линиска поделба на предложената промена (која поддржува лесен вид преглед на кодот), како и општа сеопфатна дискусија. Двете можат да бидат доделени на корисници, или организирани во пресвртници.

Овој дел е фокусиран главно на функциите Git поврзани со GitLab, но како зрел проект, тој обезбедува многу други функции за да му помогне на вашиот тим да работи заедно, како што се проектни викија и алатки за одржување на системот. Една корист за GitLab е тоа што, откако серверот е поставен и работи, ретко ќе треба да ја конфигурирате конфигурациската датотека или да пристапите до серверот преку SSH; најмногу администрација и општа употреба може да се постигне преку интерфејсот во прелистувачот.