Tento návod je určený pre tých, čo už o Gite čo-to vedia a potrebujú sa zorientovať v nami ponúkanej službe. Pre úplných začiatočníkov do problematiky version control a Gitu špecifickejšie existuje viacero zdrojov informácii, odporúcame napríklad http://git-scm.com/book/cs
Vytvorenie GIT konta
Git konto bude previazané s vaším užívateľským kontom, ktorým sa prihlasujete do Webadminu. Vytvoríte ho navštívením sekcie Bonusy, pod ktorým nájdete tlačidlo “spravovať git repozitáre” – pri prvej návšteve môžete zadať nové prihlasovacie údaje, po ich potvrdení vás prehliadač nasmeruje na konfiguráciu prvého SSH kľúča (tento krok môžete preskočiť a kľúče pridať neskôr buď pomocou “nášho” UI alebo priamo v GitLab-e).
Z adresy noreply@websupport.sk vám prídu dva e-maily: jeden z nich bude obsahovať link, ktorým je nutné potvrdiť registráciu vášho Git účtu.
Vytvorenie SSH kľúča
Pokiaľ máte poruke Linuxácku konzolu a náhodou ešte nemáte vygenerovaný svoje SSH kľúče, môžete ich vytvoriť príkazom ssh-keygen (verejný kľúč je defaultne uložený v ~/.ssh/id_rsa.pub).
Pod Windows môžete SSH kľúč vygenerovať s pomocou utility puttygen.
Vytvorenie projektu
Po kliknutí na “Vytvoriť nový projekt” budete vyzvaní na zadanie mena nového projektu(repozitáru).
Globálne nastavenie GITu
git config –global user.name „John Smith“
git config –global user.email „john.smith@nist.gov“
Vytvorenie nového repozitáru
mkdir moj_repozitar
cd moj_repozitar
git init
touch README
git add README
git commit -m ‚first commit‘
git remote add origin git@gitlab.websupport.sk:<ucet>/<repozitar>.git
git push -u origin master
Import existujúceho repozitáru
cd moj_repozitar
git remote add origin git@gitlab.websupport.sk:<ucet>/<repozitar>.git
git push -u origin master
Repozitáre je samozrejme možné vytvárať aj priamo v Gitlabe.
Správa repozitárov
Správa prebieha v prostredí Gitlab na adrese https://gitlab.websupport.sk/ – užívatelia Githubu a Bitbucketu by sa tu mali cítiť ako doma. Tu prebehneme len základnú funkcionalitu, ale podrobnú dokumentáciu nájdete na adrese https://gitlab.websupport.sk/help.
Horná lišta ponúka prístup k
- dashboardu – prehľad posledných správ o commitoch, merge requestoch, nových developeroch
- vyhľadávaniu – názvy repozitárov, súborov, či fulltextové vyhľadávanie v zdrojovom kóde
- zoznamu verejne prístupných repozitárov
- vlastnému pastebinu
- vytvoreniu nového repozitáru
- nastaveniu Git profilu (bez avataru ani na krok!)
FAQ
Môžem vytvoriť viacero Git užívateľov?
Jeden Ws účet môže mať namapovaný práve jeden Git účet, ale v sekcii Užívatelia je možné vytvoriť nový WS účet – pamätajte ale, že nový účet má rovnaké práva ako vy.
Nemôžem sa prihlásiť, čo teraz?
Pokiaľ ste zabudli svoje heslo, na https://gitlab.websupport.sk/users/sign_in si môžete vyžiadať zaslanie e-mailu s inštrukciami pre vyresetovanie svojho hesla. Pokiaľ ste omylom zmazali “confirmation” e-mail s linkom pre potvrdenie registrácie vášho Git účtu, je tu možnosť nechať si ho zaslať opätovne.
Koľko projektov mám možnosť vytvoriť?
S jedným účtom môžete vytvoriť 10 jedinečných projektov
Koľko priestoru môžem využiť?
S jedným účtom môžete využiť maximálne 10GB priestoru
Koľko top-level groups mám možnosť vytvoriť?
Maximálny počet top-level groups je 10