0 bodů

Git · 40 min

Vzdálené repozitáře: clone, push, pull

Co je vzdálený repozitář a origin, jak stáhnout projekt přes git clone, poslat commity přes git push, stáhnout novinky přes git fetch a git pull a co dělat, když server push odmítne.

Lidsky řečeno

Vzdálený repozitář je jako sdílená nástěnka ve sborovně. Každý učitel má doma vlastní sešit s poznámkami (lokální repozitář). Když chce kolegům něco ukázat, přinese a připíchne to na nástěnku (push). Když chce vědět, co přidali ostatní, podívá se na nástěnku a opíše si to (pull). Nástěnka nic nedělá sama, jen drží společnou verzi.

Obtížnost: 3 z 5. Předpokládá commity a větve. Servery v úkolech (adresy https://github.com/...) jsou smyšlené a běží jen v simulaci, nic se neposílá na internet.

Lokální a vzdálený repozitář

Dosud bylo všechno jen u tebe. Vzdálený repozitář (remote) je kopie stejného repozitáře jinde, typicky na GitHubu, GitLabu nebo firemním serveru. Vzdálený repozitář má jméno a adresu. Výchozí jméno je origin.

text
 tvůj počítač                                 GitHub
 ┌──────────────────────┐   git push    ┌──────────────────┐
 │ main                 │ ────────────> │ main             │
 │ origin/main (kopie   │ <──────────── │                  │
 │  stavu serveru)      │ fetch / pull  └──────────────────┘
 └──────────────────────┘

U tebe vedle main existuje i vzdálená sledovací větev origin/main. To je tvoje poslední známá fotka toho, jak vypadá main na serveru. Mění se jen při komunikaci se serverem (fetch, pull, push).

bash
git remote -v                          # seznam vzdálených i s adresami
git remote add origin ADRESA           # přidej vzdálený repozitář
git remote set-url origin NOVA_ADRESA  # změň adresu
git branch -a                          # větve včetně remotes/origin/...

git clone: stáhni projekt

git clone ADRESA vytvoří složku pojmenovanou podle repozitáře, stáhne do ní celou historii, nastaví origin a přepne na výchozí větev. Druhý parametr určí jiné jméno složky.

Úkol v terminálu

Stáhni si sdílený repozitář

Na GitHubu je repozitář s recepty na adrese https://github.com/sudo-learn/recepty.git. Naklonuj ho do své domovské složky (vznikne složka recepty). Pak se do ní přepni a prohlédni si historii.

Načítám terminál…

git push: pošli commity

bash
git push                    # pošli aktuální větev tam, kam ji sleduješ
git push origin main        # explicitně: kam a jakou větev
git push -u origin main     # pošli a nastav sledování (příště stačí git push)

Po naklonování je sledování nastavené samo, main sleduje origin/main. git status pak hlásí, jestli jsi napřed (Your branch is ahead of 'origin/main' by 1 commit), pozadu, nebo jestli se větve rozešly.

Úkol v terminálu

Pošli nový recept na server

Repozitář recepty už máš naklonovaný. Vytvoř soubor pernik.txt s jakýmkoli receptem, commitni ho se zprávou Přidán perník a pošli na server. Všimni si, co před a po odeslání hlásí git status.

Načítám terminál…

Z vlastního projektu na GitHub

Když projekt založíš u sebe (git init) a teprve potom ho chceš dát na GitHub, vytvoříš na GitHubu prázdný repozitář (bez README) a GitHub ti ukáže přesně tyto příkazy:

bash
git remote add origin https://github.com/jmeno/projekt.git
git branch -M main
git push -u origin main

git branch -M main jen pro jistotu přejmenuje aktuální větev na main. Přepínač -u (dlouze --set-upstream) nastaví, že main sleduje origin/main. Bez něj by příští git push skončil hláškou fatal: The current branch main has no upstream branch.

Úkol v terminálu

Dej vlastní projekt na GitHub

Ve složce denik máš repozitář s několika commity. Na GitHubu jsi vytvořil prázdný repozitář https://github.com/adam/denik.git. Přidej ho jako origin, pošli na něj větev main a nastav sledování, aby příště stačilo git push.

Načítám terminál…

fetch a pull: stáhni novinky

  • git fetch stáhne nové commity ze serveru a aktualizuje origin/main. Tvoji větev nemění. Můžeš se pak v klidu podívat, co přibylo: git log main..origin/main nebo git diff main origin/main.
  • git pull je fetch a hned potom sloučení origin/main do aktuální větve.

Když jsi u sebe nic nového nevytvořil, pull jen posune větev dopředu (fast-forward).

Úkol v terminálu

Stáhni, co přidal kolega

Kolegyně Bára mezitím na server poslala soubor README.md. Stáhni její změny do své větve main. Můžeš zkusit nejdřív git fetch a git status, abys viděl, že jsi pozadu.

Načítám terminál…

Když server push odmítne

Pokud mezitím někdo jiný poslal na server commit, který ty nemáš, server tvůj push odmítne:

text
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'https://github.com/sudo-learn/recepty.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. ...

Server tě chrání před tím, abys kolegovu práci přepsal. Řešení: stáhni jeho změny, spoj je se svými a pošli znovu. Protože se historie rozešly (nové commity jsou na obou stranách), novější verze Gitu při git pull chtějí vědět, jak je spojit: sloučením (--no-rebase), přeskládáním (--rebase), nebo vůbec (--ff-only). Natrvalo to nastavíš třeba git config pull.rebase false.

Úkol v terminálu

Push odmítnut: spoj a pošli znovu

Commitnul jsi recept na koláč, ale git push server odmítne, protože tam mezitím Bára poslala README. Stáhni její změny sloučením (merge, ne rebase) a pak úspěšně pošli obojí na server.

Načítám terminál…

Pod kapotou · Sledování větví, refspec a force push

Sledování (upstream) je v .git/config zapsané jako branch.main.remote = origin a branch.main.merge = refs/heads/main; git branch -vv ho ukáže i s počtem commitů napřed a pozadu. Vzdálené sledovací větve leží v refs/remotes/origin/* a git fetch je plní podle refspecu +refs/heads/*:refs/remotes/origin/*. Větve, které na serveru někdo smazal, u tebe zůstanou, dokud nespustíš git fetch --prune. Přepsání vzdálené větve git push --force je v týmu nebezpečné, šetrnější --force-with-lease odmítne přepis, pokud se server mezitím změnil oproti tvé poslední známé verzi. Na GitHubu se hlavní větev obvykle chrání pravidlem (branch protection), které force push zakáže.

Procvič si to

Kvíz

Co je origin/main?

Kvíz

Jaký je rozdíl mezi git fetch a git pull?

Kvíz

Server odmítl push s hláškou (fetch first). Co uděláš?

Doplň

Doplň příkazy

Kartičky

Opakování: vzdálené repozitáře