Tehtävät on tarkoitus tehdä joko pajassa tai omatoimisesti. Tehtävien palautuksen deadline on tiistai 03.11. klo 23:59
Tehtävät palautetaan Githubin ja Labtoolin avulla. Lisää palautuksesta myöhemmin. Osa tehtävistä ei näy palautuksesta mitenkään. Niiden tekemättä jättäminen näkyy puuttuvana osaamisena ja saattaa aiheuttaa myöhemmin hankaluuksia.
Viikon palautuksista on tarjolla 2 pistettä. Pisteytys arvioidaan palautuksen laadun perusteella.
Muista pushata tehtävät GitHubiin ennen viikkodeadlinea. Myöhässä tehty palautus ei tuo pisteitä.
Graafisten käyttöliittymien olemassaolosta huolimatta ohjelmistoalalla on edelleen erittäin tärkeää hallita komentorivin eli terminaalin käyttö.
Opettele käyttämään "riittävästi" komentoriviä (ks. alla oleva lista). Opettelu käy ehkä helpoiten tekemällä Tietokone työvälineenä-kurssin ensimmäisen osan Komentorivi tehtävät 1-13.
Tämän tehtävän jälkeen sinun tulisi hallita seuraavat asiat:
- Käsitteet
- root directory
- home directory
- parent directory
- child directory
- working directory
- .. ja *
- Ja osata käyttää komentoja
- pwd
- cd
- ls, ls -a, ls -l, ls -t
- mkdir
- touch
- cp
- rm, rm -r
- mv
Tulet tarvitsemaan komentorivin käyttötaitoja tällä kurssilla ja muutenkin opinnoissasi.
Saman Tietokone työvälineenä-kurssin materiaalin toisesta osasta voi olla paljonkin hyötyä tässä ja seuraavissa tehtävissä.
Ota ssh-yhteys linuxpalvelimeen melkki.cs.helsinki.fi, melkinpaasi.cs.helsinki.fi tai melkinkari.cs.helsinki.fi. Linuxilla, macilla ja Windows 10:llä yhteys otetaan komentoriviltä komennolla ssh kayttajatunnus@palvelimenosoite. Vanhemmilla Windows versioilla ssh-yhteyden ottaminen onnistuu esimerkiksi putty:llä.
Kirjauduttuasi laitoksen palvelimelle, tee seuraavat toimenpiteet:
- Luo kotihakemistoosi hakemisto kurssit
- HUOM joidenkin kohdalla melkillä on ollut ongelmia kotihakemiston asetuksissa ja esim. hakemiston luomisen seurauksena on virhe 'permission denied'. Jos törmäät ongelmaan, lähetä viesti osoitteeseen [email protected] ja raportoi ongelmaksi "ei oikeuksia kotihakemistoon melkillä"
- Kokeile myös jos kirjaantuminen toiselle koneelle, esim. melkinpaasi.cs.helsinki.fi tuottaisi paremman tuloksen
- Luo hakemistolle kurssit alihakemisto ot2020
- Ja luomallesi hakemistolle alihakemisto viikko1
- Mene kotihakemistoosi ja luo sen alle hakemisto temp
- Mene hakemistoon temp
- Hae osoitteessa https://raw.githubusercontent.com/ohjelmistotekniikka-hy/python-materiaali/master/misc/unicafe.zip oleva tiedosto wget-ohjelmalla
- Wget toimii siten, että sille annetaan ladattava tiedosto parametriksi
- Haettu tiedosto on zip-paketti, pura se unzip-ohjelmalla
- Myös unzip toimii siten, että sille annetaan purettava tiedosto parametriksi
- Komennon suorittamisen jälkeen hakemistoon on ilmestynyt hakemisto unicafe
- Siirrä hakemisto hakemiston kurssit/ot2020/viikko1 alihakemistoksi
- Poista zip-paketti
- Poista hakemisto temp
Mene tämän jälkeen kotihakemistoon ja anna komento tree kurssit. Copypastea komennon tulostus talteen, tarvitset sitä myöhemmin.
Komentoriviä käyttäessä kannattaa ehdottomasti totutella tab-completen käyttöön. Tab on näppäin, joka näyttää suunnilleen seuraavalta
Tab:ia painamalla voit komentorivillä täydentää kirjoittamasi komennon nimen tai parametrin. Esim. jos olet siirtymässä hakemistoon nimeltään ohjelmistotekniikka-syksy-2020, riittää, että kirjoitat cd oh ja painat tabia. Jos hakemistossasi ei ole muita tiedostoja tai hakemistoja, jotka alkavat merkeillä oh, nimi täydentyy. Jos on, niin voit joutua kirjoittamaan merkin tai kaksi lisää. Jos tiedostoja on useampia etkä ole varma oikeasta nimestä, painamalla tabia useamman kerran näet mahdolliset vaihtoehdot.
Myös komentojen nimet voi täydentää tab-completella. Esim. haluat avat chromium-browser web-selaimen komentoriviltä, riittää että kirjoitat chro ja painat tabia. Komennon nimi täydentyy.
Ei pidä myöskään unohtaa nuolta ylöspäin. Sen avulla voit selata aiemmin kirjoittamiasi komentoja.
Aloitteleva komentorivin käyttäjä pitää usein ainoastaan yhtä terminaali-ikkunaa kerrallaan auki. Useimmissa tilanteissa työtehosi moninkertaistuu, jos avaat useita terminaaleja näytöllä tai avaat yhteen terminaaliin useita "tabeja" eli välilehtiä. Uuden tabin saat avautumaan painamalla yhtä aikaa ctrl, shift ja t tai sovelluksen valikosta (joka laitoksen Linuxeissa sijaitsee ruudun yläreunassa).
Tutustumme seuraavaksi versionhallintaan.
Mitä tarkoitetaan versionhallinnalla? Lainaus sivulta https://www.atlassian.com/git/tutorials
Version control systems are a category of software tools that help a software team manage changes to source code over time. Version control software keeps track of every modification to the code in a special kind of database. If a mistake is made, developers can turn back the clock and compare earlier versions of the code to help fix the mistake while minimizing disruption to all team members.
Vaikka ylläoleva puhuu versionhallinnasta ohjelmistotiimien yhteydessä, kannattaa versionhallintaa käyttää oikeastaan yhdenkin hengen projekteissa ja muunkinlaisen materiaalin, kuin koodin hallinnoimiseen. Esim. tämän kurssin kaikki materiaali on talletettu versionhallintaan.
Nykyään suosituin versionhallintaohjelmisto on git. Tutustumme tänään gitin alkeisiin.
HUOM Git-tehtävät tulee tehdä tietokoneella, jolle on asennettu Git. Monilla macOS- ja Linux-käyttöjärjestelmien tietokoneilla Git on valmiiksi asennettuna. Asian voi tarkistaa suorittamalla oman tietokoneen terminaalissa komennon:
git --versionJos komento ei tulosta Git-version numeroa, tutustu Git-asennusohjeisiin. Windows-tietokoneilla asennuksessa ja komentojen suorituksessa voi käyttää esimerkiksi Windows Subsystem for Linux -työkalua.
Jos komennon tulostama gitin versio taas on pienempi kuin 2.23.0, seuraavissa tehtävissä käytetty git restore -komento ei toimi. Voit kuitenkin käyttää git reset HEAD- ja git checkout -komentoja, joista saat lisätietoa Tietokone työvälineen -kurssin materiaaleista.
Avaa terminaali omalla koneellasi. Seuraavat tehtävät tehdään siis paikallisesti, ei melkillä!
Määrittele gitille oma nimesi sekä käyttämäsi email-osoite antamalla komennot:
git config --global user.name "Your Name"
git config --global user.email [email protected]
Varmista komennolla git config -l, että määrittelyt menivät oikein.
Määritellään vielä git käyttämään sopivia värejä komennolla git config --global color.ui ja vaihdetaan gitin käyttämäksi oletuseditoriksi nano komennolla git config --global core.editor nano
- jos käytät vimiä, voit jättää oletuseditorin muuttamatta
Tee vielä seuraava konfiguraatio
git config --global push.default matching
Tämä liittyy git push -komennon oletusarvoiseen toiminnallisuuteen. Komennosta lisää myöhemmin.
Tee nyt sopiva hakemisto gitin harjoittelua varten ja mene hakemistoon, eli anna esim. komennot:
- mkdir ot_viikko1
- cd ot_viikko1
HUOM: varmista nyt että olet luomassasi hakemistossa, eli jos suoritat komennon ls, ei hakemistossa pitäisi olla mitään.
Luodaan hakemistosta paikallinen git-repositorio antamalla komento git init
Git ilmoittaa alustaneensa repositorion:
mluukkai@melkinpaasi:~/ot_viikko1$ git init Initialised empty Git repository in /home/ad/fshome4/u4/m/mluukkai/Linux/ot_viikko1/.git/
Jos katsot hakemiston sisältöä komennolla ls -la huomaat, että hakemiston sisälle on ilmestynyt hakemisto .git. Git käyttää luotua hakemistoa pitääkseen kirjaa repositorioon talletetuista tiedostoista.
HUOM koska hakemiston nimi (.git) alkaa pisteellä, ei komento ls näytä sitä oletusarvoisesti. Parametri a näyttää myös pisteellä alkavat tiedostot ja hakemistot. Kokeile, miten ls -a ja ls -la eroavat toisistaan!
Pysy edelleen repositorion sisältävässä hakemistossasi ot_viikko1.
Luo hakemistoon tiedosto nimeltään tiedosto.txt, esim. komennolla touch. Luotuasi tiedoston, suorita komento git status:
mluukkai@melkinpaasi:~/ot_viikko1$ touch tiedosto.txt mluukkai@melkinpaasi:~/ot_viikko1$ git status On branch master No commits yet Untracked files: (use "git add ..." to include in what will be committed) tiedosto.txt nothing added to commit but untracked files present (use "git add" to track) mluukkai@melkinpaasi:~/ot_viikko1$
Git ilmoittaa, että on olemassa tiedosto, joka on tilassa untracked, eli tiedostoa ei ole lisätty versionhallinnan pariin.
Kuten komennon tuloste kertoo, tiedoston lisääminen gitin alaisuuteen (...to include in what will be committed) tapahtuu komennolla git add tiedosto.txt
Suorita lisäys ja sen jälkeen komento git status:
mluukkai@melkinpaasi:~/ot_viikko1$ git add tiedosto.txt mluukkai@melkinpaasi:~/ot_viikko1$ git status On branch master No commits yet Changes to be committed: (use "git rm --cached ..." to unstage) new file: tiedosto.txt
Git kertoo nyt, että tiedosto.txt on niiden muutosten joukossa, jotka voidaan commitoida.
Commitoimisella tarkoitetaan tiedostojen ja hakemistojen sekä niihin liittyvien muutosten tallentamista git-repositorioon.
Suoritetaan commitointi antamalla komento git commit -m "tiedosto.txt luotu"
mluukkai@melkinpaasi:~/ot_viikko1$ git commit -m "tiedosto.txt luotu" [master (root-commit) 0e12cfa] tiedosto.txt luotu 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 tiedosto.txt
Suorita jälleen komento git status
mluukkai@melkinpaasi:~/ot_viikko1$ git status On branch master nothing to commit, working tree clean
Git ilmoittaa, että working tree clean, eli hakemistosi on samassa tilassa kuin git-repositorio.
Muista käyttää tab-completea tehtäviä tehdessäsi!
Kun teet muutoksia hakemistosi alla oleviin tiedostoihin (tai hakemistoihin), kohdistuvat muutokset working directoryyn eli työhakemistoon.
- Tee jokin muutos tiedostoon tiedosto.txt
- käytä tiedostojen editointiin nano-editoria. Editori käynnistyy komentoriviltä komennolla nano tiedosto.txt
- saat tallennettua nanossa tiedoston painamalla yhtä aikaa ctrl ja o
- editori sulkeutuu painamalla ctrl ja x
- Luo hakemistoon uusi tiedosto, nimeltään toinen.txt
Suorita jälleen git status
mluukkai@melkinpaasi:~/ot_viikko1$ git status
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: tiedosto.txt
Untracked files:
(use "git add <file>..." to include in what will be committed)
toinen.txt
no changes added to commit (use "git add" and/or "git commit -a")
Git ilmoittaa nyt, että uusi tiedosto on untracked ja että aiemmassa tiedostossa on muutoksia, jotka eivät ole staged for commit.
Toimitaan ohjeen mukaan eli lisätään muutokset ja uusi tiedosto commitoitavien joukkoon. Molempien tiedostojen yhtäaikainen "addaaminen" onnistuu komennolla git add .
Tarkistetaan taas tilanne komennolla git status
mluukkai@melkinpaasi:~/ot_viikko1$ git status
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: tiedosto.txt
new file: toinen.txt
Sekä muutos että uusi tiedosto ovat nyt valmiina committoitavaksi.
Committointi onnistuu komennolla git commit. Kuten edelliselläkin kerralla, annetaan komennolle parametrina commit-viesti, eli merkkijono, joka kuvaa mitä muutoksia uusi commit tuo edelliseen nähden:
git commit -m"muutos ja lisäys"
Tarkasta committoinnin jälkeen jälleen tilanne komennolla git status.
HUOM jos suoritat commitoinnin vahingossa ilman commit-viestiä, eli parametria -m, avaa git tekstieditorin ja olettaa että haluat kirjoittaa commit-viestin editoriin. Jos et määritellyt alun ohjeen mukaan gitille editoriksi nanoa, avautuu oletusarvoinen editori vim ja joudut kenties googlaamaan, miten pääset pois editorista.
Tiedostot ja niihin tehdyt muutokset voivat siis olla gitin suhteen kolmessa eri tilassa.
- Aluksi tiedostot (tai niihin tehdyt muutokset) ovat vain working directoryssä ja git ei noteeraa niitä ennen kuin ne lisätään komennolla
git add - Tämän jälkeen tiedostot ovat valmiina commitoitavaksi. Gitin terminologian mukaan valmiina committoitavaksi olevat tiedostot ovat staging-alueella
- Komento
git commitsiirtää stagingissa olevat muutokset repositorioon eli luo uuden commitin
Seuraava kuva havainnollistaa sitä, miten tiedoston tila vaihtuu git-komentoja tekemällä.
Kun tiedosto luodaan, menee se gitin working directoryyn. Komennolla git add tiedosto siirtyy staging-alueelle, eli valmiiksi committointia varten. Stagingissa oleva tiedosto viedään (eli "commitoidaan") repositorioon komennolla git commit. Kun committoitua tiedostoa taas editoidaan, menevät muutokset jälleen working directoryyn.
Jokainen komennon git commit suorittaminen siis synnyttää repositorioon uuden commitin, eli uuden "tilan". Komennolla git log on mahdollista nähdä, mitä committeja repositorio sisältää:
mluukkai@melkinpaasi:~/ot_viikko1$ git log
commit 6aff75ab51d14d7cb9a72867ba13d9782d06c7ff (HEAD -> master)
Author: Matti Luukkainen
Date: Sun Oct 7 19:33:32 2018 +0300
muutos ja lisäys
commit 9e6a83d058c9564e8a390f8766845d45b365f360
Author: Matti Luukkainen
Date: Sun Oct 7 19:32:12 2018 +0300
tiedosto.txt luotu
mluukkai@melkinpaasi:~/ot_viikko1$
Gitin logi kertoo jokaisen commitin ajan, tekijän, viestin ja tunnisteen. Tunnisteita käytetään, jos on esim. tarvetta palata johonkin vanhan commitin tilaan.
Voit selata logia nuolinäppäimillä. Pääset ulos git log:ista painamalla q.
Muista käyttää komentoa git status mahdollisimman usein. Älä myöskään unohda tab-completea!
- Luo tiedosto kolmas.txt
- Lisää se commitoitavaksi ja commitoi
- Muuta tiedostojen toinen.txt ja kolmas.txt sisältöä ja commitoi muutokset
- Luo hakemisto stuff ja sen sisälle jokin tiedosto
- Lisää muutokset committoitavaksi ja committoi
- Huomaa, että hakemiston lisääminen riittää, sen sisältämät tiedostot tulevat automaattisesti lisätyksi
- Katso miltä git-logi näyttää
Gitin committeja voi tarkastella myös graafisella gitk-komennolla (OSX:lle ja Windowsille vastaava työkalu on Sourcetree). Suorita komento repositoriossa:
Vasemmalla yläkulmassa näet kaikki commitit. Uusin tilanne ylimpänä. Uusimman commitin nimi on master. Klikkaamalla commitia, näet muissa ikkunoissa commitiin liittyviä tietoja. Oikealla alakulmassa näet ne tiedostot, jotka ovat muuttuneet commitissa (jos valinta on patch) tai ne tiedostot, joita repositoriossa oli olemassa commitin aikana (jos valinta on tree). Vasemmassa alakulmassa pystyt tarkastelemaan commitin tiedostoihin tekemiä muutoksia tai tiedostojen tilaa commitin aikana. Valinnat ovat hieman hämäävät, sillä ne toimivat eri tavoin riippuen oikean puolen moodista.
Vastaava näkymä OSX:n Sourcetree-ohjelmalla tarkasteltaessa:
Seuraavaa tehtävää tekiessäsi kannattaa terminaaliin avata uusi välilehti, jotta voit pitää gitk:ta käynnissä.
- Kopioi tiedostoon tiedosto.txt jostain paljon tekstiä ja commitoi tiedosto
- Poista nyt osa tiedoston tekstistä ja lisää tiedostoon hieman lisää tekstiä
- commitoi muutosten jälkeen
- Päivitä gitk:n näkymä (file/update) ja katso miten muutokset näkyvät (tarkastele kahta ylintä committia)
- valitse oikeasta alakulmasta patch ja vasemmasta diff
- näin näet commitin aiheuttamat muutokset diff-muodossa
- jos oikealta on valittuna tree, näkyy vasemmalla puolella (valinnasta riippumatta) tiedostojen commitin aikainen tilanne
- Jos käytät sourcetreetä, sen pitäisi päivittyä automaattisesti ja näyttää muutos diff-muodossa
- Poista tiedosto toinen.txt
- suorita git status
- commitoi muutos
- poista ensin tiedosto gitin alaisuudesta komennolla git rm
- varmista komennolla git status, että kaikki on niinkuin kuuluukin
- muuta tiedoston tiedosto.txt nimeksi eka.txt
- uudelleennimentä tapahtuu komennolla mv
- suorita git status
- miten git käsittelee uudelleennimennän?
- commitoi muutos
- Tee jotain muutoksia tiedostoihin eka.txt ja kolmas.txt
- tee sekä lisäyksiä että poistoja
- lisää ne commitoitavaksi komennolla git add -p
- git näyttää nyt jokaisen tekemäsi muutoksen patch-muodossa ja pyytää varmistamaan lisätäänkö muutos commitoivaksi
- hyväksy painamalla y ja enter
- commitoi muutokset
- tee tiedostoihin tehtyjen muutosten commitoitavaksi lisääminen aina komennolla git add -p, näin pääset tarkastamaan, että muutokset ovat juuri ne mitä oletat olevasi lisäämässä
- Huomaa, että kokonaan uudet tiedostot eivät siirry committoitavaksi komennolla git add -p
Joskus tiedostoihin tulee tehtyä muutoksia, jotka on tarpeen perua
- tee nyt joku muutos tiedostoon eka.txt, älä lisää tiedostoa committoitavaksi
- suorita komento git status
mluukkai@melkinpaasi:~/ot_viikko1$ git status
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: eka.txt
no changes added to commit (use "git add" and/or "git commit -a")
Kuten oletettua, git kertoo että olemme tehneet muutoksia, jotka eivät ole "staged for commit", eli lisättyjä commitoitavaksi.
- Päätetäänkin perua muutokset. Se onnistuu komennolla
git restore eka.txt - Kun suoritat uudelleen komennon git status huomaat, että working directory ei enää sisällä muutoksia:
mluukkai@melkinpaasi:~/ot_viikko1$ git restore eka.txt
mluukkai@melkinpaasi:~/ot_viikko1$ git status
On branch master
nothing to commit, working trean clean
- Varmista vielä, että tiedoston sisältö on sama kuin ennen muutoksia
Myös stagingiin viety eli valmiina committoitavaksi oleva muutos voidaan perua.
- Tee muutoksia tiedostoon kolmas.txt ja lisää se committoitavaksi. Älä kuitenkaan committoi.
- git statuksen pitäisi näyttää seuraavalta
mluukkai@melkinpaasi:~/ot_viikko1$ git status
On branch master
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: kolmas.txt
mluukkai@melkinpaasi:~/ot_viikko1$
Ohje muutoksen perumiseen löytyy git statuksen tulosteesta.
- suorita muutokset peruva komento
git restore --staged kolmas.txt - katsotaan jälleen git status
mluukkai@melkinpaasi:~/ot_viikko1$ git status
On branch master
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: kolmas.txt
no changes added to commit (use "git add" and/or "git commit -a")
Tiedosto ei siis enää ole staged-tilassa, muutokset ovat kuitenkin working directoryssä, eli jos katsot tiedoston sisällön, muutokset ovat vielä olemassa
- pääset perumaan muutokset kokonaan antamalla komennon
git restore kolmas.txt - varmista, että tiedosto on palannut muutoksia edeltävään tilaan
Seuraavassa tiedoston tilaa kuvaava kaavio täydennettynä, eli jos tiedosto on lisätty committoitavaksi, eli se on staged, voidaan muutos perua komennolla git restore --staged. Tällöin muutokset kuitenkin vielä jäävät tiedostoon, eli ovat working directoryssä. Tiedosto saadaan palautettua repositoriossa olevaan edellisen commitin tilaan komennolla git restore.
- luo repositiosi sisälle hakemisto tiedostoja ja hakemiston sisälle tiedostot file1, file2 ja file3
- commitoi muutokset
- muista miten pystyt lisäämään kokonaisen hakemiston sisällön committoitavaksi yhdellä komennolla
- muuta tiedoston file1 sisältöä ja poista tiedosto file2
- peru muutokset!
- muuta tiedoston file3 sisältöä, lisää commitoitavaksi
- peru muutokset!
- poista tiedosto file1 ja uudelleennimeä tiedosto file2 tiedostoksi file22
- committoi
Suorita repositoriossa komento git log --stat | cat ja ota komennon tulos talteen, tulet tarvitsemaan sitä myöhemmin!
Gitin käytöstä on toki hyötyä jo harjoittelemallammekin tavalla, eli muodostamalla paikallisen koneen hakemistosta repositorio. Pääsemme kuitenkin nauttimaan kertaluokkaa suuremmista hyödyistä liittämällä repositoriomme internetissä olevaan etärepositorioon. Etärepositorion kautta repositorion tiedostot on helppo jakaa useiden koneiden tai/ja useiden käyttäjien kesken.
Internetin johtava paikka etärepositorioiden tallettamiseen on GitHub
Ennen GitHubin käytöönottoa, tee uusi git-repositorio paikalliselle koneelle, seuraavassa oletetaan että hakemiston nimi on ot-harjoitustyo.
HUOM: älä luo uutta repositoriota aiemmin tekemäsi harjoitusrepositorion sisälle!
Esim. seuraavat komennot siirtyvät kotihakemistoon, luovat sen alle hakemiston ot-harjoitustyo, siirtyvät hakemistoon, alustavat sen git-repositorioksi sekä lisäävät ja commitoivat yhden tiedoston repositorioon:
cd mkdir ot-harjoitustyo cd ot-harjoitustyo git init touch README.md git add . git commit -m"initial commit"
Siirrytään sitten GitHubin käyttöön
- Luo itsellesi tunnus GitHubiin (ellei sinulla jo ole tunnusta)
- Luo uusi repositorio
- uuden repositorion luomistoiminto löytyy vasemman ylänurkan plus-symboolin alta
- Älä laita rastia kohtaan Initialize this repository with a README
- luo repositorio painamalla vihreää Create repository -nappia
Seuraavaksi haluamme liittää GitHubiin luodun repositorion juuri luodun paikallisen koneen repositorion ot-harjoitustyo etärepositorioksi.
- etärepositorion lisääminen onnistuu GitHubiin avautuvan näkymän ohjeiden mukaan
- varmista, että kohdasta "Quick setup..." on valittu SSH
- kopioi ylempi rivi kohdasta ...or push an existing repository from the command line
- omassa esimerkissäni rivi on
git remote add origin [email protected]:mluukkai/ot-harjoitustyo.git- pastea rivi komentoriville ja suorita komento painamalla enter
- suorita komento git remote -v
- tulostus kertoo, että githubin etärepositorio on liitetty paikalliseen repositorioosi nimellä origin
mluukkai@melkki:~/ot-harjoitustyo$ git remote -v
origin [email protected]:mluukkai/ot-harjoitustyo.git (fetch)
origin [email protected]:mluukkai/ot-harjoitustyo.git (push)- origin on etärepositorion oletusarvoinen nimi. Nimi voi olla mikä tahansa ja etärepositorioitakin voi olla useita
- voimme siirtää paikallisen repositoriomme tilan etärepositorioon komennolla git push
- saatat joutua tekemään ensimmäisen pushin pidemmässä muodossa --set-upstream origin master
- kokeillaan
mluukkai@melkki:~/ot-harjoitustyo$ git push --set-upstream origin master
Warning: Permanently added the RSA host key for IP address '192.30.253.112' to the list of known hosts.
Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.Jos olet jo asettanut julkisen avaimen esim. Tietokantojen perusteissa, pushauksen pitäisi toimia ja voit siirtyä seuraavaan kohtaan.
Pushaus ei toimi. Nyt kyse on siitä, että git haluaisi suorittaa julkisen avaimen autentikoinnin. Se ei kuitenkaan onnistu koska emme ole kertoneet gitille julkista salausavaintamme.
- luo salausavain antamalla komentoriviltä komento ssh-keygen
- voit vastata kaikkiin kysymyksiin enterillä
- syntyy kaksi salausavainta, salainen ja julkinen. Ne sijoitetaan kotihakemistosi alla olevaan hakemistoon .ssh
- mene hakemistoon ja katso hakemiston sisältöä
- tiedosto id_rsa.pub sisältää julkisen avaimen, se on tarkoitus kopioida githubiin jotta avaimeen perustuva kirjautuminen onnistuisi
- näet tiedoston sisällön komennolla cat id_rsa.pub
- anna komentoriviltä komento ssh-add
- mene GitHubin asetussivulle klikkaamalla oikean yläkulman symbolista ja valitsemalla settings
- valitse settingseistä SSH and GPG keys
- luo uusi SSH-avain
- anna avaimelle joku title (esim. laitos) ja kopioi tiedoston idrsa.pub sisältö kohtaan _key
- Suorita uudelleen push:
mluukkai@melkki:~/ot-harjoitustyo$ git push
Counting objects: 3, done.
Writing objects: 100% (3/3), 213 bytes | 106.00 KiB/s, done.
Total 3 (delta 0), reused 0 (delta 0)
remote:
remote: Create a pull request for 'master' on GitHub by visiting:
remote: https://github.com/mluukkai/ot-harjoitustyo/pull/new/master
remote:
To github.com:mluukkai/ot-harjoitustyo.git
* [new branch] master -> master
Branch master set up to track remote branch master from origin.
- nyt kaikki näyttää toimivan
- tee juuri luodun repositorion sisälle hakemisto laskarit
- ja sen sisälle hakemisto viikko1
- Komentorivitehtävien lopussa oli kehotus: Mene tämän jälkeen kotihakemistoon ja anna komento tree kurssit. Copypastea komennon tulostus talteen, tarvitset sitä myöhemmin
- Tee hakemiston laskarit/viikko1 sisälle tiedosto komentorivi.txt ja kopioi sinne komennon tree tulos
- Edellisen tehtäväsarjan lopussa kehoitettiin tallentamaan harjoitusrepositoriossa annetun komennon git log --stat | cat tulos
- Tee hakemiston laskarit/viikko1 sisälle tiedosto gitlog.txt ja kopioi sinne githarjoittelun tulos
- Kirjoita jotain tekstiä hakemiston juuressa olevaan tiedostoon README.md
- muotoile tekstisi markdown-notaatiota käyttäen
- tee tiedostoon esim. jokin otsikko, tavallista tekstiä, joka sisältää lihavoituja ja kursivoituja osuuksia
- näemme pian tekstin ruudulla muotoiltuna
- commitoi muutokset
- muista aina commitoinnin yhteydessä lisätä tiedosto/muutokset commitoitavaksi
- pushaa koodi githubiin komennolla git push
- mene GitHub-repositoriosi sivulle
- käytännössä tämä tapahtuu uudelleenlataamalla repositorion luomisen jälkeen avautunut sivu
- huomaat että tiedostot näkyvät nyt repositorion sivulla. Sivulle renderöityy repositorion juuressa olevan README.md:n sisältö markdown-muotoiltuna
- voit editoida repositoriossa olevia tiedostoja suoraan GitHubin editorilla menemällä tiedoston sivulle ja painamalla kynäsymbolia
- tee README.md:hen linkit repositorion hakemistossa laskarit/viikko1/ oleviin tiedostoihin komentorivi.txt ja gitlog.txt
- ohje linkin muodostamiseen löytyy täältä
- tiedostojen urlin saat navigoimalla GitHubissa tiedostoon ja kopioimalla osoitteen selaimen osoiteriviltä
- Repositoriosi tulee näyttää suunnilleen seuraavalta
- jos teit kaiken oikein, pääset README.md:ssä olevia linkkejä klikkaamalla näkemään linkitettyjen tiedostojen sisällön
- GitHubissa tekemämme muutokset ovat tehneet etärepositorioon uuden commitin
- Etärepositorio on nyt edellä paikallista repositorioamme
- Saamme tuotua muutokset paikalliselle koneelle komennolla git pull
- Kokeile komentoa ja varmista, että muuttunut sisältö on nyt paikallisessa repositoriossa
- Tee paikallisella koneella jokin muutos esim. tiedostoon README.md
- Lisää ja committaa muutos
- Vie muutokset GitHubiin komennolla git push
- Varmista GitHubista että muutokset näkyvät
- Paikallinen repositoriosi ja GitHubin etärepositorio ovat jälleen samassa tilassa.
- joskus käy niin, että paikallinen ja etärepositorio menevät epäsynkroniin, siten että molempiin tehdään yhtäaikaa uusi commit
- luodaan tälläinen tilanne
- tee paikalliseen repositorioon muutos tiedostoon README.md, lisää ja committoi muutos
- älä pushaa muutosta GitHubiin
- tee GitHubiin muutos johonkin muualle kuin README.md-tiedostoon
- editoi siis esim. tiedostoa gitlog.txt hieman suoraan GitHubissa
- yritä nyt pushata paikallisen repositorion muutokset githubiin
- seurauksena on virheilmoitus
mluukkai@melkki:~/ot-harjoitustyo$ git push
To [email protected]:mluukkai/ot-harjoitustyo.git
! [rejected] master -> master (fetch first)
error: failed to push some refs to '[email protected]:mluukkai/ot-harjoitustyo.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally. This is usually caused by another repository pushing
hint: to the same ref. You may want to first integrate the remote changes
hint: (e.g., 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.
mluukkai@melkki:~/ot-harjoitustyo$
- Tulet törmäämään tähän varmaan useasti jatkossakin.
- Ongelma ei ole paha. Koska paikalliset ja GitHubin muutokset ovat kohdistuneet eri tiedostoihin, selviämme helpolla
- ensin pullaamme muutokset paikalliseen repositorioon komennolla git pull
- pullaaminen synnyttää ns. merge commitin, jolle joudumme määrittelemään commit-viestin avautuvaan editoriin
- oletusarvoinen viesti käy, eli riittää että poistut editorista tallentaen muutokset
- ja pushaamme ne uudelleen githubiin
- nyt paikallinen ja etärepositorio ovat taas synkroonissa
- katso repositorion tilaa nyt komennolla gitk
- näet, että repositorion uusimmalla commitilla on nyt kaksi edeltäjää, paikallinen commit ja etärepositorion commit
Jos muutokset olisivat kohdistuneet samaan tiedostoon, olisi syntynyt hieman vakavampi tilanne, eli merge-konflikti. Konfliktit on pakko selvittää itse editorin avulla. On toki olemassa työkaluja, mergetooleja, jotka auttavat konfliktin selvittämisessä. Emme kuitenkaan mene tällä kurssilla merge-konflikteihin.
Nyrkkisääntönä kannattaa pitää aina sitä, että kun rupeat työskentelemään paikallisessa repositoriossa, pullaa ensin kaikki muutokset etärepositoriosta. Ja kun lopetat työskentelyn, pushaa muutokset etärepositorioon. Näin konflikteja ei yhden ihmisen työskentelyssä todennäköisesti tule.
Rekisteröi nyt omat tietosi ja luomasi repositorio Labtooliin. Valitse kurssiksi Ohjelmistotekniikka jos joudut tekemään valinnan.
Labtool kysyy myös harjoitustyön aihetta (project name), jos et ole vielä varma aiheestasi voit muuttaa aiheen nimeä myöhemmin.
Gitin peruskäyttö tulee varmasti tutuksi kurssin aikana. Gitin edistyneempien piirteiden opiskelua kannattaa ilman muuta jatkaa myös omin päin. Internetistä löytyy suuri määrä enemmän tai vähemmän hyviä tutoriaaleja. Seuraavassa muutama linkki