13. diel - Git - Vzdialený repositár - Vytvorenie a nastavenie repositára
V predchádzajúcom kvíze, Kvíz - Git, sme si overili nadobudnuté skúsenosti z kurzu.
V dnešnom Git tutoriále budeme pokračovať v práci so vzdialeným repositárom. Na platforme GitHub vzdialený repositár vytvoríme a ukážeme si jeho dôležité nastavenia vrátane vytvorenia Issue, odkazu a prístupu pre užívateľov.
Vytvorenie vzdialeného repositára na platforme GitHub
Než budeme môcť nahrať náš lokálny repositár do vzdialeného repositára na platforme GitHub, musíme si vzdialený repositár najskôr vytvoriť. Nový repositár vytvoríme kliknutím na tlačidlo + a výberom New repository:
Po kliknutí na možnosť New repository budeme presmerovaní na túto stránku vytvorenie repositára:
Názov a popis repositára
Do poľa Repository name vložíme názov nášho repositára
mujgit. Do poľa Description vložíme krátky popis
repositára Testovací repositář.
Viditeľnosť repositára
Ďalej máme k dispozícii dve možnosti pre viditeľnosť repositára:
- Public – repositár je verejne prístupný pre všetkých,
- Private – repositár je súkromný a prístup majú iba vybraní užívatelia, ktorým je povolený prístup.
README.md,
.gitignore súbory a licencie
Ak by sme zvolili možnosť Add a README file, vytvoril by sa v
repositári súbor README.md. Túto voľbu ponecháme prázdnu.
Súbor README.md je obvykle umiestnený v
koreňovom adresári repositára a slúži na poskytnutie užitočných
informácií o projekte, aplikácii alebo repositári.
Podobne možnosť Add .gitignore by vytvorila súbor
.gitignore z preddefinovaných šablón. Túto voľbu necháme
predvyplnenú na None. Nakoniec je nám voľbou Choose a
license poskytnutá možnosť vybrať pre repositár licenciu. Ponecháme
None.
Vyplnený formulár založenia repositára vyzerá nasledovne:
Teraz už len klikneme na tlačidlo Create repository. Na stránke bude zobrazený novo vytvorený repositár so všetkými zadanými informáciami:
Na tejto stránke nám GitHub ponúka možnosť prepojenia GitHub
Copilot s naším repositárom, pridať ďalších
užívateľov k nášmu repositárovi a poskytuje ďalšie informácie
pre prácu s naším repositárom mujgit.
Nastavenie vzdialeného repositára
U nášho repositára mujgit si ukážeme nastavenie:
- sekcia Issue,
- odkazu,
- prístupu pre užívateľov,
- ďalšie nastavenia.
V každom repositári je k dispozícii možnosť vytvárať tzv.
Issue. V rámci Issue majú vývojári aktívny priestor pre
diskusiu a prezentáciu rôznych prístupov a návrhov na riešenie daného
problému.
My si teraz takú Issue vytvoríme. V hornom menu nášho repositára
mujgit klikneme na možnosť Issues:
Otvorí sa nám stránka s Issues. Nové Issue vytvoríme kliknutím na New Issue:
Po kliknutí na New Issue sa presunieme na stránku tvorby nového
Issue. Tu nové Issue pomenujeme Testovací issue a do poľa
Add a description vložíme popis problému:
Repositář je prázdný:
Pre efektívne pomenovanie Issue je kľúčové využitie stručného a špecifického popisu, zahrnutie kľúčových slov pre jasnejší popis obsahu problému alebo úlohy.
Potom klikneme na tlačidlo Submit new Issue. Budeme presunutí na detailnú stránku Issue:
Na stránke vidíme kompletný opis Issue vrátane jeho vytvorenia a
možností diskusie. Majiteľ repositára má možnosť
uzavrieť či odstrániť Issue.
Opätovným kliknutím na Issues v hornom menu uvidíme všetky Issues
vytvorené pre náš repositár:
Odkaz
Ďalšou možnosťou v nastavení je vytvorenie odkazu z nášho lokálneho repositára na repositár vzdialený. Tento odkaz je nutný pre pripojenie sa z lokálneho repositára na vzdialený repositár, aby sme do neho mohli nahrať súbory.
Zoznam odkazov na vzdialených repositárov vyvoláme príkazom
git remote. Bez parametrov zobrazí zoznam všetkých odkazov. Ak
je repositár naklonovaný, bude už obsahovať odkaz na zdroj s názvom
origin, z ktorého repositár pochádza. Týchto odkazov by sme si
mohli vytvoriť ľubovoľné množstvo. Na vzdialenom repositári môže
existovať viac vetiev. K konárom na serveri pristupujeme cez odkaz. Zoznam
vetiev na serveri získame príkazom
git remote show <název-zdroje>.
Presuňme sa do nášho naklonovaného repositára laravel. V
ňom spustíme príkaz git remote, ktorým získame tento výstup,
ktorý sme si popísali vyššie:
V repositári
laravel teraz spustíme príkaz
git remote show origin, ktorým získame nasledujúci výstup:
Pod
Remote branches: vidíme zoznam vzdialených
vetiev. Tieto vetvy sú nezávislé na lokálnom repositári, a preto
sa teda musíme na ne odkazovať takto: Pred názov vzdialenej vetvy napíšeme
meno jej zdroja a lomítko. Napríklad, ak chceme pristúpiť
na vetvu middleware zo zdroja origin, použijeme
príkaz git checkout origin/middleware.
Mohli by sme mať niekoľko zdrojov vychádzajúcich z jedného repositára. V tom prípade by sme mali vetvu:
master, v ktorej práve pracujeme,PuvodniRepositar/master,PrvniZdroj/master,TretiZdroj/master.
Vytvorenie odkazu na vzdialený repozitár
Teraz si vytvoríme odkaz na náš vzdialený repositár. Z naklonovaného
repositára laravel sa presunieme späť do nášho vzdialeného
repositára mujgit.
Odkaz sa tvorí príkazom git remote vo formáte
git remote add <název-zdroje> <url repositáře>. Url
nášho vzdialeného repositára mujgit získame zo sekcie
Quick setup repositára mujgit. V tejto sekcii si
vyberieme protokol HTTPS az pravého poľa si skopírujeme do
schránky odkaz k nášmu repositárovi:
Teraz sa presunieme do nášho lokálneho repositára laravel, v
ktorom si vytvoríme odkaz na vzdialený repositár mujgit
nasledujúcim príkazom:
V prípade
protokolu SSH by bol príkaz nasledujúci:
git remote set-url origin [email protected]:testovaciUser/mujgit.git
Ak by sme chceli odkaz zmazať, použili by sme príkaz
git remote remove <název-zdroje>.
Prístup pre užívateľov
GitHub umožňuje zdieľanie prístupu k nášmu repositárovi s viacerými užívateľmi. To znamená, že ak pracujeme na projekte s viacerými vývojármi, môžeme ich pozvať a povoliť im prístup k nášmu repositárovi.
Nastavenie prístupu nájdeme v možnosti Collaborators:
Nového užívateľa by sme pridali kliknutím na možnosť Add people a vyplnením tohto formulára:
Ďalšie nastavenia
K ďalším nastaveniam repositára sa dostaneme cez možnosť Settings nachádzajúce sa v ponuke nad repositárom:
Tu by sme mohli upraviť rôzne nastavenia repositára, ako jeho názov, hlavná vetva, upraviť prístupové práva či nastaviť oprávnenia pre ďalších užívateľov. V Settings nájdeme aj túto Danger Zone:
Na obrázku vidíme:
- Change repository visibillity – zmení viditeľnosť repositára,
- Disable branch protection rules – odstráni ochranu vetvy,
- Transfer ownership – zmení vlastníka repositára,
- Archive this repository – označí tento repositár ako archivovaný a iba na čítanie,
- Delete this repository – zmaže repositár.
mujgit ponecháme na prácu v
ďalších lekciách.V budúcej lekcii, Git - Vzdialený repositár - Práca s repositárom , si ukážeme, ako na vzdialený repositár nahrať súbory, ako z neho stiahnuť aktualizácie a ako uzavrieť jeho Issue.
