github tutorial developers how use github
Tento výukový program GitHub vysvětluje, co je GitHub a jak vytvořit požadavek úložiště, větve a vyžádání. Zahrnuje pravidla ochrany poboček a řešení konfliktů:
Co je GitHub?
GitHub je cloudová služba, která vývojářům pomáhá ukládat a spravovat jejich zdrojový kód a také sledovat a kontrolovat všechny změny zdrojového kódu.
Jednoduše řečeno, GitHub je určen pro vývojáře, kde mohou spravovat projekt, hostovat zdrojový kód a také je kontrolovat. To vše prozkoumáme v této sérii.
Seznam výukových programů v této sérii GitHub:
Výukový program č. 1: Výukový program GitHub pro vývojáře Jak používat GitHub [Tento návod]
Výukový program č. 2: GitHub Projects, Teams, Fork & Wiki For Documenting Projects
Výukový program č. 3: Výukový program pro pokročilé příkazy Git a GitHub
Výukový program č. 4: Výukový program GitHub REST API - Podpora REST API v GitHubu
Výukový program č. 5: Výukový program pro GitHub pro stolní počítače - Spolupráce s GitHubem z vašeho počítače
Výukový program č. 6: Výukový program TortoiseGit - Jak používat TortoiseGit pro správu verzí
Co se naučíte:
Co je Git?
Git je systém řízení verzí Open Source, kde je celý zdrojový kód k dispozici na vývojářském stroji. Git je také systém pro správu klientů a distribuovaných verzí (DVCS), kde můžete provádět větvení a slučování.
Začínáme s GitHub
Abychom mohli začít s GitHubem, provedeme následující kroky.
- Vytvořte úložiště pro organizaci projektů.
- Vytvořte větev
- Proveďte změny v souboru a potvrďte.
- Vytvořte požadavek na sloučení ke sloučení obsahu.
- Chraňte větev
Ve druhé části série se také podíváme na další funkce GitHubu, jako je Vytváření organizací, Týmy, Problémy, Milníky, Vidličky, Vydání a Wikis.
Vytvořte úložiště GitHub
Repozitář GitHub obsahuje artefakty projektu, jako je zdrojový kód, dokumenty, obrázky atd. Vytvoříme a použijeme demo úložiště k provedení všech výše uvedených kroků.
Přihlaste se na Github.com a Vytvořte nové úložiště . Klikněte na Nový knoflík.
Přidejte níže uvedené podrobnosti repo, jak je znázorněno, a klikněte na Vytvořte úložiště . Nastavte přístup na soukromý nebo veřejný. Je lepší jej nastavit jako veřejný, protože na tomto přístupu závisí jen málo funkcí.
Poznámka: Uživatel, který vytváří úložiště, je vlastníkem úložiště GitHub.
Repozitář je vytvořen pomocí souboru README.
Přidání spolupracovníků do úložiště GitHub
Chtěli bychom, aby tým pracoval na tomto úložišti. Za tímto účelem budeme muset pozvat spolupracovníky, aby pracovali v úložišti. Chcete-li přidat spolupracovníky, přejděte na hlavní stránku úložiště a klikněte na ikonu Nastavení ikona.
Klikněte na Spolupracovníci v levém podokně a přidejte spolupracovníky, kteří mají účet Github. Byla by odeslána pozvánka a spolupracovníci by ji museli přijmout.
Spolupracovníci se přidávají, jak je uvedeno níže. Později v tomto kurzu uvidíme, jak se přidají spolupracovníci jako recenzent pro požadavek vyžádaného vytvoření vytvořeného ke sloučení kódu.
Provedení základního C. vynechat
Otevřete soubor README a proveďte základní potvrzení. Klikněte na Upravit ikonu zahájíte úpravu souboru.
Upravte soubor, přidejte komentář a klikněte na Spáchat .
Soubor je potvrzen (změny uloženy) do úložiště Github.
Zobrazí se několik operací k vytvoření složky a souborů uvnitř úložiště.
Vytvoření složky a souboru v rámci: Klikněte na Vytvořit nový soubor tlačítko na úrovni úložiště. Zadejte název adresáře, za ním / a název souboru, jak je uvedeno níže.
Klikněte na Spáchat dole. Složka a soubor jsou vytvořeny podle obrázku. Soubory a složky se tedy vytvářejí na serveru mistr větev, která je hlavní integrační větví, a většinou tam, kde lze vytvářet verze softwaru.
Vývojáři obvykle pracují na úkolu, který jim byl přidělen, na samostatné větvi a slučují změny do hlavní větve. Například, větve mohou být vytvořeny pro vývoj funkcí nebo řešení chyb nebo práci na vylepšení atd. Vytvořením větve je tedy práce izolována, aniž by rušila ostatní větve.
V dalším kroku se můžeme podívat na to, jak lze vytvořit větve a definovat požadavky na vyžádání, aby se zkontroloval a sloučil kód do hlavní větve.
Přesunutí souboru
Chcete-li přesunout soubor do jiné složky, proveďte následující kroky. Například, přesunout soubor rules.txt do složky doc. Klikněte na soubor.
Kliknutím na ikonu upravte soubor.
Přidejte cestu doc / před souborem rules.txt . Klikněte na Potvrdit změny.
Cesta je nyní aktualizována.
Vytvoření větve GitHub
Přejít na hlavní stránku úložiště a zadejte vytvořit Vlastnosti větev, jak je znázorněno. Klikněte na Vytvořit větev.
Nyní jsme v Vlastnosti větev. Soubory jsou stejné. Nyní provedeme několik změn v souborech v souboru Vlastnosti větev a vytvořte žádost o stažení, abyste zkontrolovali změny a sloučili kód do mistr větev.
Proveďte změny v souborech ve větvi funkcí.
Otevřete soubor Java ve složce Src, přidejte nějaký kód a potvrďte změnu.
Vytvořte požadavek na stažení GitHub
V předchozí části jsme vytvořili větev Vlastnosti a provedl nějaké změny v souboru. Změny nejsou v mistr větev. K tomu musíme vytvořit požadavek na vyžádání, kterým uživatel navrhuje určité změny, které mají být zkontrolovány a sloučeny do mistr větev.
Vytvoření požadavku na vyžádání zobrazí rozdíly mezi zdrojovou a cílovou větví a bude vyžadováno k vyřešení konfliktů, pokud existují.
Klikněte na Porovnat a vytáhnout žádost na hlavní stránce úložiště.
Vidíte, že změny v obou větvích lze sloučit. Klikněte na Vytvořit požadavek na vytažení.
Klikněte na Sloučit požadavek na vytažení a Potvrdit dokončit sloučení.
Změny byly úspěšně sloučeny do mistr větev. Náš první požadavek na vytažení je úspěšně dokončen.
Přiřaďte recenzenty žádostmi o stažení a kontrolou kódu
Github má dobrou vlastnost použití souboru CODEOWNERS, ve kterém můžeme vybrat osoby odpovědné za zdrojový kód v úložišti. Vlastníci úložiště mohou tento soubor vytvořit a všichni uživatelé definovaní v souboru jsou ve výchozím nastavení požadováni pro kontrolu během vytváření požadavku na vyžádání.
Chcete-li použít tuto funkci, musíte použít verzi GitHub Pro nebo nastavit úložiště jako veřejné.
V kořenovém adresáři úložiště vytvořte tento soubor v následujícím formátu a potvrďte soubor.
* @username nebo @orgname nebo @teamname
* primárně znamená všechny soubory v repo. Můžete také určit konkrétní přípony jako * .java nebo * .js atd. Uživatelům definovaným v souboru bude automaticky zaslán požadavek na kontrolu. S definovaným souborem CODEOWNERS není nutné explicitně přidávat recenzenty ručně a má trochu větší flexibilitu při výběru souborů, které mají být zkontrolovány.
Zpátky v Vlastnosti větev proveďte malou změnu v souboru Java a vytvořte požadavek Pull. Na obrazovce Pull Request přiřaďte recenzenta na pravé straně. Klikněte na Vytvořit požadavek na vytažení.
Na výše uvedené obrazovce vidíte, že recenzenty lze přiřadit ručně, ale recenzenti jsou definováni v souboru CODEOWNERS, kteří automaticky obdrží požadavek na kontrolu změn kódu.
Každopádně zatím přihlásit se jako recenzent a schválit změny. Chcete-li změny schválit, přihlaste se jako uživatel vniranjan2512.
Pod položkou je požadavek na schválení / odmítnutí změn Pull Request.
Klikněte na Pull Request a Přidejte svoji recenzi.
Můžete kliknout na + podepište a přidejte komentáře k recenzi kódu přidaného / upraveného / odstraněného na obrazovce, která se objeví.
Klikněte na Zahájit kontrolu.
Klikněte na Dokončete svou recenzi. Schválit podle obrázku a Odeslat recenzi .
Zpět jako původní uživatel, který vznesl požadavek na vyžádání, můžete přidat komentář a konverzaci vyřešit nebo zavřít.
Nyní lze požadavek na sloučení sloučit.
Změny jsou úspěšně sloučeny do mistr pobočka po kontrole a sloučení požadavku na stažení.
Stručně řečeno, v této fázi jsme viděli, že vývojáři pracují na Vlastnosti větev a poté vznesením požadavku na vytažení sloučit změny do mistr větev. Výše uvedený byl scénář, kdy konflikty nebyly. V další části uvidíme způsoby, jak konflikty vyřešit ručně, pokud se soubory změní ve více větvích.
Řešení konfliktů
Je možné, že by byly změněny stejné soubory ve více větvích. V tomto případě by došlo ke konfliktům a musí být vyřešeno prostřednictvím vzneseného požadavku na vytažení.
Například, provést změny v souboru Java v obou mistr a Vlastnosti větve a vznést požadavek na tah.
Zobrazená zpráva s požadavkem na vyžádání je, že změny nelze automaticky sloučit. Proto musí být konflikty vyřešeny. Pokračujte vytvořením požadavku na vytažení.
Po vznesení požadavku na vytažení bude nutné konflikty vyřešit kliknutím na ikonu Vyřešte konflikty knoflík.
Odstraňte označení, která v zásadě řeší konflikty ručně, a klikněte na Označit jako vyřešené a Potvrdit sloučení.
Konečné zobrazení souboru po odstranění označení.
Lze dokončit požadavek na sloučení. The mistr a Vlastnosti větve budou nyní identické.
Na výše uvedené obrazovce stále vidíte, že je kontrola požadována, ale není nařízena. V další části uvidíme pravidla ochrany větví, kde vlastník úložiště může povinně požadovat kontrolu a také chránit mistr větev od spáchání přímo k ní, ale pouze prostřednictvím požadavku na vytažení.
Pravidla ochrany poboček
V předchozích částech jsme viděli požadavky Github Pull a také žádosti o kontroly, které nebyly nařízené nebo volitelné. V kódu typických scénářů projektu jsou recenze nutností a součástí procesu vývoje.
Uvidíme, jak to vynutit.
Na github.com lze tuto funkci nastavit pouze pro veřejná úložiště nebo pomocí verze Github pro. Na hlavní stránce úložiště přejděte na Nastavení a klikněte na Pobočky kategorie vlevo.
Klikněte na Přidat pravidlo pod Pravidla ochrany poboček. Pravidlo přidalo požadavky na povinné kontroly vyžádaných vyžádání od vlastníků kódu před sloučením pro mistr větev.
To také zajistí, že hlavní větev je chráněn a v této větvi nelze provádět žádné přímé závazky a lze jej provést pouze prostřednictvím požadavků na vyžádání po důkladné kontrole. Toto nastavení je nastaveno vlastníkem úložiště.
Skvělá vlastnost opravdu !!!
Klikněte na Vytvořit jednou hotovo. Chcete-li tento scénář otestovat, proveďte změnu souboru v souboru Vlastnosti větev a vytvořte požadavek na vytažení.
Následující obrazovka ukazuje, že vlastníci kódu povinně vyžadují kontrolu.
Odeslat recenzi od vlastníků kódu lze požadavek na sloučení sloučit.
Jako spolupracovník úložiště, pokud provedete změny v některém ze souborů, kvůli vytvořeným pravidlům chráněných větví se nebudete moci zavázat přímo k hlavní větvi, ale pouze prostřednictvím požadavku Pull po vytvoření větve, jak je znázorněno níže.
Přenos úložiště na jiný uživatelský účet
Normálně má osobní úložiště uživatelů jednoho vlastníka a všichni ostatní jsou spolupracovníci. Takže v tom smyslu, že v úložišti uživatelského účtu nemůžete mít více vlastníků. Vlastnictví však lze převést na jiný uživatelský účet. Po dokončení se z původního vlastníka úložiště automaticky stanou spolupracovníci v novém úložišti uživatelských účtů.
Nový vlastník pak může začít spravovat artefakty, problémy, žádosti o vyžádání, projekty, vydání a nastavení.
Normálně, když jsou v místním úložišti prováděny příkazy jako „git clone“ nebo „git push“, budou příkazy přesměrovány do nového úložiště. Když ale spustíte příkaz „git remote -v“, bude se stále zobrazovat původní adresa URL úložiště. Abyste předešli nejasnostem při změně na novou vzdálenou adresu URL, odešlete přenos úložiště pomocí příkazu „git remote set-url“.
Chcete-li přenést úložiště, přejděte na kartu Nastavení úložiště a v části Možnosti? Danger Zone klikněte na Převod
Zadejte název úložiště a nový uživatelský účet, na který musí být vlastnictví převedeno.
Klikněte na Rozumím, přeneste toto úložiště
Měla by se zobrazit zpráva, že úložiště je přeneseno na nového vlastníka.
Původnímu vlastníkovi úložiště bude zaslán e-mail se schválením přenosu. Po schválení přenosu bude úložiště převedeno na nového vlastníka a původní vlastník úložiště bude přidán jako spolupracovník.
Nyní nastavte adresu URL nového úložiště ve stroji, kde bylo klonováno staré úložiště. Následující příkazy je třeba nastavit na všech počítačích, kde bylo klonováno staré úložiště.
Všechny žádosti o stažení, problémy, wiki budou přeneseny. Přiřazení čísel zůstanou nedotčena.
Některé užitečné příkazy Git
Po instalaci klienta Git na počítači se systémem Linux nebo Windows je třeba nejprve nakonfigurovat některé základní příkazy Git na místním počítači. Vývojáři pracují lokálně, bez připojení k úložišti na GitHubu, na úplné kopii zdrojového kódu dostupného na GitHubu a synchronizují se s ním.
Nejprve nastavte své uživatelské jméno a e-mailovou adresu, abyste zajistili, že všechny závazky, které používáte, tyto informace používají.
git config –global user.name „UserName“
git config –global user.email „myemail@myemail.com“
Pokud potřebujete přidat zprávu během revizí, můžete také nakonfigurovat editor, který je pro ni nezbytný.
git config - globální poznámkový blok core.editor
Získejte seznam všech nastavených hodnot konfigurace.
git config –list
Někdy mají organizace proxy servery pro připojení k internetu. V takovém případě budete muset zadat proxy server a číslo portu pro přístup ke všem úložištím na GitHubu.
git config –globální http.proxyhttp: // Uživatelské jméno: Heslo @ proxyserver: port
Naklonujte nebo vytvořte místní kopii úložiště. Získejte klonovanou adresu URL úložiště v GitHubu a spusťte příkaz git.
Závěr
V tomto kurzu jsme viděli, jak může vývojář začít pracovat na GitHubu, a to hned od vytvoření úložiště GitHub, větve, požadavku na vytažení, ochrany větve a některých základních příkazů Git.
V našem nadcházejícím tutoriálu uvidíme další funkce GitHubu hlavně o tom, jak vytvářet organizace, týmy, rozdvojovat úložiště, vytvářet problémy, milníky a přidružení k žádostem o stažení, wiki a jejich použití a několik dalších pokročilých příkazů Git, které budou užitečné vývojářům.
nejlepší herní společnosti, pro které pracujeme
Doporučené čtení
- Výukový program Java Reflection s příklady
- Git vs GitHub: Prozkoumejte rozdíly pomocí příkladů
- Výukový program Python DateTime s příklady
- Integrace selenu s GitHub pomocí Eclipse
- Rychlý průvodce SoapUI pro ukládání dat požadavků a odpovědí do souboru - SoapUI Tutorial # 15
- Výukový program Bugzilla: Výukový program pro správu defektů
- 20+ výuka MongoDB pro začátečníky: bezplatný kurz MongoDB
- Výukový program pro sdílení dat MongoDB s příkladem