Co je Github, jak jej používat, jak vytvořit projekt, spravovat a konfigurovat

Co je GitHub, proč je potřeba a jak GitHub používat, jak službu začít používat – průvodce pro začátečníky.
GitHub je jednou z nejoblíbenějších služeb pro hostování open source repozitářů. Stránka umožňuje publikovat vlastní projekty a sledovat změny provedené v každé iteraci. Ostatní uživatelé GitHubu si mohou uživatelský kód prohlédnout a navrhnout vlastní změny. Tato definice poskytuje pouze stručné pochopení. Funkčnost služby však není omezena pouze na toto. V tomto recenzním článku se na Github podíváme podrobněji.

Co je GitHub a jak začít – průvodce pro začátečníky

GitHub je online portál, kam mohou vývojáři a programátoři nahrávat kód, který vytvořili, a spolupracovat na jeho vylepšení. Charakteristickým znakem GitHubu je jeho robustní systém správy verzí. Kontrola verzí umožňuje programátorům přizpůsobit software, aniž by došlo k ohrožení samotného softwaru. Navrhované změny lze snadno sloučit do úplné verze, ale pouze po kontrole a schválení všech změn.

Git a GitHub – jaký je rozdíl, první seznámení s Git a GitHub

Co je Git?

Odpověď: Rychlý a škálovatelný systém správy verzí . Git je bezplatný a otevřený systém distribuovaného řízení revizí navržený tak, aby byl rychlý a efektivní pro jakýkoli projekt, od malých po velmi velké.

Co je GitHub?

Odpověď: výkonná cloudová služba pro správu soukromého vývoje a open source projektů.

Jaký je hlavní rozdíl?

Git je plnohodnotný software v kategorii systému správy verzí, který se instaluje na osobní počítač uživatele. Git umožňuje provádět změny v kódu prostřednictvím příkazového řádku (Microsoft PowerShell) a GitHub poskytuje možnost ukládat projekty ve veřejném přístupu.

Zajímavá fakta o Githubu

1. Maximální počet uživatelů na webu v loňském roce (podle statistik k 24. červenci 2021) byl 45 milionů lidí.
2. V roce 2018 Microsoft koupil GitHub za 7,5 miliardy dolarů.
3. Na Githubu je open source git repozitář. Kdokoli v něm může provádět změny. Projekt je dostupný na odkazu – https://github.com/git/git?ref=stackshare

Funkce Github

1. Možnost integrace s nejoblíbenějšími platformami a službami – Amazon, Google Cloud a Code Climate.
2. Podpora více než 200 programovacích jazyků.
3. Vysoká míra konsolidace a „cechovní solidarity“. Když uživatel publikuje svůj projekt na GitHubu, zbytek programátorské komunity si může stáhnout a ohodnotit práci, kvalitu kódu a míru jeho propracovanosti. Uživatelé třetích stran mohou vlastníka projektu varovat před možnými problémy, proměnnými konflikty atd.

Jak GitHub funguje, funkce

Tři z nejdůležitějších funkcí Github jsou větvení, požadavky na stahování a slučování. Vyplatí se zvážit každou funkci zvlášť.

Rozvětvení

Rozvětvení projektu vytváří kopii (fork), která uživateli umožňuje volně experimentovat bez ovlivnění původního projektu. Vytvářejte forky a požadavky na stahování: https://youtu.be/nT8KGYVurIU

Vytáhněte požadavky

Požadavek na stažení je publikován vývojářem poté, co dokončí práci na opravě/změně kódu. Vlastník projektu si přitom může sám prohlédnout provedené změny a položit případné doplňující dotazy.

Sloučení

Poté, co vlastník žádost o stažení schválí, sloučí žádost o stažení a aplikují změny z rozvětveného projektu na zdrojový kód.

Průvodce – jak začít v Githubu od nuly

Tato příručka je ideální pro všechny začátečníky, kteří se teprve začínají učit Git a Github. Následující kroky vám pomohou vytvořit optimální systém pro práci s tímto softwarem. Dozvíte se, jak provést změny v kódové základně, otevřít požadavek na stažení (vytvořit požadavek na stažení) a sloučit kód do hlavní větve. Pojďme tedy začít.

Krok 0Nainstalujte Git a vytvořte si účet GitHub

1. Přejděte na oficiální web Git: https://git-scm.com/downloads
2. Kliknutím na odkaz stáhněte počítačovou verzi Git pro Windows a počkejte na dokončení stahování.
3. Rozbalte a spusťte instalační program Git poklepáním na soubor Git.exe.
4. Umožněte aplikaci provádět změny v počítači kliknutím na tlačítko “Ano” v dialogovém okně “Řízení uživatelských účtů”, které se otevře.
5. Spusťte proces instalace Git. Přečtěte si hlavní dokument GNU Public License a klikněte na Další.
6. Zadejte umístění pro instalaci programu nebo ponechte výchozí hodnoty. Program vás vyzve k vytvoření složky nabídky Start. Přeskočte tuto položku.
7. Vyberte textový editor, který chcete používat s Git. V rozevíracím okně vyberte Poznámkový blok ++ (nebo jakýkoli jiný textový editor, se kterým jste dříve pracovali) a klikněte na „Další“.
8. Zadejte název nové větve projektu. Výchozí hodnota je “master”. Doporučuje se ponechat toto nastavení ve výchozím nastavení.
9. V možnostech výběru PATH, SSH klienta, certifikátů serveru, zakončení řádků a terminálu nechte vše tak, jak je, a klikněte na tlačítko “Další”.
10. Ponechte všechna výchozí nastavení a začněte instalovat program.
11. Po dokončení instalace zaškrtnutím políček zobrazte poznámky k verzi a spusťte Git Bash. Zavřete okno instalačního programu.

Účet na Github si můžete zaregistrovat pomocí následujícího odkazu: https://github.com/join. Chcete-li to provést, musíte zadat základní registrační údaje potřebné v budoucnu k ověření účtu.

Krok 1: Spusťte Git a vytvořte první místní úložiště

Git má dva režimy použití – bash (Git Bash) a grafické uživatelské rozhraní (Git GUI). Chcete-li spustit Git Bash, otevřete nabídku Start – Windows, napište git bash a stiskněte Enter (nebo dvakrát klikněte levým tlačítkem myši na zástupce programu). Chcete-li spustit GIT GUI, otevřete nabídku Start – Windows, napište git gui a stiskněte Enter. V našem případě použijeme Git Bash.
Vytvoření nového projektu v Git Bash zahrnuje použití speciálních příkazů k inicializaci nového úložiště. Nejprve musíte otevřít terminál Bash kliknutím pravým tlačítkem myši na plochu a poté v rozevírací nabídce Git Bash Here. V okně terminálu na místním počítači vytvořte nový testovací adresář (složku) zadáním následujícího:
getrekt:Desktop getrekt $ cd ~/Desktop
getrekt:Desktop getrekt $ mkdir
myproject getrekt:Desktop getrekt $ cd myproject/
Příkaz mkdir vytvoří novou složku lokálního projektu. Vytvořte naše první úložiště Github: https://youtu.be/yHCUc6cmhcc

Krok 2. Vytvořte nový soubor v úložišti

Ve složce projektu přidejte pomocí dotykového příkazu nový textový soubor. Standardním způsobem příkaz vytvoří prázdný textový soubor, který bude mít příponu .txt.

Pozornost! Git ukládá/spravuje změny pouze u souborů, které sleduje. Po vytvoření nového souboru může uživatel sledovat jeho stav pomocí příkazu git status. Konzole zobrazí seznam souborů, které se nacházejí v úložišti.

Jakmile přidáte soubor do složky obsahující úložiště git, program si všimne změny v projektu. Automatické sledování však nebude povoleno, k tomu musíte použít speciální příkaz – git add.
getrekt:můjprojekt getrekt $ touch getrekt.txt
getrekt:můjprojekt getrekt $ ls
getrekt.txt

Krok 3: Přidejte soubor do pracovního prostředí sledování

Přidejte soubor do pracovního prostředí pomocí příkazu git add.
getrekt:myproject git add . Tímto příkazem program spustí automatické sledování všech souborů, které budou vytvořeny ve složce projektu. Můžete zkontrolovat, zda příkaz funguje se stavem git. Takto vypadají protokoly na příkazovém řádku Git Bash po zadání stavu git:
getrekt: getrekt getrekt$ stav git
Na hlavním serveru větve
Počáteční potvrzení
Změny, které mají být potvrzeny:
(pro zrušení fáze použijte “git rm –cached …”) Byl
přidán nový soubor
Nový název souboru: getrekt.txt
nový soubor: getrekt.txt Komentář k protokolu: Soubor ještě nebyl potvrzen, ale bude přidán.

Krok 4 Vytvořte potvrzení

Commit je kontrolní bod každého úložiště. Jednoduše řečeno, balíček změn, který uchovává informace o přidaných, upravených nebo smazaných souborech, které ukládají určitý kód.
getrekt:myproject getrekt $ git commit -m “MŮJ PRVNÍ COMMIT GUYS!”
[master (root-commit) b345d9a] MŮJ PRVNÍ ZÁVAZEK!
1 soubor změněn, 1
režim vytvoření vložení(+) 100644 getrekt.txt

Příkaz k vytvoření potvrzení je git commit -m “Název potvrzení”.

Pozornost! Zpráva na konci příkazu by měla být smysluplná a srozumitelná pro ostatní vývojáře projektu. Nepojmenujte své commity jako „asdfadsf“ nebo „foobar“. Jinak nikdo nic nepochopí a budete muset strávit spoustu času jejich mazáním.

Krok 5. Vytvořte novou větev nová větev

Nová větev je plnohodnotnou větví projektu, která se skládá z celé sady commitů. Představuje samostatnou verzi produktu, ale v rámci systému správy verzí. Větve umožňují uživateli pohybovat se mezi “stavy” projektu.

V oficiální dokumentaci git je popis větví: “Pobočka v Gitu a Github je pohyblivý ukazatel na jeden z repozitářů.”

Pokud by například uživatel chtěl na svůj web přidat novou stránku, mohl by vytvořit novou větev pouze pro tuto konkrétní stránku, aniž by to ovlivnilo hlavní část projektu. Jakmile s tím skončí, může sloučit změny ze své větve do té hlavní. V případě nové větve Git sleduje, ze kterého commitu se větvil.
Po provedení příkazu můžete do konzole zadat git branch pro potvrzení vytvoření větve:
getrekt:myproject getrekt $ git branch
master
* my-new-branch Název my-new-branch s hvězdičkou označuje, kterou větev uživatel je aktuálně zapnuto.

Poznámka: Ve výchozím nastavení se úplně první větev každého git repo jmenuje “master” (a obvykle se používá jako hlavní v projektu). V rámci boje proti rasismu začali někteří vývojáři používat alternativní názvy výchozí větve, například „primární“. Častěji však uživatelé mohou vidět „master“ nebo podobná jména, která se na něj používají.

Stojí za to mít na paměti, že téměř každý repozitář má hlavní větev, kterou lze považovat za oficiální verzi projektu. Pokud se jedná o web, pak větev je verze, kterou uživatelé vidí. Pokud se jedná o aplikaci, pak hlavní větev je vydání, které si uživatelé nainstalují do svého počítače nebo mobilního zařízení. Takto funguje tradiční verzování produktů Git a Github. Oficiální stránka má podrobnější dokumentaci o používání různých výchozích názvů větví. Informace jsou dostupné na Github na https://github.com/github/renaming
V případě návratu k větvi projektu a vytvoření více odevzdání nebude nová větev sledována systémem správy verzí, dokud uživatel nenapíše automatické sledování. .

Krok 6 Vytvořte nové úložiště GitHub

Tento krok není vyžadován, pokud chcete svůj kód sledovat pouze lokálně. Pokud ale pracujete v týmu a přijímáte změny od ostatních programátorů, pak můžete využít aktuální možnosti GitHubu ke společné změně kódu projektu. Chcete-li vytvořit nové úložiště na GitHubu, musíte se přihlásit do systému a přejít na hlavní stránku webu. Z hlavní nabídky klikněte na tlačítko „Nové úložiště“, které se nachází pod znaménkem „+“ vedle profilové fotografie v pravém horním rohu navigační lišty: Po kliknutí na tlačítko se GitHub zeptá vlastníka projektu pojmenujte úložiště a uveďte krátký popis:
Dále klikněte na tlačítko “Vytvořit úložiště” pro potvrzení vytvoření nového projektu. Zobrazí se dialogové okno s dotazem uživatele, zda chce vytvořit úložiště od začátku nebo přidat existující lokálně vytvořené. V druhém případě je potřeba nahrát složku projektu na Github.

Pozornost! Stažení lokálního úložiště může také proběhnout pomocí příkazového řádku a konkrétněji příkazů git remote add origin github_url (vytvoří záznam o novém připojení ke vzdálenému úložišti), git push -u origin master (naváže spojení mezi pobočkami v ve kterém se nachází vývojář a hlavní větev na vzdáleném serveru).

Takto vypadají protokoly na příkazovém řádku Git Bash:
getrekt:myproject getrekt $ git remote add origin https://github.com/cubeton/mynewrepository.git
getrekt:myproject getrekt $ git push -u origin master
Počítání objektů: 3, hotovo.
Zápis objektů: 100 % (3/3), 263 bajtů | 0 bajtů/s, hotovo.
Celkem 3 (delta 0), znovu použito 0 (delta 0)
Do https://github.com/cubeton/mynewrepository.git
* [nová větev] master -> master Hlavní
větev nastavena tak, aby sledovala vzdálenou větev master od původu.

Krok 7: Přenesení větve projektu na GitHub

Byla vytvořena nová větev projektu a úložiště. Zbývá „zatlačit“ větev a přenést ji do nového úložiště Github. Tímto způsobem budou moci členové komunity třetích stran vidět kód a provádět v něm změny. Pokud jsou revize schváleny, vlastník projektu může sloučit změny do hlavní verze projektu. Chcete-li odeslat změny do nové větve na GitHubu, musíte na příkazovém řádku zadat příkaz git push. GitHub automaticky vytvoří větev ve vzdáleném úložišti:
getrekt:myproject getrekt$ git push origin my-new-branch
Počítání objektů: 3, hotovo.
Delta komprese pomocí až 8 vláken.
Komprese objektů: 100 % (2/2), hotovo.
Zápis objektů: 100 % (3/3), 313 bajtů | 0 bajtů/s, hotovo.
Celkem 3 (delta 0), znovu použité 0 (delta 0)
Na https://github.com/cubeton/mynewrepository.git
* [nová větev] moje-nová-větev -> moje-nová-větev Po obnovení stránky GitHub se uživateli zobrazí nová větev, která byla vložena do úložiště.

dodatečně

Co znamená slovo původ v příkazu git push origin? Když uživatel naklonuje vzdálené úložiště na svém místním počítači, git pro něj téměř ve všech případech vytvoří standardní alias, „origin“, což je v podstatě zkratka pro URL vzdáleného úložiště. Odeslání projektu na GitHub: https://youtu.be/zM6z57OtR2Q

Krok 8. Vytvořte první požadavek na stažení

Požadavek na stažení (nebo požadavek na stažení) je způsob, jak upozornit vlastníky úložiště, že vývojář chce provést nějaké změny v kódu. Takto vypadá stránka s přidaným požadavkem na vytažení:
Takto vypadá rozhraní sekce po vytvoření požadavku na vytažení:

Krok 9 Sloučit požadavek na stažení

Zelené tlačítko „Merge pull request“ ve spodní části vytvoří požadavek na stažení. Po kliknutí na něj se provedené změny přidají do hlavní větve projektu.

Pozornost! Po sloučení větev smažte. Velké množství z nich může vést ke zmatkům v projektu. Chcete-li větev odstranit, klikněte na šedé tlačítko “Smazat větev” v pravém dolním rohu.

Chcete-li zkontrolovat aktuální stav odevzdání, klikněte na odkaz “Potvrzení” na úplně první stránce úložiště. Kliknutím se zobrazí celý seznam odevzdání v této větvi. Snímek obrazovky ukazuje přesně ten, který byl právě vytvořen.

Na pravé straně je hash kód každého potvrzení. Hash kód je jedinečný identifikátor, který lze použít při připojování rozhraní API a služeb třetích stran. Můžete také odkazovat na konkrétní potvrzení pomocí čísla ID ve verzi Git Bash pro stolní počítače na příkazovém řádku.

Krok 10 Vraťte změny Github na místním počítači

V tuto chvíli vypadá úložiště v systému Github trochu jinak než uživatel na lokálním počítači. Například potvrzení, které uživatel provedl na své vlastní větvi a sloučilo se do hlavní větve, na místním počítači neexistuje. Chcete-li automaticky synchronizovat různé verze projektu, musíte použít příkaz git pull origin master (při práci na hlavní větvi) nebo git pull.
getrekt:myproject getrekt $ git pull origin master
remote: Počítání objektů: 1, hotovo.
remote: Total 1 (delta 0), reused 0 (delta 0), pack-reused 0
From https://github.com/cubeton/mynewrepository
* branch master -> FETCH_HEAD  
23242..232433berer3444 master -> origin/master
getrekt. txt | 1 +
1 soubor změněn, 1 vložení (+)Chcete-li zkontrolovat aktuální stav příkazu, napište na příkazový řádek git log. Zobrazí seznam všech odevzdání.
getrekt:myproject getrekt $ git log
commit 32dgt472hf74yh7734hf747fh373hde7r3heduer73hfhf
Merge: 3fg4dd 34fg3u7j7
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Sep 11 17:48:11 2015 -0400
Merge /cubeton/mynewrepository
commit 44hgfh7f74hdu9jt93hf9ifejffe
Author: Mtdes Ethan < getrekt @yandex.ru>
Datum: Pá 07.01. 17:48:00 2021 -02356
commit 46thf9496hf9485hkf857tg9hfj8rh4j
Sloučit: 33fh5d 3689gfh
Autor: Mtdes Ethan <:72051.ledna:21.ledna:
01.01.
commit 46thf9496hf9485hkf857tg9hfj8rh4j
Merge: 33fh5d 3689gfh
Author: Mtdes Ethan < getrekt@yandex.ru>
Date: Fri Jan 07 17:55:00 2021 -02356
Added some more text to my file
commit 355904-43hg940fg959hfg0g95jjgdgdfgf57i86f
Merge: 343fggdd 53efhgffddg
Author: Mtdes Ethan < getrekt@yandex.ru>
Datum: Pá 7. ledna 17:58:00 2021 -02356
Toto je můj první závazek! Připraveno! Nyní je uživatel obeznámen se všemi druhy práce v systému správy verzí. Výukový program Git a GitHub pro začátečníky o tom, jak nainstalovat Git a začít s Githubem, větvemi, repozitáři, commity a dalšími koncepty v praxi GitHubu: https://youtu.be/zZBiln_2FhM

Další funkce Github a Git

Podívejme se na další užitečné „čipy“, které umožní vývojáři zjednodušit práci na kontrole verzí.

Klonování úložiště do místního počítače

Přejděte do svého úložiště GitHub. V pravém horním rohu nad seznamem souborů otevřete rozbalovací nabídku „Klonovat nebo stáhnout“. Zkopírujte adresu URL klonu HTTPS.
Vraťte se do okna Git Bash a zadejte příkaz:
git clone repository_url

repository_url – URL aktuálního projektu, který má být klonován. Místo toho se vloží adresa URL úložiště.

Ve výše uvedeném příkladu příkaz klonuje úložiště přes HTTPS. Další možností je klonování s URL přes SSH klíče. Chcete-li to provést, musíte ve Windows vygenerovat pár klíčů SSH a přiřadit veřejný klíč účtu GitHub.

Hledání vzdálených úložišť

Po klonování by se v pracovním adresáři na počítači měla objevit kopie úložiště z GitHubu. Projekt by měl obsahovat adresář s názvem a hlavními soubory. Chcete-li se na něj přepnout, musíte napsat následující příkaz:
cd git_project

Poznámka: Nahraďte git_project skutečným názvem staženého úložiště nebo zadejte obsah aktuálního adresáře pomocí příkazu ls. Druhý způsob se používá v případech, kdy si uživatel nemůže vzpomenout na název projektu.

Desktopová verze GitHubu – co je GitHub Desktop, hlavní funkce, vlastnosti a proces instalace

GitHub Desktop je desktopová aplikace, která poskytuje interakci s GitHubem na základě GUI. Na rozdíl od Gitu vám desktopová verze GitHubu umožňuje spouštět stejné příkazy pomocí uživatelského rozhraní kliknutím na tlačítka, což výrazně usnadňuje práci s repozitáři.

Jak nainstalovat

1. Klikněte na odkaz – https://desktop.github.com/
2. Začněte stahovat instalační balíček programu.
3. Dvakrát klikněte na ikonu staženého souboru a pokračujte v instalaci Github Desktop.
4. Spusťte program pomocí nabídky Start.
5. Přihlaste se na GitHub pomocí podrobností svého uživatelského účtu.

Hlavní funkčnost

• Vytváření, přidávání a klonování úložišť.
• Použití programu ke správě záložek projektu.
• Provádění změn ve větvi.
• Vytváření problémů, požadavků na stažení a potvrzení.
• Schopnost přístupu k raným verzím nových produktů.

Github API

Github REST API je rozhraní, které poskytuje vývojářům přístup k datům, projektům a úložištím Github a také odesílání požadavků serveru. Odkaz https://api.github.com/ obsahuje všechny adresy URL, na které můžete posílat nejjednodušší požadavky GET:
Nejčastěji vývojáři vytvářejí požadavky v programovacím jazyce Python ve formátu JSON. Nejprve je potřeba získat základní informace o úložišti z odkazu – https://api.github.com/user/repos Základní informace se zadávají do konfiguračního souboru ve formátu JSON. Obsahuje hlavní parametry o uživateli – avatar, čtečky, počet úložišť, stahování atd. Tato data jsou následně přenášena na server.

Správa a konfigurace projektů Github Desktop

Po instalaci, registraci účtu a nastavení aplikace může uživatel začít používat program GitHub.

Vytváření, přidávání a klonování úložiště

Chcete-li vytvořit nové úložiště, vyberte “Soubor” a klikněte na tlačítko “Vytvořit úložiště”. Chcete-li přidat místní projekt, vyberte nabídku „Soubor“ a klikněte na tlačítko „Přidat místní úložiště“. Pro klonování musíte vybrat nabídku “Soubor” – “Klonovací úložiště”.

Vytvoření nové pobočky

Chcete-li vytvořit samostatnou větev projektu, otevřete sekci Aktuální větev a klikněte na tlačítko Nová větev. Uživatel bude moci vidět větev v rozhraní GitHubu a provést žádost o stažení pro sledování změn.

Bezpečnost

Desktopová a webová verze Github vám umožňuje konfigurovat a zvyšovat úroveň zabezpečení uživatelského účtu. Všechny funkce jsou k dispozici v části „Nastavení zabezpečení úložiště“. Stojí za to zvážit podrobněji.

Nastavení bezpečnostní politiky

Na hlavní stránce vašeho úložiště klikněte na:

• “Zabezpečení” – “Zásady zabezpečení” – “Spustit nastavení”.
• Přidejte informace o podporovaných verzích vašeho projektu a o tom, jak nahlásit možné chyby zabezpečení.

Správa grafů závislostí

Pro všechna veřejná úložiště se automaticky generuje graf závislosti, ale pro soukromá úložiště žádná taková funkce neexistuje. Graf identifikuje všechny odchozí toky závislostí a umožňuje identifikovat zranitelná místa v projektu. Chcete-li nastavit graf závislosti, klikněte na “Nastavení” – “Zabezpečení a analýza”. Naproti grafu klikněte na „Povolit“ nebo „Zakázat“.

licence

Licencování Github umožňuje použití dvou hlavních typů
licencí :

1. GPL je typ licence, která umožňuje ostatním uživatelům používat práci někoho jiného v jiných open source projektech. To však komerční společnosti dělat nemohou.
2. LGPL/Commons/MIT/Apache atd. – uživatel rozdá svůj kód k bezplatnému použití. Ostatní na tom mohou vydělat.

Zkontrolovali jsme hlavní funkce cloudové služby Github a programu pro práci s repozitáři Git Bash . Krok za krokem jsme si řekli, jak vytvořit plnohodnotný projekt v systému správy verzí.