Git: käyttö tällä opintojaksolla¶

Huomaa

Opiskelijoiden oletetaan tuntevan Gitin käytön alkeet. Perehdy tarvittaessa edelliseen lukuun, jossa kerrataan Gitin käyttöä. Tietovarastojen käytöstä on annettu materiaalia myös Ohjelmointi 2 -opintojaksolla.

Tarvitset harjoitusten tekoon kahta etätietovarastoa (remote). Näistä ensimmäinen on sinulle valmiiksi luotu henkilökohtainen tietovarasto osoitteessa:

https://course-gitlab.tuni.fi/compcs140-spring2023/------

missä ------ on Tuni-käyttäjätunnuksesi. Kopioi aivan aluksi etätietovarastosi paikalliseksi tietovarastoksesi. Komentoikkunassa on siirryttävä ensin kurssin töille varattuun hakemistoon käyttöjärjestelmän cd-komennolla. Sitten voidaan antaa Gitin clone-komento:

git clone https://course-gitlab.tuni.fi/compcs140-spring2023/------

Toinen etätietovarasto sisältää harjoitustehtävien koodipohjat ja muun valmiin materiaalin. Tämä tietovarasto on osoitteessa:

https://course-gitlab.tuni.fi/compcs140-spring2023/student_template_project.git

Harjoitustehtävässä mainitaan aina, jos tehtävään liittyen on julkaistu materiaalia kurssin opettajien toimesta.

Koska valmista materiaalia tarvitaan jatkossa melkein jokaisessa ohjelmointitehtävässä, on työskentelysi sujuvampaa, jos määrittelet toiselle etävarastolle nimen Gitin remote-komennolla seuraavasti:

Keksi tietovarastolle kuvaava nimi. Alla annetuissa esimerkeissä oletetaan, että nimeksi on valittu materials.
Siirry komentoikkunassa paikallisen tietovarastosi hakemistoon käyttöjärjestelmän cd-komennolla.
Määrittele etävaraston nimi remote-komennolla riippuen siitä käytätkö kirjautumiseen SSH-avainta vai et. SSH-avain vähentää kirjautumisia. Ilman avainta etätietovarastoon täytyy kirjautua Tuni-tunnuksella aina, kun varastosta haetaan valmista koodia. Komento on muotoa:
```
git remote add materials git@course-gitlab.tuni.fi:compcs140-spring2023/student_template_project.git
```
jos olet määritellyt GitLabiin SSH-avaimen. Muussa tapauksessa annetaan etävaraston verkko-osoite sellaisenaan:
```
git remote add materials https://course-gitlab.tuni.fi/compcs140-spring2023/student_template_project.git
```
GitLabia käytetään näissä ohjeissa ilman SSH-avainta.

Tarkista lopuksi tunnetut etätietovarastot listaamalla:

git remote -v

että tietovarastolla on antamasi nimi:

origin https://course-gitlab.tuni.fi/compcs140-spring2023/------ (fetch)
origin https://course-gitlab.tuni.fi/compcs140-spring2023/------ (push)
materials https://course-gitlab.tuni.fi/compcs140-spring2023/student_template_project.git (fetch)
materials https://course-gitlab.tuni.fi/compcs140-spring2023/student_template_project.git (push)

Gitin clone-komento on antanut aiemmin automaattisesti käyttäjän oman etätietovaraston nimeksi origin.

Nimen määrittelyn jälkeen valmiin materiaalin yhdistäminen omaan paikalliseen tietovarastoosi käy helpommin Gitin pull-komennolla:

git pull materials main

Myös Gitin muut komennot, kuten fetch, tuntevat jatkossa materiaalin etävaraston antamallasi nimellä.

Valmiin materiaalin etävarastoon ei pidä, eikä voi, puskea uutta tietoa opiskelijan toimesta. Tarvitset Gitin push-komentoa vain, kun päivität oman etävarastosi sisältöä:

git push origin

Omaa etätietovarastoa ei ole pakko päivittää kaikissa ohjelmointitehtävissä, koska jotkut tehtävät palautetaan Plussan kautta yksittäisenä tiedostona, mutta varaston säännöllinen päivitys on hyvä muistaa joka tapauksessa.

Kurssilaisille tehdään myöhemmin erilliset, ryhmäkohtaiset etätietovarastot harjoitustyötä varten. Harjoitustyöhön liittyvä valmis materiaali jaetaan oman etätietovarastonsa kautta.