Versionhallinta — SVN-harjoitukset

Nämä harjoitukset jakautuvat kahteen osaan: etukäteen ja paikalla tehtäviin. Pahoittelemme edelleen "branchi repositoryn trunkista" -kieltä.

Huom: db-konetta ei ole enää (joskin db.cs.helsinki.fi on alias uuteen koneeseen). Laitoksen uusi "tietokantapalvelin" on users.cs.helsinki.fi.

Etukäteen

Työkalut tutuiksi

Tee etukäteen nämä Linux-näppäilyharjoitukset ja yksinkertainen SVN:n kokeilu, niin harjoituksissa pääset suoraan oikeisiin tehtäviin.

1. Varmista, että pääset kirjautumaan koneelle db.cs.helsinki.fi
2. Jos kyllästyttää naputtaa jatkuvasti salasanaa, niin tee itsellesi SSH-avain
3. Luo repository käyttäen svnadmin -työkalua.
   • Voit tehdä repositoryn mille koneelle tahansa
4. Ota siitä itsellesi työkopio samalle koneelle, käyttäen file:// -URLia.
   • vinkki: komennolla pwd saa nykyisen hakemiston, joten: file:///`pwd`/repo on sama kuin file:///home/käyttäjätunnus/repo
5. Aseta ympäristömuuttuja $EDITOR haluamaksesi editoriksi.
   • Editoi tiedostoa .bashrc
   • Lisää sinne rivi export EDITOR=nano (tai haluamasi editori)
   • Ota muutokset käyttöön ilman uudelleenkirjautumista source .bashrc
6. Luo työkopioon SVN:n "standardihakemistot": trunk, branches ja tags
7. Kommitoi ensimmäinen versio.
8. Ota repositorystä työkopio jollekkin toiselle koneelle, kuten melkki.cs.helsinki.fi tai melkinpaasi.cs.helsinki.fi käyttäen svn+ssh://käyttäjätunnus@kohdekone/koko/polku/repository -URLia
   • db:n ulkopuolisilla koneilla polku on /fs/home/käyttäjätunnus, db:llä /home/käyttäjätunnus
9. Jatka kokeilua, kunnes tunnet olosi kotoisaksi

Tutustu tehtäviin

Katsasta tehtävät etukäteen ja kokeile onnistuuko diffin, mergen, copy ym. tarvittavien komentojen käyttö jo ennen harjoituksia.

Paikanpäällä

Muodostellaan 3 hengen pienryhmiä ja tehdään tehtävät.

Luo repository ja hae muiden ryhmäläisten luomista repositoryistä oma työkopio

Harjoitellaan vielä, että repositoryjen luonti ja tiedosto-oikeudet menevät varmasti oikein.

1. Luo SVN-repository koneen db kotihakemistoosi ja anna siihen luku-, kirjoitus- ja suoritusoikeudet ryhmälle rekursiivisesti. (chmod -R g+rwX)
   • Oikeassa käytössä oikeudet tulisi antaa vain sille ryhmälle, joka käyttää repositoryä. Nyt kuitenkin annetaan oikeudet tkol-ryhmälle, johon kuuluvat kaikki pääaineopiskelijat.
2. Hae muiden ryhmäläisten repositoryistä itsellesi omalle koneellesi työkopio SSH:n yli.
   • Hae työkopio esim. melkkiin: svn+ssh://USER@db/home/tunnus/repository
3. Lisätkää repositoryyn yksi tiedosto ja kokeilkaa, että saatte sen myös commitoitua.
4. Valmis!

Commit-conflict: Kissan venytys

On annettu "shortcat"

	    /\___/\
	   /       \
	  |  #    # |
	  \     @   |
	   \   _|_ /
	   /       \______
	  / _______ ___   \
	  |_____   \   \__/
	   |    \__/
	   |       |
	   /        \
	  /   ____   \
	  |  /    \  |
	  | |      | |
	 /  |      |  \
	 \__/      \__/
	
		Shortcat.
	

1. Luokaa ryhmälle yhteinen repository kurssin repositoryn luontikoneella. Luontikoneen tulostus on kryptinen koska siitä puuttuu rivinvaihdot, mutta kone palauttaa svn+ssh-URLin luotuun repositoryyn.
2. Hakekaa repositorystä työkopio. Jokainen ryhmän jäsen hakee oman työkopion kotihakemistoonsa.
3. Yksi ryhmän jäsen laittaa Shortcatin repositoryyn tiedostoon trunk/shortcat.txt
4. Jokainen ryhmän jäsen pidentää oman työkopionsa Shortcattiä keskikohdasta yhdellä |etunimi| -rivillä, pidennyksen jälkeen ryhmän jäsen tekee commitin yhteiseen repositoryyn. Tehkää tämä samanaikaisesti siten, että committeja tulee jokaiselle viisi kappaletta. Shortcatin pituudeksi tulee tällöin [ryhmän jäsenien lukumäärä] x 5. Selvittäkää ristiriidat venytyksen edetessä.
5. Käyttäkää svn blame -komentoa shortcat.txt -tiedostoon ja tallettakaa sen tulostus repositoryyn
6. Uudelleennimetkää tiedosto longcat.txt:ksi, sillä shortcat on nyt looooooooooooong. Muistakaa kuitenkin säilyttää versiohistoria!

Branching, merge, tag, revert

1. Jokainen ryhmän jäsen tekee oman branchin trunk -hakemistosta hakemistoon branches/[etunimi]
2. Muokatkaa oman branchinne Longcatin päätä ja jalkoja. Commit kun on valmista.
3. Mergetkää oma valmis branchinne trunk -hakemistoon.
4. Tehkää trunk -hakemistosta tag valmis-[etunimi]
5. Katsokaa svn diff -komennolla trunkin ensimmäisen version ja HEAD:n ero. Palauttakaa svn merge -komennolla alkuperäinen versio.

Ignore

1. Kääntäkää trunk -hakemistossa oleva Longcat.java
2. Lisätkää hakemistoon property svn:ignore, jotta *.class -tiedostot pysyvät poissa versionhallinnasta.

Graafiset työkalut

Näitä tehdään jos ehditään ja/tai tuntuu, että osaa aikaisemamt jo riittävän hyvin. Näitä ei tarvitse osata harjoitustyössä.

1. Asentakaa esim. Eclipsen Subclipse-plugin
2. Tehkää aikaisempia conflict -kokeita sen avulla.

Hooks

Vähän edistyneemmille..

1. Laittakaa omaan repositoryyn hook, joka lähettää sähköpostia commitin jälkeen.
2. Laittakaa omaan repositoryyn hook, jolla saatte päivitettyä sisällön nettiin (public_html alle siis).