Kuidas ühendada Ubuntu ja GitHub: Samm-sammuline juhend Git’i paigaldamiseks ja kasutamiseks

1. Sissejuhatus

Miks siduda Ubuntu ja GitHub?

Viimastel aastatel on Git ja GitHub muutunud tavapäraseks tööriistaks tarkvaraarenduses ja süsteemihalduses. Eriti arendajate ja programmeerijate jaoks, kes kasutavad Ubuntut või muid Linuxi keskkondi, on GitHubi integreerimine igapäevane osa tööst.

Git on tööriist lähtekoodi versioonihalduseks, võimaldades tõhusat koostööd mitme arendaja vahel. GitHub on hostinguteenuse platvorm, kus saad interneti kaudu Gitiga hallatavaid repositooriume jagada ja avalikustada – see toimib arendajate globaalse koostöö keskusena.

Miks kasutada GitHubi Ubuntu keskkonnas?

Ubuntu on üks arendajate seas populaarsemaid Linuxi distributsioone ning sobib suurepäraselt avatud lähtekoodiga projektide arendamiseks. Giti ja teiste arendustööriistade paigaldamine on lihtne ning GitHubi sidumine töövoogu toimub kiiresti ja sujuvalt.

Näiteks on Ubuntu ja GitHubi kooskasutamisest kasu järgmistel juhtudel:

• Python’i või C++ koodi haldamine ja jagamine GitHubis
• Panustamine avatud lähtekoodiga projektidesse (contribute)
• Oma tööde avalikustamine portfooliona

Mida õpid sellest juhendist?

See juhend selgitab samm-sammult, kuidas kasutada GitHubi Ubuntu keskkonnas alates põhitõdedest kuni edasijõudnud teemadeni.

• Kuidas paigaldada Git Ubuntusse
• Giti esmased seadistused ja SSH-ühenduse loomine
• Repositooriumi loomine ja haldamine GitHubis
• Tõhus töö Visual Studio Code’iga
• Levinumate probleemide lahendamine (Korduma kippuvad küsimused)

Ka algajad saavad selle juhendi abil samm-sammult edasi liikuda, sest kõik on lahti seletatud praktiliste näidete ja soovitustega. Kui oled Ubuntu kasutaja ja soovid GitHubist maksimumi võtta, loe kindlasti lõpuni!

2. Git’i paigaldamine Ubuntu keskkonda

Mis on Git? – põhitõed

Git on versioonihaldussüsteem (VCS, Version Control System) tarkvaraarenduses. See haldab lähtekoodi muudatuste ajalugu ning võimaldab nii ajas tagasi liikumist kui ka koostööd mitme inimesega samaaegselt.

Linuxis (nt Ubuntu) on Giti paigaldamine eriti lihtne. Järgmise meetodi abil saab Git kiirelt tööle otse terminalis, vaid mõne minutiga.

Git’i paigaldamine (APT kaudu)

Git paigaldatakse Ubuntus tavaliselt APT (Advanced Package Tool) abil. Toimi järgnevalt.

1. Uuenda paketinimekiri

sudo apt update

See käsk toob alla värsked pakettide andmed. Tee see alati enne installeerimist!

2. Paigalda Git

sudo apt install git

Kui kuvatakse “Y/n”, vajuta “y” ja Enter, et paigaldamine algaks.

Git’i paigalduse kontroll

Pärast paigaldust kontrolli, kas Git töötab õigesti:

git --version

Kui ilmub näiteks selline väljund, on kõik korras:

git version 2.34.1

Versioon võib Ubuntu või pakettide uuendamise tõttu erineda, kuid kui kuvatakse versiooninumber, on paigaldus õnnestunud.

Git’i paigaldus Snapi kaudu (täiendus)

Git’i saab paigaldada ka snap kaudu, kuid APT on tavalisem ja stabiilsem. Kui pole erilist põhjust, soovitame kasutada APT-i.

3. Git’i esmane seadistamine

Millised esmased seaded teha enne Giti kasutamist?

Pärast Giti paigaldamist tuleb seadistada kasutaja andmed ja autentimine. See muudab töövoo sujuvamaks nii GitHubiga kui ka tiimitöös.

Giti kasutajanime ja e-posti seadistamine

Iga commit’i (muudatuse salvestuse) juurde märgib Git, kes selle tegi. Selleks tuleb seadistada oma kasutajanimi ja e-post.

Seadistuskäsk

git config --global user.name "Sinu nimi"
git config --global user.email "you@example.com"

Need ei pea kattuma GitHubi kasutajaga, kuid soovitav on kasutada sama nime ja e-posti, et commit’id oleksid üheselt seostatavad.

Seadete kontroll

git config --list

Selle käsuga näed praeguseid seadeid.

SSH-võtme loomine ja registreerimine GitHubis

Kuigi ka HTTPS ühendus on võimalik, võimaldab SSH seadistamine vältida parooli sisestamist iga kord ning muudab töö turvalisemaks ja mugavamaks.

1. Loo SSH-võti

ssh-keygen -t ed25519 -C "you@example.com"

Järgi juhiseid ja vajuta Enter, kuni loodud on ~/.ssh/id_ed25519 (privaatvõti) ja ~/.ssh/id_ed25519.pub (avalik võti).

2. Käivita SSH agent ja lisa võti

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Nüüd on võtmed kasutusvalmis.

3. Lisa avalik võti GitHubi

Kopeeri avaliku võtme sisu:

cat ~/.ssh/id_ed25519.pub

Kogu väljund tuleb kopeerida ja lisada GitHubis:

1. Logi sisse GitHubi
2. Klõpsa profiilipildil → “Settings”
3. Vasakul vali “SSH and GPG keys”
4. Vajuta “New SSH key”, kleebi võti ja salvesta

4. Testi SSH-ühendust

Kontrolli ühendust nii:

ssh -T git@github.com

Kui küsitakse “Kas usaldad seda hosti?”, vasta “yes”.
Õnnestumisel ilmub selline sõnum:

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Soovitatavad toimingud pärast seadistust

Pärast eelnevate seadistuste lõppu saad GitHubi repositooriumidega kasutada clone, push, pull jms käske. Järgmises osas selgitame kuidas GitHubis repositooriumit luua ja hallata.

4. GitHubi repositooriumi haldamine

Uue repositooriumi loomine GitHubis

Pärast GitHubi sisselogimist loo uus repositoorium järgnevalt.

Loomisjuhis (veebis)

1. GitHubi avalehe paremas ülanurgas vajuta “+” → “New repository”
2. Sisesta järgmine info:

• Repository name (näide: my-first-repo)
• Description (valikuline): lühikirjeldus
• Public / Private: avalik või privaatne

1. Vajuta “Create repository”

Peale loomist kuvatakse repositooriumi URL, millega saab teha clone jne.

Olemasoleva GitHubi repositooriumi kloonimine

Et kopeerida repositoorium kohalikku Ubuntu kataloogi, kasuta git clone käsku:

git clone git@github.com:your-username/my-first-repo.git

See näide kasutab SSH-ühendust; HTTPS puhul on URL teistsugune.

Pärast käivitamist tekib kataloogi my-first-repo ja selle sees on kogu repositooriumi sisu.

Failide muutmine, lavastamine ja commit’id

1. Lisa või muuda faile

Näide uue faili loomisest:

echo "# Esimene GitHubi projekt" > README.md

2. Lisa muudatused lavale (staging)

git add README.md

Staging tähendab muudatuste valimist järgmisesse commit’i.

3. Salvesta muudatused commit’ina

git commit -m "Esimene commit: lisatud README.md"

Nüüd on muudatused kohalikus ajaloos salvestatud.

Muudatuste üleslaadimine (push) GitHubi

Et viia kohalikud muudatused GitHubi, kasuta git push käsku.

git push origin main

Kui peaharuks pole main (näiteks master), kasuta sobivat harunime.

Muudatuste tõmbamine (pull) kaug-repositooriumist

Kui teised arendajad teevad muudatusi, tõmba need oma masinasse järgnevalt:

git pull origin main

See liidab kaugrepositooriumi muudatused sinu haruga.

Levinumad täiendavad käsud

• Kaugrepositooriumide nimekiri:

git remote -v

• Lisa uus kaug-GitHubi repositoorium:

git remote add origin git@github.com:your-username/another-repo.git

• README.md või .gitignore muutmine käib sama loogika järgi.

5. Visual Studio Code’i integreerimine

VS Code – parim valik Giti jaoks

Kui kasutad Ubuntu ja GitHubi, aitab Visual Studio Code (VS Code) töö kiiremini ja mugavamalt tehtud. VS Code on Microsofti avatud lähtekoodiga koodiredaktor, mille Git-integreerimine on suurepärane. Commit, push, diff – kõik on tehtav mugava GUI kaudu, mis sobib ka algajale.

VS Code paigaldamine (Ubuntu)

Ubuntus saad VS Code’i paigaldada järgmiste sammudega.

1. Lisa Microsofti repositoorium

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Lisa repositooriumi info

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. Paigalda VS Code

sudo apt update
sudo apt install code

Pärast paigaldust käivita terminalis code käsk, et avada editor.

Git-tugi on vaikimisi olemas

VS Code’is on Git’i tugi kohe olemas – ei pea lisapluginaid installima. Soovi korral on kasulikud järgmised laiendused:

• GitHub Pull Requests and Issues
  – GitHubi haldus ja pull request’id mugavalt GUI-s
• GitLens
  – iga koodirea muudatuste ajalugu ja autorid

Põhilised Giti toimingud VS Code’is

Repositooriumi avamine

Mine terminalis projekti kausta ja käivita:

code .

Nii avaneb VS Code selle repositooriumiga.

Muudatuste ülevaatus ja commit

• Vasakul küljel kliki “Versioonihaldus” ikoonil (haruneva joonega sümbol)
• Näed muudatuste nimekirja
• Faili klikates näed erinevusi
• Sisesta commit’i sõnum ja vajuta “✓”, et salvestada

Push ja pull käsud

• Vasakpoolsest menüüst vali “Push” või “Pull”
• Või kasuta paremal all asuvat olekuriba

Terminali saab kasutada paralleelselt

VS Code’i sisseehitatud terminaliga (Ctrl +) saab mugavalt kasutada nii GUI’d kui käsurida. Näiteks teed commit’i GUI-s, kuid branch’id käsureal.

Vihjed probleemide lahendamiseks

• Kui tekib SSH-ühenduse viga, kontrolli kas VS Code kasutab õiget SSH-võtit
• Vajadusel määra autentimine uuesti, kasuta GitHubi Personal Access Token’it

6. Levinumad tõrgete lahendused

SSH-ühenduse viga: “Permission denied (publickey).”

Põhjused

• SSH-võtit pole loodud või pole õigesti lisatud
• GitHubi pole avalikku võtit lisatud
• SSH-agent ei tunne võtit ära

Lahendus

1. Kontrolli, kas võti on olemas:

   ls ~/.ssh/id_ed25519.pub

Kui puudub, loo võti nii:

   ssh-keygen -t ed25519 -C "your_email@example.com"

2. Käivita SSH-agent ja lisa võti:

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519

3. Lisa avaliku võtme sisu GitHubi:

   cat ~/.ssh/id_ed25519.pub

→ Lisa see GitHubi “SSH and GPG keys” sektsioonis

4. Testi ühendust:

   ssh -T git@github.com

Autentimise viga (HTTPS): nõuab kasutajanime või parooli

Põhjus

• Paroolipõhine autentimine on eemaldatud, nüüd peab kasutama Personal Access Token’it

Lahendus

1. Loo GitHubis “Personal Access Token”
   → https://github.com/settings/tokens
   → märgi “repo” ja loo token
2. Gitis sisesta kasutajanimena oma GitHubi konto nimi, paroolina token
3. Selle salvestamiseks kasuta järgmist käsku:

   git config --global credential.helper cache

Viga: “fatal: not a git repository”

Põhjus

• Käivitati git käsk kataloogis, mis pole Git-repositoorium

Lahendus

• Liigu kloonitud projekti kataloogi:

  cd ~/your-project-directory

• Või loo uus repositoorium:

  git init

Konfliktide lahendamine (merge conflict)

Põhjus

• Kui sina ja teine inimene muudate sama faili sama kohta, tekib konflikt merge’i ajal

Lahendus

1. Kui git pull annab vea, ava fail editoris
2. Otsi selliseid märke:

   <<<<<<< HEAD
   Sinu muudatused
   =======
   Teise inimese muudatused
   >>>>>>> origin/main

3. Eemalda markerid ja jäta vajalik sisu alles
4. Salvesta ning käivita:

   git add .
   git commit

Viga: “remote: Repository not found.”

Põhjus

• Repositooriumi URL on vale
• Sul pole õigusi sellele repositooriumile

Lahendus

• Kontrolli kaugrepositooriumi URL:

  git remote -v

• Vajadusel muuda seda nii:

  git remote set-url origin git@github.com:your-username/your-repo.git

Need probleemid on tavalised algajate seas, kuid lahendused on selged – iga viga on uus võimalus õppimiseks. Harjuta rahulikult ja julgelt!

7. KKK (Korduma kippuvad küsimused)

K1. Mis vahe on Git’il ja GitHubil?

Vastus:
Git on versioonihaldustööriist lähtekoodi muudatuste jälgimiseks lokaalselt. GitHub on teenus, kus Git-repositooriume saab pilves hallata ja jagada.

• Git: saab ajalugu hallata ilma internetita
• GitHub: võimaldab jagada ja koostööd teha pilve kaudu

K2. Kas kasutada SSH- või HTTPS-ühendust?

Vastus:
SSH-ühendust soovitatakse, kuna:

• Ei pea iga kord parooli sisestama (SSH-võti)
• Turvalisem ja mugavam pikaajaliseks kasutamiseks

Kuid ettevõtte või võrgu tingimused võivad nõuda HTTPSi, seega vali vastavalt olukorrale.

K3. Kuidas kasutada mitut GitHubi kontot Ubuntu arvutis?

Vastus:
Loo iga konto jaoks oma SSH-võti ja määra see ~/.ssh/config failis.

1. Loo võtmed (nt ~/.ssh/id_ed25519_work, ~/.ssh/id_ed25519_personal)
2. Lisa ~/.ssh/config faili nii:

   Host github.com-work
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_work

   Host github.com-personal
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_personal

3. Muuda .git/config või git remote set-url käsku:

   git remote set-url origin git@github.com-work:your-work-user/your-repo.git

K4. Kas Gitit saab kasutada ainult graafilise liidese kaudu?

Vastus:
Jah, Visual Studio Code võimaldab Gitiga töötada täielikult GUI-s. Commit, push, diff, branch – kõik saab teha visuaalselt, mis on eriti mugav algajatele.

K5. Mis juhtub, kui GitHubi kaug-repo kustutada – kas lokaalne repo jääb alles?

Vastus:
Kui kustutad GitHubist kaug-repo, jääb lokaalne repo alles, kuid git push annab vea.

Kui soovid jätkata uue kaug-repoga, määra uus URL:

git remote set-url origin git@github.com:new-user/new-repo.git

K6. Ei taha terminali kasutada – kas ainult GUI abil saab hakkama?

Vastus:
Jah, järgmised tööriistad võimaldavad kogu töö teha GUI-s:

• GitKraken
• Sourcetree (Linuxis osaliselt Wine’iga)
• Visual Studio Code (Git on integreeritud)

Ubuntu kasutajale on VS Code + GitLens kõige lihtsam ja mugavam lahendus.

K7. Kui kaugele saab Git’is ajalugu tagasi vaadata?

Vastus:
Git talletab kogu ajaloo alates esimesest commit’ist. Ajaloo vaatamiseks kasuta:

git log

Kui soovid näha konkreetse faili ajalugu:

git log path/to/file