JOT2012 Demo1-ohje

Jos asennat Gitin kotiin, unohda myös putty. OpenSSH on parempi, ja jos et sitä tarvitse, tulee Gitin Windows-version mukana jo tarvittavat ohjelmistot (Git Bash).

Käytä Git Bash- ja/tai Git GUI-ohjelmaa. Unohda alla oleva putty-sekoilu, ja toimi Git Bashissä kuten Unix-, Linux- tai OSX-tietokoneessa.

8.2.2013 tilanne, mutta päivittyy nopeasti Sovietin ja Finlandin tasolle.

Windows-koneella avaa Putty-ohjelma, ja ota sillä yhteys jalava-etäkoneeseen. Jos kotikoneellasi ei ole Puttya, se löytyy osoitteesta http://www.chiark.greenend.org.uk/∼ sgtatham/putty/. Kun putty käynnistyy, se näyttää seuraavanlaisen ikkunan.

Aseta ensin käytettäväksi merkistöksi UTF-8 valitsemalla Category-laatikosta vasemmalta Window → Traslation, ja syöttämällä kohtaan Character set translation… teksti UTF-8, joka löytyy myös ponnahdusvalikosta.

Putty-ikkunassa osoitteeksi (host name) annetaan jalava.cc.jyu.fi.

Hyväksy tulostuva turvallisuuskehote. Syötä tämän jälkeen tunnuksesi ja salasanasi, ja olet muodostanut yhteyden jalava-koneeseen.

Pieni ohje UNIX-komentoihin löytyy osoitteesta http://www.mit.jyu.fi/opetus/kurssit/jot/2012/unix.html.

Kun olet muodostanut etäyhteyden jalava-koneelle, luo SSH-avainpari jalavan komentoriviltä kommennolla ssh-keygen -t rsa. Ohjelma ssh-keygen ehdottaa avaimille oletusnimiä, jotka kannattaa hyväksyä, jollet ole aiemmin tehnyt avaimia jalavaan. Jos olet aiemmin luonut avaimet jalavaan (tai vastaavaan etäkäyttökoneeseen), tämä vaihe on turha.

$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/nashome1/uid/.ssh/id_rsa): _

Kun ssh-keygen ohjelma kysyy tunnuslauseita (passphrase) paina vain enteriä mennäksesi eteenpäin. SSH-keygen luo jalavan .ssh hakemistoon avain parin, ts. kaksi tiedostoa: id_rsa ja id_rsa.pub. Näistä jälkimmäinen tulee siirtää yliopiston yousource-koneelle, jota kurssilla käytetään versiohallintaan. Tämä tehdään menemällä osoitteeseen https://yousource.it.jyu.fi/ ja kirjautumalla omilla käyttäjätunnuksillasi sisään YouSource-palveluun. Valitse oikealta Manage SSH-keys, jonka jälkeen avautuvalta sivulta edelleen oikealta Add SSH key. Kopioi luomasi avain parin julkinen avain (tiedoston id_rsa.pub sisältö) sivun lomakkeeseen ja paina Save.

Kun käytät tällä kurssilla versiohallintaa, ts. siirrät tiedostoja jalava-koneen ja yousource-koneen välillä, luomasi avainpari mahdollistaa tiedostojen siirron ilman jatkuvaa autentikointia. Huomaa siis, että yksityinen avain (tiedosto id_rsa) sijatisee jalava-koneella ja sen julkinen pari (tiedosto id_rsa.pub) yousource-koneella. SSH-yhteys luodaan avainparin avulla automaattisesi tietojen siirron ajaksi.

Huomioi, että poistut hakemistosta .ssh ennenkuin jatkat harjoituksia. Älä koskaan työskentele hakemistossa .ssh tai myöhemmin esiteltävässä .git-hakemistossa, ellet todella tiedä, mitä olet tekemässä.

Huomioi myös, että U:-asema Windowsissa yliopistolla on täsmälleen sama kuin jalavan ja muiden etäkäyttökoneiden kotihakemistosi!

Demoissa harjoitellaan versionhallintaa suoraan komentoriviltä. Ensin on kuitenkin luotava git-varasto YouSourceen. Avatkaa JOTDemot2012-projekti, joka löytyy YouSourcesta osoitteesta https://yousource.it.jyu.fi/jotdemot2012. Projektista löytyy git-varasto nimeltä demo. Kloonatkaa tämä varasto itsellenne napista Clone repository.

YouSourcen seuraava näkymä kyselee kloonatulle varastolle nimeä ja muita asioita, antakaa nimeksi jotain omaa tai hyväksykää oletus.

Kloonausta ei tarvitse tehdä kuin yhden ryhmästä, mutta kaikki voivat toki harjoitella tätä.

Kun varasto on kloonattu näyttää YouSource kloonatun varaston sivua. Jatkossa kaikki ryhmän jäsenet käyttävät tätä kloonattua varastoa. Ensimmäinen kloonin tehnyt antaa nyt muille ryhmäläisille oikeuden tähän varastoon YouSourcen asetuksista, jotka löytyvät ikkunan oikeasta laidasta löytyvän napin Manage collaborators takaa. Tämä tosin onnistuu vain, jos lisättävä ryhmän jäsen on jo aiemmin kertaalleen kirjautunut YouSourceen. Sen ylälaidasta, kloonivaraston nimen alta löytyy git-alkuinen osoite, jota tarvitaan, kun varasto kloonataan vielä toistamiseen kunkin ryhmäläisen omaan tietokoneeseen. Tämä kloonaus tapahtuu antamalla komentoriviltä komento git clone URL, missä URL on yllä YouSourcessa näytetty URL. Kun jälkimmäinen kloonaus on valmis, on harjoitteluhakemisto koneessasi valmis.

Tee seuraavaksi jokin pieni tekstitiedosto, kuten test.txt harjoitteluhakemistoosi. Kirjoita tiedostoon vapaamuotoista tekstiä ja tallenna. Palaa jalavan komentoriville ja anna komento git add test.txt. Tällä komennolla kerrot, että haluat ottaa tiedoston test.txt mukaan versioitavaksi. Anna tämän jälkeen komento git commit, joka siirtää tiedostosi tiedot (pikemminkin version) lokaaliin git-varastoosi. Itse asiassa git commit siirtää versiotiedot kaikista niistä tiedostoista, joille olet sanonut git add osaksi lokaalia git-varastoasi.

Jos olette muuttaneet vain yhtä tiedostoa, tai haluatte tallentaa kaikki muutetut tiedostot lokaaliin versiohallintaan, voitte käyttää komentoa git commit -a. Uudemmissa git-versioissa toimii myös muoto git commit tiedostot, jolla voitte lisätä ja tallentaa versiohallintaan samalla komentorivillä useita tiedostoja kerralla. Tuo siis vastaa git add ja git commit komentojen antamista jokaiselle mainitulle tiedostolle.

Kun ajat jalavassa (tai muissa Unix-koneissa) komennon git commit ilman tarkennetta -m, se käynnistää editorin, jolla kommentti muutoksista voidaan kirjoittaa. Ohjeet kirjoittamisesta ovat itse kommentissa kommentoituna (heh!), mutta editorista ei juuri sanota mitään. Oletuksen editori on usein vim tai vi, joka poikkeaa hieman totutusta. Vim on tilallinen editori, joten päästäksesi kirjoittamaan sinun on siirryttävä muokkaustilaan painamalla i (insert). Kun olet valmis, tulee sinun siirtyä muokkaustilasta komentotilaan painamalla <ESC>, eli sitä näppäimistö vasemmasta yläkulmasta löytyvää esc-painiketta. Tämän jälkeen tallennus ja poistuminen tapahtuu joko näppäilyllä :wq<RET>, missä <RET> tarkoittaa rivinvaihtoa (enter, return), tai lyhyemmin :x<RET>. Vaikeata on osua esc-painikkeeseen, mutta pienellä harjoituksella se onnistuu huomaamatta.

Jos haluat vaihtaa oletuseditorin, tapahtuu se muokkaamalla kuoren (shell) aloitusskriptissä ympäristömuuttuja EDITOR haluamaksesi, esim. bash-kuorella

export EDITOR=emacs

Jos et, tai tuntuu liian nörtiltä, unohda tämä :-)

Emacsilla tiedoston tallentaminen tapahtuu komennolla C-x C-s, eli ctrl-nappi pohjaan ja napautat x, ihan niinkuin Windowsin Cut-komennossa, ja ctrl-nappi pohjassa pitäen napautat vielä s. Poistuminen tapahtuu vastaavasti näppäilyllä C-x C-c. Hankalaa on nyt pitää ctrl-nappi pohjassa. Jos haluatte, aktivoituvat valikot painamalla F10-näppäintä, ja nyt komentojen antaminen on yksittäisten, korostettujen kirjainten painamista.

Paniikkikomento vimissä on <ESC><ESC><ESC>, emacsissa C-g.

Jo nyt on hyvä varoittaa kahdesta asiasta: demo-ohjaajien editorimieltymykset ovat toistensa vastaiset, ja ainoa väärä valinta on jokin muu editori kuin Emacs tai vim ;-)