CVS gyorstalpaló

1. Mi a CVS?

A CVS (Concurrent Versions System) egy konfiguráció menedzsment eszköz. Konfiguráció menedzsmentre pedig akkor van szükség, ha egy projekt sok fájlját  kell módosítani, a módosításokat nyomon követni, és korábbi változatokat szeretnénk később visszanyerni.

A CVS az RCS (Revision Control System) változatkezelő rendszeren alapul, kiterjesztve azt olyan módon, hogy a fájlok csoportjaira menedzsment eszközöket biztosít.

2. Alapfogalmak

• Repository (raktár) -- egy tároló (általában könyvtár), ami a fájlok fő, vagy mester példányit tárolja. A repository helyét a $CVSROOT környezeti változóval határozhatjuk meg. Minden projekt, amit CVS felügyelet alá helyeztünk, a $CVSROOT alatt elhelyezkedő megfelelő alkönyvtárban foglal helyet. A CVS lehetőséget add távoli repository: pl. CVSROOT=:pserver:mohacsi@hydra.ik.bme.hu:/tipster6

  

• Module (modul)-- a CVS egyik logikai egysége. Általában egy modult használunk projektenként. A modulokat a $CVSROOT/CVSROOT/modules könyvtárban definiálhatjuk.
• Check out (munkamásolat kérése) -- egy vagy több fájl kimásolása a repository-ból a (helyi) munkakönyvtárunkba megtekintési vagy módosítási célzattal.
• Commit (jóváhagyás) -- a módosítások érvényrejuttatása a repository-ban. A jóváhagyáskor néhány sorban leírjuk, hogy mit változtattunk fájlokon. A változásokról csak a commit után értesül a többi fejlesztő!
• Revision -- egy fájlcsoport adott változata (verziója).
• Revision number -- egy numerikus szimbólum amely egy fájlcsoport adott változatának jelölésére. A revision number számpárok sorozata, ponttal ('.') elválasztva. Alapértelmezésben 1.1-ről indul. Elágaztatatáskor a kiinduló változathoz egy újabb pár adódik hozzá.
• Branch (ág) -- fejlesztési útvonal, ami közös ős-változattól kiinduló fájl-csoportok változataiból áll. Akkor használható, ha többágú fejlesztést végzünk, illetve többféle terméket állítunk elő ugyanabból a szoftverből.
• Branch numbers -- numerikus szimbólum az ág azonosítására.
• Release (kibocsátási azonosító) -- egy azonosító, ami magához a szoftver termékhez, nem pedig a fájl-csoporthoz tartozik.
• Tag (cédula) -- egy változat alfanumerikus neve.
• Merge (összefésülés)-- bármely eltérés beillesztése a saját másolatunkba.
• Conflict (konfliktus)-- olyan eltérés két változat között, amit a CVS nem tud feloldani. Ez általalában update vagy commit esetén fordul elő.
• Status -- egy CVS felügyet alatt álló fájl állapota. A munkamásolatokra vonatkozik. Lehetőségek:
  • up-to-date -- azonos a repository-ban lévő változattal.
  • locally modified -- a fájlt lokálisan módosították, így commit szükséges.
  • needing update -- valaki más módosított és commit-ált egy újabb változatot a repository-ba, de a lokális másolat még nem módosult.
  • needing merge -- valaki más módosított és commit-ált egy újabb változatot a repository-ba, és a lokális másolat is módosult.

3. Beállítások

CVSROOT környezeti változó beállítása:

(Ezt célszerű beletenni valamilyen inicializáló scriptbe)

Ezután be lehet lépni a CVS szerverre.

cvs login

Így a távoli gépen lehet dolgozni, nem kell a hydra-n. A CVSROOT beállítása helyett lehet minden parancs

-d :pserver:[username]@hydra.ik.bme.hu:/tipster6

kapcsolóval való ellátása is.

3.1 CVS Szintakszis

• [cvs-options] -- minden cvs-parancsra alkalmazható opció
• cvs-command -- a végrehajtandó cvs-parancs
• [command-options] és [command-arguments] -- a megadott cvs-parancsra vonatkozó opciók és argumentumok

4. Munka a CVS-ben

4.1 Munkamásolat kérése

cvs co tipster6

A tipster6-ról ad egy másolatot. Egy tipster6 könyvtárat csinál, oda másolja repositry tartalmát. A létrehozott CVS könyvtárban mindenféle menedzsment információt tárol, amit nem szabad bántani, különben nem fog sikerülni a commit.

4.2 Változtatás jóváhagyása

cvs commit akarmi.html

Jóváhagyja a fájl változtatásait. Csak akkor commit-áljunk, ha már lefogadható a változtatás. A commit elindit egy editort, amiben le kell írni, hogy milyen változtatás történt. Ez az editor alap esetben a 'vi'. Ha nem megfelelő, akkor CVSEDITOR környezeti változóval megváltoztatható

4.3 Munkamásolat felszabadítása

Az új szerkesztés megkezdése előtt célszerű letörölni a munkamásolatot.

cvs release -d tc

Ami a tc katalógust felszabaditja. Jelez, ha van olyan fájl, ami újabb, mint ami a repository-ban található. Így biztosan nem veszik el a munkánk.

4.4 Változatok közötti különbségek jelzése

cd papers

cvs diff index.html

A hagyományos diff-szerű kimenetet mutatja.

4.5 Revision number kezelés

Általában magától lépteti, ha változás történt. Azonos revision number-re hozás

cvs commit -r 3.0

, ami 3.0 -ra allitja.

4.6 Egyes változatok névvel cimkézése

cvs tag rel-0-4 index.html

4.7 Fájl státusának lekérdezése

cvs status index.html

4.8 Egy adott cimkéjű munkaváltozat lekérése

cvs checkout -r rel-1-0 papers

4.9 Fájlok frissítése a legfrissebb változatra

cvs update papers

Az adott fájlt vagy könyvtárat, rekurzívan. Minden nélkül az adott könyvtárt.

4.10 Fájl hozzáadása

Létrehozni a fájlt a munkaváltozatban, majd:

cvs add FILENAME

Ha a fájl bináris információt tartalmaz, akkor -kb paraméter is kell.

cvs commit FILENAME

Jováhagyás válik láthatóvá a többiek felé. Az add nem rekurzív.

4.11 Fájl törlése

Meg kell győzödni, hogy nincs különbség a repository-tól.

A munka másolatból fájl törlése. (rm)

cvs rm FILENAME

cvs commit FILENAME

A file törlődött. A korábbi változatok előszedhetők!

4.12 Könyvtár törlése

Először a fájlokat kell kitörölni, majd

cvs update -P

-vel törli az üres könyvtárakat.

4.13 Fájl átnevezés

mv OLD NEW

cvs remove OLD

cvs add NEW

cvs commit -m "Renamed OLD to NEW" OLD NEW

Az új revision numbere előlről kezdődik!

4.14 Kulcsszó kifejtés

A CVS képes a fájlokban található speciális kulcsszavakat az aktuális értékkel kifejteni. A fájlban: $KEYWORD$, és minden változásnál aktualizálja.

(Nem kell írni pl. a verziószámokat... )

5. Több fejlesztő együttes munkája

• A szokásos munka a frissítés (update -- a legutolsó munkaváltozat óta keletkezett repository-változtatások átvezetése a munkaváltozatba).
  • Ha a frissítés nem okoz konfliktust, azaz egy másik felhasználó csak olyan fájlokat módosított, amelyeket mi nem, akor nincs semmi teendőnk, ha csak az nem , hogy a fájlok közötti konzisztenciát kell ellenörízni.
  • Ha a összefésülés konfliktust okoz (conflicts, az RCS terminológiában overlaps), akkor a létrejövő fájl tartalmazza mindkét variánst figyelemfelkeltő jelekkel körbevéve:

  <összefésülhető kód eddig>
  <<<<<<<<fájlnév>
  <konfliktust okozó kódrészlet az egyik változatból>
  =======
  <konfliktust okozó kódrészlet a másik változatból>
  >>>>>>>
  <összefésülhető kód tovább.
  Manuálisan össze kell fésülnünk a két részletet, hogy a konfliktust fel tudjunk oldani.

• Kétféle konfliktus létezik:
  1. amikor a konfliktus a fájl ugyanazon a pontján történik (ezt észreveszi a CVS)
  2. működésbeli konfliktus, azaz amikor a konfliktus oka az, hogy az egyik fejlesztő más helyen módosította a kódot, mint a másik, és a két változat nem működik együttesen összefésülve. A működésbeli konfliktust a CVS a fejlesztő figyelmeztetése nélkül feloldja, így nem működő kódhoz vezethet. Ezért javasolt, hogy inkább minden változatot javítsunk ki manuálisan, és ne használjunk elágazásokat erre a célra.

6. CVS adminisztráció

Akinek irásjoga van valamire a CVS-ben, annak a valóságban is kell lennie! Legjobb egy csoportot csinálni, s annak a tulajdonába rakni az egész repositoryt.

6.1 Repository létrehozás

cvs init

6.2 Új CVS projekt kezdése

Nem igen ajánlott a könyvtárak és file-ok mozgatása, ezért előtte át kell gondolni a file-szerkezetet!

Könyvtár szerkezet elkészítése

cvs import -m "Initial import" yoyodyne/DIR yoyo start

A teljes könyvtárszerkezetet felrakja. Leírás:

import [-options] repository vendortag releasetag

Ahol:

repository    A konyvtar CVS alatt

vendortag    vendor

releasetag    release

7. Referenciák

CVS page http://www.loria.fr/~molli/cvs-index.html

CVS manual http://durak.org/cvswebsites/doc/

CVS book http://cvsbook.red-bean.com/

CVS leírás http://unicorn.sch.bme.hu/~kisza/prolab/leiras.txt

CVS for version management http://www.hut.fi/~kuparine/papers/cvs/cvs.html