Versionsverwaltung mit SVN

Transkript

1 Ingo Sieverdingbeck Jasper van den Ven AG Rechnernetze Universität Bremen C/C++-Vorkurs 2008

2 Gliederung 1 Wozu Versionsverwaltung? Ältere Systeme SVN 2 3 Verteilte Versionsverwaltung Beispiel Mercurial 4

3 Gliederung 1 Wozu Versionsverwaltung? Ältere Systeme SVN 2 3 Verteilte Versionsverwaltung Beispiel Mercurial 4

4 Gliederung 1 Wozu Versionsverwaltung? Ältere Systeme SVN 2 3 Verteilte Versionsverwaltung Beispiel Mercurial 4

5 Gliederung 1 Wozu Versionsverwaltung? Ältere Systeme SVN 2 3 Verteilte Versionsverwaltung Beispiel Mercurial 4

6 Wozu Versionsverwaltung? Wozu Versionsverwaltung? Ältere Systeme SVN Was habe ich geändert? Alles Quatsch, ich will zurück! Wer hat zuletzt die Datei foo geändert? Was hat sich seit xx.yy.zzzz geändert?...

7 Wozu Versionsverwaltung? Ältere Systeme SVN Ältere Versionsverwaltungssysteme RCS CVS nur für einzelne Dateien Speicherung von Daten in speziellem Verzeichnis (RCS) gleichzeitige Bearbeitung nicht möglich nicht netzfähig Verwaltung von Verzeichnissen Speicherung der Daten in zentralem Repository mehrere working directories/working copies Zugriffe auf das Repository auch über ein Netz möglich gleichzeitige Bearbeitung möglich. CVS mergt die Änderungen zusammen

8 Subversion Wozu Versionsverwaltung? Ältere Systeme SVN Nachfolger von CVS Änderungen in der internen Datenstruktur des Repositories diverse Detailverbesserungen

9 Subversion (SVN) Wozu Versionsverwaltung? Ältere Systeme SVN Verwaltet alle Änderungen an Dateien und Verzeichnissen in Revisionen Nummerierung der Revisionen beginnend bei 0 aufsteigend. Revisionen beziehen sich immer auf das gesamte Repository, auch wenn nur einzelne Dateien geändert wurden Versionsgeschichte bleibt auch bei gelöschten Dateien erhalten Dateien können wiederhergestellt werden Logmessages der Bearbeiters sind für einzelne Dateien oder Verzeichnisse, sowie für einzelne oder alle Revisionen abrufbar Ermöglicht gleichzeitiges Bearbeiten von Dateien Bietet Erkennung und Behandlung von n

10 mit SVN Initial einmalig Daten aus dem Repository beziehen (checkout) Änderungen aus dem Repository beziehen (update) (Editieren) Änderungen ins Repository übertragen (commit)

11 svnadmin create <pfad> dient dem Erzeugen der nötigen Daten- und Dateistrukturen idealerweise in ein leeres Verzeichnis ggf Anpassung der Gruppe mit chgrp nötig möglicherweise ist das Repository nicht für Gruppenmitglieder schreibbar. Bei Bedarf durch chmod anpassen

12 svnadmin create <pfad> dient dem Erzeugen der nötigen Daten- und Dateistrukturen idealerweise in ein leeres Verzeichnis ggf Anpassung der Gruppe mit chgrp nötig möglicherweise ist das Repository nicht für Gruppenmitglieder schreibbar. Bei Bedarf durch chmod anpassen

13 Checkout svn co <repository-url> im Zielverzeichnis aufrufen file:///pfad/zum/repo für lokale Repositories für Repositories, die über SSH bezogen werden sollen für Repositories, die über HTTPS bezogen werden sollen einmalig nötig, um eine Arbeitskopie aus der gerade aktuellen Revision zu erzeugen es kommt zu Problemen, wenn Dateien in der aktuellen Revision existieren, die bereits lokal an gleicher Stelle ohne Versionskontrolle vorhanden sind

14 Checkout svn co <repository-url> im Zielverzeichnis aufrufen file:///pfad/zum/repo für lokale Repositories für Repositories, die über SSH bezogen werden sollen für Repositories, die über HTTPS bezogen werden sollen einmalig nötig, um eine Arbeitskopie aus der gerade aktuellen Revision zu erzeugen es kommt zu Problemen, wenn Dateien in der aktuellen Revision existieren, die bereits lokal an gleicher Stelle ohne Versionskontrolle vorhanden sind

15 Update svn up im Zielverzeichnis aufrufen bezieht Änderungen aus dem Repository sollte immer unmittelbar vor einem Commit gemacht werden man kann auch gezielt auf eine bestimmte Revision updaten, siehe svn help up

16 Update svn up im Zielverzeichnis aufrufen bezieht Änderungen aus dem Repository sollte immer unmittelbar vor einem Commit gemacht werden man kann auch gezielt auf eine bestimmte Revision updaten, siehe svn help up

17 Dateioperationen mit SVN Dateien oder Verzeichnisse unter Versionskontrolle stellen: svn add <datei> <datei>... Dateien oder Verzeichnisse löschen: svn rm <datei> <datei>... Die Dateien werden auch lokal gelöscht Dateien oder Verzeichnisse innerhalb der Arbeitskopie kopieren: svn cp <datei> <datei>... Dateien oder Verzeichnisse innerhalb der Arbeitskopie verschieben: svn mv <datei> <datei>...

18 Commit svn ci in einem Verzeichnis innerhalb der working copy svn ci <Datei oder Verzeichnis>... für ausgewählte Änderungen überträgt lokale Änderungen ins zentrale Repository eine nicht leere Logmessage gehört normalerweise zum guten Ton und erleichtert den Überblick über die Änderungen vor jedem Commit ein Update der Arbeitskopie

19 Commit svn ci in einem Verzeichnis innerhalb der working copy svn ci <Datei oder Verzeichnis>... für ausgewählte Änderungen überträgt lokale Änderungen ins zentrale Repository eine nicht leere Logmessage gehört normalerweise zum guten Ton und erleichtert den Überblick über die Änderungen vor jedem Commit ein Update der Arbeitskopie

20 Logs lesen svn log in einem Verzeichnis, das Teil einer working copy ist svn log <Datei oder Verzeichnis> für eine Datei oder ein Verzeichnis svn log <Datei oder Verzeichnis> -r n:m zeigt die Logs für die Revisionen n bis m zeigt die Logmessages und die Bearbeiter einer Datei oder eines Verzeichnisses an evtl ist die Nutzung von less sinnvoll

21 Logs lesen svn log in einem Verzeichnis, das Teil einer working copy ist svn log <Datei oder Verzeichnis> für eine Datei oder ein Verzeichnis svn log <Datei oder Verzeichnis> -r n:m zeigt die Logs für die Revisionen n bis m zeigt die Logmessages und die Bearbeiter einer Datei oder eines Verzeichnisses an evtl ist die Nutzung von less sinnvoll

22 Unterschiede ansehen svn diff zeigt alle lokalen Änderungen im gerade aktuellen Verzeichnis und Unterverzeichnissen svn diff <Datei oder Verzeichnis> zeigt die lokalen Änderungen für die angegebenen Datei svn diff -r n:m zeigt alle Änderungen zwischen Revision n und m im gerade aktuellen Verzeichnis und Unterverzeichnissen svn diff <Datei oder Verzeichnis> -r n:m zeigt die Änderungen zwischen Revision n und m für die angegebenen Datei zeigt einen Diff an (Ausgabe ähnlich zur Ausgabe von diff)

23 Unterschiede ansehen svn status zeigt geänderte, gelöschte oder hinzugefügte Dateien und Verzeichnisse an svn revert <Datei> macht alle lokalen Änderungen für die angegebene Datei rückgängig

24 Editierkonflikte entstehen, wenn zwei Personen gleichzeitig in einer Datei editieren und SVN die Änderungen nicht zusammenmergen kann bei Binärdateien, z.b. den meisten Grafikformaten bei Textdateien bei Änderungen in der selben Zeile werden dadurch ermöglicht, dass es SVN erlaubt, gleichzeitig an der selben Datei zu arbeiten

25 Behandlung durch SVN SVN weist auf den Konflikt hin erzeugt im Normalfall drei zusätzliche Dateien pro Datei in Konflikt eine für die alte Revision der Arbeitskopie eine für die gerade per update erhaltene Revision eine Kopie der Arbeitskopie der Datei alle werden in speziellem Format in die ursprüngliche Datei eingetragen ermöglicht Lösen der mit einfachem Editor praktisch alle grafischen Clients führen den Nutzer durch die Konfliktauflösung

26 Konfliktvermeidung Sourcedateien sinnvoll aufteilen in C++: eine Klasse pro Header, Deklaration in den Header, Implementierung in Sourcedateien in TeX, o.ä.: mit Includes arbeiten verringert die Wahrscheinlichkeit, dass zwei Personen in der selben Datei arbeiten z.b. in LateX Zeilenumbrüche statt überlanger Zeilen verwenden erleichtert SVN das Mergen

27 Was sollte unter Versionkontrolle? Sourcedateien (z.b. *.tex, *.h, *.cc) Konfigurationsdateien (z.b. Makefiles) Dokumentation Testdaten/-skripte Was nicht? Maschinengeneriertes (z.b. *.o, *.ps, *.pdf) Binärdateien. Ausnahmen: nicht aus dem Repository Wiederherstellbares, also externe Bibliotheken, PDF- oder PS-Dokumenten die meisten Grafikformate

28 Locking Nötig wenn Dateien geändert werden müssen, die nicht durch SVN gemergt werden können (z.b. die meisten Grafikformate) Unter RCS dass normale Vorgehen, unter SVN möglich aber sehr unüblich Lock mit: svn lock <Datei> Unlock durch commit (s.o.) oder durch: svn unlock <Datei> Lock ist nicht sicher, d.h. er kann gestohlen oder explizit ignoriert werden.

29 Clients Kommandozeileninterface (svn) TortoiseSVN (Explorerintegration, nur Windows) SmartSVN (Java, Linux, MacOS, Windows) RapidSVN (Linux) Eclipse-Plugin zahlreiche weitere Clients

30 Probleme mit SVN Verteilte Versionsverwaltung Beispiel Mercurial Problem mit SVN Offline arbeiten Zentrales Repository

31 Verteilte Versionsverwaltung Beispiel Mercurial Die Lösung: Verteilte Versionsverwaltung Lokale Repositories (und Globales Repository) Eine Auswahl der bekanntesten Kandidaten Git (Verwaltung des Linux-Kernels) Bazaar (Entwicklung von Open-Source-Projekten) Mercurial (Relativ einfach in der Bedienung)

32 Verteilte Versionsverwaltung Beispiel Mercurial Die Lösung: Verteilte Versionsverwaltung Lokale Repositories (und Globales Repository) Eine Auswahl der bekanntesten Kandidaten Git (Verwaltung des Linux-Kernels) Bazaar (Entwicklung von Open-Source-Projekten) Mercurial (Relativ einfach in der Bedienung)

33 Mercurial Verteilte Versionsverwaltung Beispiel Mercurial Warum Mercurial als Beispiel? Relativ einfach, da sehr ähnlich zu SVN (fast identischer Befehlssatz) Es gibt bereits gut funktionierende Versionen für fast alle Betriebssysteme Wichtige Unterschiede zu SVN Ein lokales und mehrere (mögliche) entfernte Repositories Nummerierung von Versionen Revision vs. Changesets 3:0a004 ( revision number : changeset identifier )

34 Mercurial Verteilte Versionsverwaltung Beispiel Mercurial Warum Mercurial als Beispiel? Relativ einfach, da sehr ähnlich zu SVN (fast identischer Befehlssatz) Es gibt bereits gut funktionierende Versionen für fast alle Betriebssysteme Wichtige Unterschiede zu SVN Ein lokales und mehrere (mögliche) entfernte Repositories Nummerierung von Versionen Revision vs. Changesets 3:0a004 ( revision number : changeset identifier )

35 Verteilte Versionsverwaltung Beispiel Mercurial Die wichtigsten Kommandos von SVN und Mercurial Das schwerste zuerst: hg statt svn svn create hg init svn checkout hg clone svn commit hg commit svn update hg update svn add hg add svn remove (delete, del, rm) hg remove svn status hg status svn log hg log svn revert hg revert svn help <command> hg help <command>

36 Verteilte Versionsverwaltung Beispiel Mercurial Weitere mercurialspezifische Kommandos hg pull hg merge (hg imerge) hg push hg rollback

37 Referenzen zum Nachschlagen RCS: aaronh/rcs/tichy1985rcs.html CVS: Subversion: Mercurial: Git: Bazaar: