Spolupráce s ostatními

Git nám umožňuje spolupracovat s ostatními lidmi na projektech. V tomto kurzu se podíváme na to, jak používat GitHub / GitLab, což jsou populární platformy pro sdílení kódu. Ukážeme si, jak vygenerovat SSH klíč, přidat repozitář na GitHub / GitLab, a jak s nimi pracovat.

Co je SSH klíč a proč ho potřebujeme?

SSH klíč je bezpečný způsob, jak se připojit k GitHubu / GitLab bez nutnosti zadávat heslo pokaždé, když chceme něco odeslat. SSH klíč je jako tajný klíč, který nám umožní bezpečně přistupovat k našim projektům.

Jak vygenerovat SSH klíč

Nyní si ukážeme, jak vygenerovat SSH klíč. Tento proces je stejný pro všechny operační systémy (Windows, Mac, Linux).

1. Otevřeme Terminál (nebo příkazový řádek na Windows).
2. Zadejme následující příkaz a stiskněme Enter:

ssh-keygen -t rsa -b 4096 -C "tvuj@email.com"

3. Po zobrazení výzvy pro uložení souboru stiskněme klávesu Enter. Tímto se uloží do výchozího umístění.
4. Pokud chceme, můžeme také nastavit heslo pro dodatečné zabezpečení. Tímto způsobem musíme zadat heslo při každém použití klíče. Pokud nechceme heslo, stačí stisknout Enter.

Kde najdeme svůj SSH klíč?

SSH klíč bude uložen v následující cestě:

• Na Windows:

C:\Users\Tvé_Uživatelské_Jméno\.ssh\id_rsa.pub

• Na Mac:

/Users/Tvé_Uživatelské_Jméno/.ssh/id_rsa.pub

• Na Linux:

/home/Tvé_Uživatelské_Jméno/.ssh/id_rsa.pub

Přidání SSH klíče na GitHub / GitLab

Nyní, když máme náš SSH klíč, musíme ho přidat na GitHub nebo GitLab, abychom mohli bezpečně komunikovat. Jestli si založíme účet u Githubu nebo GitLabu je prakticky jedno, nicméně GitHub je mezi programátory o něco oblíbenější.

Pokud zvolíme GitHub:

1. Otevřeme soubor id_rsa.pub v textovém editoru. Můžeme to udělat pomocí příkazu:

cat ~/.ssh/id_rsa.pub

2. Zkopírujme celý obsah souboru (toto je náš veřejný klíč).
3. Přejděme na GitHub a vytvořme si tam účet, kterým se následně přihlásíme.
4. Klikněme na náš profilový obrázek v pravém horním rohu a vyberme Settings.
5. V levém menu klikněme na SSH and GPG keys.
6. Klikněme na New SSH key.
7. Do pole pro název vložme libovolný název, např. Moje připojení.
8. Do pole pro klíč vložme obsah, který jsme zkopírovali, a klikněme na Add SSH key.

Pro GitLab je proces velmi podobný:

1. Přejdi na GitLab a přihlas se ke svému účtu.
2. Klikni na ikonu uživatelského profilu v pravém horním rohu a vyber Preferences.
3. V levém menu klikni na SSH Keys.
4. Do pole pro klíč vlož obsah souboru id_rsa.pub (stejně jako na GitHubu).
5. Do pole pro název můžeš zadat libovolný název a kliknout na Add key.

Založení repozitáře na GitHubu / GitLabu

Chceme-li spravovat svůj projekt pomocí GitHubu / GitLabu, je prvním krokem vytvoření repozitáře, který bude sloužit jako online úložiště pro náš kód. Tento repozitář nám umožní bezpečně zálohovat práci, sdílet ji s ostatními nebo sledovat změny v projektu. V následujícím návodu si ukážeme, jak krok za krokem založit nový GitHub / GitLab repozitář a propojit ho s lokálním projektem, který máme na svém počítači.

1. Přejděme na GitHub / GitLab a přihlasme se ke svému účtu.
2. Vytvořme nový repozitář pomocí tlačítka New (na GitLabu New project).
3. Repozitář si nějak pojmenujme. Dobrým zvykem je dát repozitáři stejný název, jako má složka našeho projektu.
4. Nastavme viditelnost repozitáře. Pro osobní projekty bohatě postačí private.
5. Pokud máme na počítači nějaký inicializovaný projekt pomocí git init a chceme ho přiřadit k nově vytvořenému GitHub / GitLab repozitáři, použijeme následující příkaz:

git remote add origin https://github.com/uzivatel/nazev-repozitare.git

Klonování existujícího repozitáře z GitHubu / GitLabu

Pokud chceme pracovat s existujícím projektem, který už je uložen na GitHubu nebo GitLabu, nejlepším způsobem je si ho naklonovat do svého počítače. Klonování repozitáře nám umožní stáhnout veškerý kód, historii změn a verzí do našeho lokálního úložiště, kde můžeme projekt upravovat, spouštět nebo přidávat nové funkce. Tento postup je ideální pro spolupráci s ostatními vývojáři nebo když chceme pracovat na projektu z různých zařízení.

1. Na stránce daného repozitáře najděme tlačítko Clone a zkopírujme URL repozitáře.
2. Otevřeme Terminál a přejděme do adresáře, kam chceme repozitář klonovat.
3. Použijme příkaz pro klonování:

git clone https://github.com/uzivatel/nazev-repozitare.git

Odeslání změn na GitHub / GitLab

Jakmile dokončíme úpravy v našem projektu a vytvoříme příslušné commity, je čas tyto změny odeslat do vzdáleného repozitáře na GitHub / GitLab, aby byly bezpečně uloženy a případně sdíleny s ostatními. Odeslání změn (push) je klíčovým krokem, který zajistí, že se naše lokální práce synchronizuje s centrálním úložištěm projektu.

git push -u origin main

Pokud jsme na jiné větvi, změňme main na název naší větve.

Stahování změn

Příkaz git pull slouží k stažení nejnovějších změn z vzdáleného repozitáře a jejich sloučení do našeho lokálního repozitáře. Tento příkaz je užitečný, když chceme aktualizovat náš projekt o změny, které provedli ostatní lidé. Postupujme podle následujících kroků:

1. Otevřeme Terminál a přejděme do adresáře našeho projektu.
2. Použijme příkaz:

git pull

Pokaždé než začneme pracovat na svém projektu, je dobré provést git pull, abychom se ujistili, že máme nejnovější verzi kódu ze vzdáleného repozitáře. To pomáhá předejít konfliktům nebo práci na zastaralé verzi kódu.

Pozvání dalších lidí do repozitáře

Pokud pracujeme na projektu s dalšími lidmi, můžeme jim udělit přístup k našemu repozitáři na GitHubu / GitLabu. Tímto způsobem mohou ostatní uživatelé vidět, přispívat, nebo spravovat náš projekt v závislosti na udělených oprávněních. Zde je postup, jak pozvat spolupracovníky do projektu:

GitHub

1. Otevřeme náš repozitář:
   • Přejděme na GitHub a přihlasme se ke svému účtu.
   • Otevřeme repozitář, do kterého chceme přidat nové spolupracovníky.
2. Nastavení repozitáře:
   • Klikni na tlačítko Settings (vpravo nahoře v repozitáři).
3. Správa přístupu:
   • V postranní nabídce vlevo klikni na Collaborators and teams.
4. Přidání spolupracovníka:
   • Klikněme na tlačítko Add people.
   • Zadejme uživatelské jméno nebo e-mail osoby, kterou chceme pozvat.
   • Klikněme na Add.
5. Výběr oprávnění:
   • Nastav úroveň oprávnění:
     • Read: Uživatel může projekt pouze číst.
     • Write: Uživatel může přidávat změny (commity).
     • Admin: Uživatel má plná práva pro správu projektu.
6. Odeslání pozvánky:
   • GitHub automaticky odešle pozvánku uživateli. Jakmile ji přijme, bude mít přístup podle nastavených oprávnění.

GitLab

1. Otevři svůj projekt:
   • Přejdi na GitLab a přihlas se ke svému účtu.
   • Otevři projekt, do kterého chceš přidat nové spolupracovníky.
2. Nastavení projektu:
   • Klikni na tlačítko Project information a zvol Members.
3. Přidání členů:
   • Klikni na tlačítko Invite members.
   • Zadej uživatelské jméno nebo e-mail osoby, kterou chceš pozvat.
   • Klikni na profil správné osoby.
4. Nastavení oprávnění:
   • Vyber roli, kterou uživateli přiřadíš:
     • Guest: Omezený přístup (např. pouze čtení a komentáře).
     • Reporter: Přístup ke čtení projektu a vytváření issues.
     • Developer: Možnost upravovat kód a přispívat do projektu.
     • Maintainer: Plný přístup ke správě kódu a projektu.
     • Owner: Neomezená práva k projektu (tuto roli mohou mít pouze správci).
5. Odeslání pozvánky:
   • Klikni na Invite. Uživateli bude odeslána pozvánka, kterou musí přijmout, aby mohl spolupracovat na projektu.