CVS-Einführung. Sebastian Mancke,

Transkript

1 CVS-Einführung Sebastian Mancke,

2 Grundlagen Motivation und Anforderung Sobald ein Softwaresystem anwächst, ergeben sich Probleme im Umgang mit dem Quell Code. CVS (Concurrent Versions System) ist ein Versions Kontroll System zur Verwaltung von Code. Es leistet folgendes: Versionierung aller Änderungen Pflege verschiedener paralleler Versionsstränge Entwickeln mit mehreren Entwicklern, sogar gleichzeitig an einer Datei Vernetzter Zugriff und Administration CVS-Einführung, Sebastian Mancke 1

3 Grundlagen Aufbau auf Diff und Patch CVS arbeitet auf der Grundlage von den Tools diff und patch. Wenn eine Datei geändert wird, speichert das System nur die Änderungen. Dadurch.... muss für jede Datei auch nur eine Datei und deren Änderungen gespeichert werden... vertragen sich gleichzeitige Änderungen einer Datei meistens... müssen Text- und Binärdateien verschieden behandelt werden... können beliebige Versionen einer Datei rekonstruiert werden. CVS-Einführung, Sebastian Mancke 2

4 Grundlagen CVS Repository und Module Das Verzeichnis mit allen Dateien, die zu einem Projekt gehören, heißt Modul. Den Ort, in dem die Module gespeichert werden, nennt man CVS Repository. Das Repository enthält das Unterverzeichniss CVSROOT für Historyund Zugriffsdateien. Sowie ein Unterverzeichniss für jedes Modul. Ein Repository kann lokal vorhanden sein, oder auf einem Server liegen. CVS-Einführung, Sebastian Mancke 3

5 CVS-Kommandos Arbeiten mit cvs (1) Arbeiten mit CVS haben meist einen typischen Ablauf: 1. Erstellen oder aktualisieren einer lokalen Kopie der Dateien. 2. Bearbeiten und neu Anlegen der Dateien auf der lokalen Kopie. 3. Einspielen der Änderungen ins Repository. CVS-Einführung, Sebastian Mancke 4

6 CVS-Kommandos Arbeiten mit cvs (2) Es gibt zahlreiche Clients, die mit CVS umgehen können. Letztendlich verwenden aber alle die gleichen Befehle wie das original Komandozeilentool cvs. Viele bauen sogar direkt darauf auf. Im Folgenden wird die grundlegende Funktionalität von cvs erläutert. Mit dem Verständnis sollten sich dann alle Clients leicht bedienen lassen. CVS-Einführung, Sebastian Mancke 5

7 CVS-Kommandos cvs - Grundlegende Benutzung cvs [cvs-optionen] <befehl> [befehls-optionen-und-argumente] Wichtige cvs Optionen: -d CVSROOT Angabe des Repositorys (Default: $CVSROOT) -z level Kompressionslevel für Übertragungen (0-6) Eine Liste aller Befehle: cvs --help-commands Hilfe zu einem Befehl: cvs -H <befehl> CVS-Einführung, Sebastian Mancke 6

8 CVS-Kommandos cvs login/logout Ein- und ausloggen macht nur in Verbindung mit pserver Sinn, da sonst die Verbindung eines externen Dienstes benutzt wird. cvs login: Fragt nach einem Passwort, das dann mit dem Repository Bezeichner in der Datei /.cvspass abgelegt wird. cvs logout: Entfernt den Eintrag aus der Datei /.cvspass. CVS-Einführung, Sebastian Mancke 7

9 CVS-Kommandos Starten eines Projektes - cvs import cvs import <Modulname> <Vendor-Tag> <Release-Tag> Der Befehl erstellt ein neues Modul und importiert rekursiv alle Dateien im aktuellen Verzeichnis. Vendor-Tag und Release-Tag müssen angegeben werden. Ihr Inhalt spielt aber keine direkte Rolle. Danach sollten die original Dateien gelöscht und neu ausgecheckt werden. CVS-Einführung, Sebastian Mancke 8

10 CVS-Kommandos Arbeitskopie holen - cvs checkout cvs checkout <Modulname> oder cvs co <Modulname> Erstellt eine Kopie aller Dateien des Modules im aktuellen Verzeichnis. Diese können jetzt bearbeitet werden. CVS sperrt die ausgecheckten Dateien nicht. Mehrere Personen können gleichzeitig auschecken und bearbeiten. Das kann aber auch zu Problemen führen. Wichtige Optionen: -P Es werden keine leeren Verzeichnisse angelegt -D Stand zu einem bestimmten Datum -r Bestimmte Revision CVS-Einführung, Sebastian Mancke 9

11 CVS-Kommandos Änderungen speichern - cvs commit cvs commit oder cvs com Überträgt Änderungen an das CVS. Viele cvs Befehle wirken sich nicht direkt aus, sondern werden erst beim nächsten cvs commit wirklich ausgeführt. Wichtige Optionen: -r Revisionszweig, unter dem die Änderungen abgelegt werden sollen CVS-Einführung, Sebastian Mancke 10

12 CVS-Kommandos Aktualisieren - cvs update cvs update oder cvs up Bringt das Arbeitsverzeichnis auf den aktuellen Stand. Dabei werden die lokalen Dateien je nach Bedarf gepatcht oder gemerged. Wichtige Optionen: -P Es werden keine leeren Verzeichnisse angelegt -D Benutzt den Stand zu einem bestimmten Datum -r Benutzt eine bestimmte Revision CVS-Einführung, Sebastian Mancke 11

13 CVS-Kommandos Hinzufügen - cvs add cvs add <Dateiliste> Meldet neue Dateien oder Verzeichnisse zur Verwaltung im CVS an. Die Aktion wird erst beim nächsten cvs commit ausgeführt. Wichtige Optionen: -kb Für Dateien mit binärem Inhalt CVS-Einführung, Sebastian Mancke 12

14 CVS-Kommandos Dateien Entfernen - cvs remove cvs remove [<Dateiliste>] Entfernt die angegebenen Dateien aus dem CVS. Sie müssen vorher lokal gelöscht sein. Ohne Angabe einer Dateiliste werden rekursiv alle Dateien entfernt, die lokal gelöscht wurden. Verzeichnisse können nicht gelöscht werden. Sie existieren im CVS immer weiter, da sie noch die Dateien von alten Versionen beinhalten. Die Aktion wird erst beim nächsten cvs commit ausgeführt. CVS-Einführung, Sebastian Mancke 13

15 CVS-Kommandos Verschieben und Umbenennen Da Dateien für alte Versionen unter ihrem alten Namen weiter bestehen bleiben müssen, ist es nicht möglich sie zu verschieben oder ihren Namen zu ändern. Um dies zu erreichen, müssen sie im CVS gelöscht und neu angelegt werden. Dadurch sind umfangreiche Umstrukturierungen der Daten im CVS oft aufwändig. CVS-Einführung, Sebastian Mancke 14

16 Erweiterte Konzepte Revisions Nummern Jede Datei, die vom CVS verwaltet wird, besitzt eine Revisionsnummer, die aus mehreren, durch Punkte getrennten, Ziffern besteht. (z.b. 1.2 oder ) Sie wird bei jeder Änderung an der jeweiligen Datei erhöht. Diese Nummern werden vom CVS automatisch vergeben und können bei allen Dateien unterschiedlich sein. Daher macht es keinen Sinn sie für die eigene Software Versionierung zu verwenden. CVS-Einführung, Sebastian Mancke 15

17 Erweiterte Konzepte Tags Für die Versionierung eines Projektes können Dateien und deren Revisionen mit symbolischen Versionsnamen versehen werden, den Tags. cvs tag <Tagname> [<Dateiliste>] Gibt allen Dateien in ihrer aktuellen Revision das entsprechende Tag. cvs co -r <Tagname> <Modulname> Checkt von allen Dateien den Stand des angegebenen Tags aus. Auf diese Weise kann ein bestimmter Entwicklungsstand, wie z.b. ein Software Release identifiziert werden. CVS-Einführung, Sebastian Mancke 16

18 Erweiterte Konzepte Branching Für verschiedene parallele Entwicklungsstränge gibt es das Konzept der Branches. Damit ist es möglich Änderungen zu machen, die nicht in allen Versionen auftreten. cvs tag -b <Tagname> [<Dateiliste>] Legt einen neuen Branch an, auf den dann mit der -r Option zugegriffen werden kann. Anwendung: Um ein altes Release zu pflegen (z.b. Bugfixes), werden Änderungen nur in einem speziellen Ast gemacht, ohne in den Haupt Code direkt einzufließen. CVS-Einführung, Sebastian Mancke 17

19 Erweiterte Konzepte Merging Um die Änderungen, die isoliert in einem Branch gemacht wurden in anderen Versionen zu haben, können verschiedene Stränge wieder zusammengeführt (merging) werden. cvs update -j <Tagname-des-Branches> Mischt die Änderungen, die in dem Branch gemacht wurden in die Version im aktuellen Arbeitsverzeichnis. CVS-Einführung, Sebastian Mancke 18

20 Zugriff auf das CVS Zugriff auf das CVS-Repository (1) Auf ein Repository kann mit einem Bezeichner verwiesen werden: Dieser wird mit der Option -d oder in der Umgebungsvariablen CVSROOT angegeben. Lokal: Der Repository Bezeichner ist nur der Pfad. Der Benutzer muss Berechtigungen auf den Dateien haben. CVS-Einführung, Sebastian Mancke 19

21 Zugriff auf das CVS Zugriff auf das CVS-Repository (2) Remote über rsh: Verbindung über rsh, ssh oder ähnliches Programm. Auf dem Remote Rechner wird mit den dortigen Berechtigungen gearbeitet. Zugriffsmethode im Repository Bezeichner ist ext. Die Umgebungsvariable CVS RSH muss den Namen des Programms für den Remote Zugriff enthalten (z.b. ssh). CVS-Einführung, Sebastian Mancke 20

22 Zugriff auf das CVS Zugriff auf das CVS-Repository (3) Direkte Verbindung mit Passwort: Mit einem Serverprozess wird über ein passwortgeschütztes Protokoll eine direkte Verbindung aufgenommen. Zugriffsmethode im Repository Bezeichner ist pserver. Nur der Besitzer des Serverprozesses benötigt Berechtigungen auf den Repository Dateien. Auf dem Server muss eine Passwortdatei für alle CVS Benutzer existieren. Das Verfahren hat einige Sicherheitsprobleme (z.b. wird das Passwort in /.cvspass gespeichert). CVS-Einführung, Sebastian Mancke 21

23 Clients Grafische Clients Es gibt eine Reihe grafischer Clients, die alle recht ähnlich sind. Hier werden ein paar frei verfügbare vorgestellt. WinCVS ist recht üppig, aber teilweise etwas irreführend und unübersichtlich. (Windows) LinCVS ist gut, hat aber wenig features. (Linux) Cervisa bringt ein nettes Konqueror Plugin mit. (Linux) jcvs bietet eine gute Übersicht. (Java) CVS-Einführung, Sebastian Mancke 22

24 Clients Integration in Entwicklungsumgebungen Da sich CVS immer größerer Beliebtheit erfreut, ist es in fast alle Entwicklungsumgebungen direkt integriert. Für die Integration in NetBeans wurde extra eine eigene Java CVS Libary realisiert, die auch frei verfügbar ist. CVS-Einführung, Sebastian Mancke 23

25 Clients Weitere Dokus und Links Dokumentation - Offizielle CVS Seite - Refferenz Handbuch Software - cvs - wincvs - lincvs - jcvs cervisia.sourceforge.net - cervisia CVS-Einführung, Sebastian Mancke 24