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ž chcete něco odeslat. SSH klíč je jako tajný klíč, který vám umožní bezpečně přistupovat k vaš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ři Terminál (nebo příkazový řádek na Windows).
2. Zadej následující příkaz a stiskni Enter:

ssh-keygen -t rsa -b 4096 -C "[email protected]"

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

Kde najdu 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žíš účet u Githubu nebo GitLabu je prakticky jedno, nicméně GitHub je mezi programátory o něco oblíbenější.

Pokud zvolíš GitHub:

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

cat ~/.ssh/id_rsa.pub

2. Zkopíruj celý obsah souboru (toto je tvůj veřejný klíč).
3. Přejdi na GitHub a vytvoř si tam účet, kterým se následně přihlaš.
4. Klikni na tvůj profilový obrázek v pravém horním rohu a vyber Settings.
5. V levém menu klikni na SSH and GPG keys.
6. Klikni na New SSH key.
7. Do pole pro název vlož libovolný název, např. Moje připojení.
8. Do pole pro klíč vlož obsah, který jsi zkopíroval, a klikni 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

Chceš-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 tvůj kód. Tento repozitář ti 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áš na svém počítači.

1. Přejdi na GitHub / GitLab a přihlas se ke svému účtu.
2. Vytvoř nový repozitář pomocí tlačítka New (na GitLabu New project).
3. Repozitář si nějak pojmenuj. Dobrým zvykem je dát repozitáři stejný název, jako má složka tvého projektu.
4. Nastav viditelnost repozitáře. Pro osobní projekty bohatě postačí private.
5. Pokud máš na počítači nějaký inicializovaný projekt pomocí git init a chceš ho přiřadit k nově vytvořenému GitHub / GitLab repozitáři, použij 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 chceš 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 ti umožní stáhnout veškerý kód, historii změn a verzí do tvého lokálního úložiště, kde můžeš 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ž chceš pracovat na projektu z různých zařízení.

1. Na stránce daného repozitáře najdi tlačítko Clone a zkopíruj URL repozitáře.
2. Otevři Terminál a přejdi do adresáře, kam chceš repozitář klonovat.
3. Použij příkaz pro klonování:

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

Odeslání změn na GitHub / GitLab

Jakmile dokončíš úpravy ve svém projektu a vytvoříš 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 tvá lokální práce synchronizuje s centrálním úložištěm projektu.

git push -u origin main

Pokud jsi na jiné větvi, změň main na název tvé 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 tvého lokálního repozitáře. Tento příkaz je užitečný, když chceš aktualizovat svůj projekt o změny, které provedli ostatní lidé. Postupuj podle následujících kroků:

1. Otevři Terminál a přejdi do adresáře svého projektu.
2. Použij příkaz:

git pull

Pokaždé než začneš pracovat na svém projektu, je dobré provést git pull, aby ses ujistil, že máš 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 pracuješ na projektu s dalšími lidmi, můžeš jim udělit přístup k tvému repozitáři na GitHubu / GitLabu. Tímto způsobem mohou ostatní uživatelé vidět, přispívat, nebo spravovat tvůj projekt v závislosti na udělených oprávněních. Zde je postup, jak pozvat spolupracovníky do projektu:

GitHub

1. Otevři svůj repozitář:
   • Přejdi na GitHub a přihlas se ke svému účtu.
   • Otevři repozitář, do kterého chceš 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:
   • Klikni na tlačítko Add people.
   • Zadej uživatelské jméno nebo e-mail osoby, kterou chceš pozvat.
   • Klikni 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.