SVN Windows Howto. Inhaltsverzeichnis. 1 Revisionsgeschichte

Transkript

1 Inhaltsverzeichnis SVN Windows Howto DI Werner Damböck (2008) public: svn:// /et/howto/svn-howto-htl-et.pdf source: svn:// /damb/howto/svn-howto-htl-et.odt 1 Revisionshierarchie Grundlagen Wozu svn? Was gehört auf den SVN-Server Installation Begriffe Richtlinien Vorgänge Checkout Explorer Integration Commit Update Add und Funktionen an nicht verwalteten Dateien Delete und Funktionen an Dateien unter Versionsverwaltung Funktionen an Verzeichnissen unter Versionsverwaltung HTL SVN Repositories Server: Repositories FAQ Revisionsgeschichte Revision Datum Bemerkung Bearbeitet von Grundversion DAMB Versionskonflikte DAMB /home/damboeck/svn/damb/howto/svn-howto-htl-et.odt

2 2 Grundlagen 2.1 Wozu svn? Zentrale Verwaltung und Speicherung von oft verwendeten Daten automatische Datensicherung, da die Daten immer am Server und als lokale Kopie vorliegen Dokumentzustände können von jedem vergangenen Zeitpunkt jederzeit wiederhergestellt werden svn arbeitet im Dateisystem des PC weshalb keine komplizierte Weboberfläche benötigt wird gemeinsame Entwicklungsprojekte können durch mehrere Personen gleichzeitig bearbeitet werden 2.2 Was gehört auf den SVN-Server gehört auf den SVN kann am SVN sein sinnlos für SVN - Selbst erstellte Dokumente - Sourcecode - CAD Zeichnungen - Entwicklungsprojekte 2.3 Installation - kleiner Downloads welche vom Inhalt her zum svn passen - Bilder welche in eigene Dokumente eingebunden werden - kompilierte Programme - eigene fertige PDF-Dokumente - Große Downloads - Photos - Softwarepackete - Videos - Große Inhalte welche sich nicht mehr ändern Tortoise-SVN herunterladen, installieren und Rechner neu starten. download SVN findet man danach mittels der rechten Maustaste im Explorer. 2.4 Begriffe Repository: Verzeichnis auf dem SVN-Server wo die Daten verwaltet werden checkout: Erstmaliges kopieren der Daten vom Repository auf die lokale Festplatte Repository checkout leeres Verzeichnis update: aktuelle Daten vom Server auf die lokale Festplatte holen Repository update lokale Kopie commit: lokale Änderungen auf das Repository kopieren Repository commit PC DI Werner Damböck (2008) svn-howto-htl-et.odt 2-8

3 add: Erstellt man eine Datei in einem Verzeichnis welches unter Versionsverwaltung steht so ist diese nicht automatisch auch unter SVN- Verwaltung. Erst durch add wird die Datei in die Versionverwaltung integriert. Mittels add wird die Datei noch nicht aufs Repo kopiert! Dies erfolgt erst durch ein folgendes commit! delete: Um eine Datei zu löschen genügt es nicht sie einfach im Explorer zu löschen, da sie beim nächste update wieder vorhanden wäre. Nur mittels svn- delete wird die Datei aus der Versionsverwaltung entfernt und von der Platte gelöscht. Wie bei add wird die Datei erst durch ein folgendes commit vom Repository gelöscht. Revision: bei jeder Änderung welche mittels commit auf das Repository kopiert wird wird die Revisionsnummer um eins erhöht. Versionskonflikt (kein update oder commit möglich): tritt beim update auf wenn: lokale Änderungen der betroffenen Datei vorliegen, noch kein commit der Änderungen gemacht wurde und an der gleichen Datei Änderungen im Repository vorliegen tritt beim commit auf wenn: lokale Änderungen der betroffenen Datei vorliegen und an der gleichen Datei Änderungen im Repository vorliegen Versionskonflikte müssen vom Benutzer per Hand aufgelöst werden! 2.5 Richtlinien Keine Umlaute oder Sonderzeichen in Dateinamen verwenden dies führt auf verschiedenen Betriebssystemen zu Problemen Tritt auf einem gemeinsamen Repository ein Verzeichnis mit einem Lehrerkurzzeichen auf gilt als vereinbart, dass alle Lehrer die Daten verwenden können aber nur der Lehrer mit dem Verzeichnisnamen darf die Daten verändern (Ausnahme ist die Korrektur von offensichtlichen Fehlern) Keine Verzeichnise oder Dateien verwenden welche sich nur durch die Groß- Kleinschreibung unterscheiden verwenden Dies führt auf Windows-PCs zu Problemen. Dateien welche unter Versionsverwaltung stehen dürfen nicht umbenannt werden! (FAQ) Bitte keine Großbuchstaben und Leerzeichen in Dateinamen und Verzeichnissen verwenden! Bevor man mit Arbeiten an Dateien beginnt immer mittels Update die aktuelle Version vom Repo holen! Nach einer Änderung immer mittels Commit die Dateien aufs Repo spielen! Je kürzer die Zeit zwischen Update und Commit ist, desto geringer ist die Wahrscheinlichkeit dass ein Versionskonflikt auftritt! DI Werner Damböck (2008) svn-howto-htl-et.odt 3-8

4 2.6 Vorgänge Checkout URL: Adresse gefolgt vom Repository Man kann auch Unterverzeichnisse eines Repos auschecken Checkout directory: Ziel auf der lokalen Festplatte In diesem Verzeichnis werden im versteckten Verzeichnis.svn die Informationen über die Versionsverwaltung gespeichert Revision: Man kann entweder die aktuelle Revision(HEAD revision) oder eine alte Revision auschecken. Show Log: Hier kann man die Versionshierarchie aller Revisionen einsehen um alte Revisionen zu finden Explorer Integration Steht eine Datei oder ein Verzeichnis unter Versionsverwaltung so befindet sich ein grüner Punkt mit einem Haken auf dem Icon im Explorer. Eine veränderte Datei oder ein Verzeichnis welche eine veränderte Datei enthält wird durch einen roten Punkt mit Rufzeichen gekennzeichnet Commit Beim Commit erhält man eine Dialogbox mit allen Veränderungen seit dem letzten Update. Hier kann man auch neue Dateien für ein add anwählen. DI Werner Damböck (2008) svn-howto-htl-et.odt 4-8

5 2.6.4 Update Vor jedem Arbeiten mit Daten aus dem SVN-System sollte man mittels Update die Daten vom Repository aktuelisieren Add und Funktionen an nicht verwalteten Dateien Eine Datei welch nicht unter Versionsverwaltung steht enthält angegebenes Menü beim Anklicken mit der rechten Maustaste im Explorer add fügt die Datei der SVN-Verwaltung hinzu Add to ignore list hält die Datei dauerhaft von der SVN-Verwaltung fern Delete und Funktionen an Dateien unter Versionsverwaltung Dateien welche unter Versionsverwaltung stehen seht neben update und commit noch das angegeben Menü zur Verfügung Show log zeigt alle Änderungen an der Datei in chronologischer Folge an Repo-browser zeigt alle Dateien welche zum Repo gehören an Update to revision gilt nur für die angewählte Datei und nicht für das übergeordnete Verzeichnis Delete löscht die Datei von der SVN-Verwaltung und vom lokalen System Merge führt verschieden Revisionen zusammen siehe Doku Funktionen an Verzeichnissen unter Versionsverwaltung Delete löscht das Verzeichnis von SVN und lokal Clean up Nach einen Abbruch von Update oder Commit notwendig um weiterarbeiten zu können Repo-browser zeigt Info über alle Dateien des Repos Show log zeigt die Versionsgeschichte des Verzeichnisses add fügt neue Dateien innerhalb des Verzeichnisses zu SVN hinzu DI Werner Damböck (2008) svn-howto-htl-et.odt 5-8

6 2.6.8 Versionskonflikt beim Commit auflösen Tritt auf wenn man eine Datei verändert hat und seit dem letzten Update eine andere Person(oder Computer) an der gleichen Datei Änderungen vollzogen und bereits commited hat. Man erhält dann in etwa folgende Meldung beim commit: Vorgehensweise: 1. Benenne die betroffene Datei in einen neuen Dateinamen als Sicherheitskopie um (im Explorer) 2. hole die aktuelle Version mittels Update vom Repository (nun ist die Datei welche vorher umbenannt wurde wieder vorhanden, jetzt jedoch in der aktuellen Version vom Repo) 3. Ziehe die Änderungen welche an der Datei vorgenommen wurden in der aktuellen Datei nach ( Als Hilfestellung kann man die in 1. erstellte Sicherheitskopie verwenden) 4. Sicherheitskopie aus 1. löschen (im Explorer da diese ja nicht unter SVN-Verwaltung steht) 5. Commit der jetzt korrekten Datei DI Werner Damböck (2008) svn-howto-htl-et.odt 6-8

7 :08:41 HTL SVN Repositories 3 HTL SVN Repositories 3.1 Server: svn:// Repositories REPO Beschreibung Benutzer(Rechte) et Wird auf k:\svn\et ausgecheckt lehrer(rw),alle(r) et/howto et/programme et/vorlagen et/skripten abteilung abteilung/formulare abteilung/skripten cad cad/proteus/lib cad/proteus/template labor localtexmf mathcad programmieren schueler Keine Arbeitsversionen nur Kopien Wird einmal täglich auf k:\vorlagen ausgecheckt Skripten die alle Schüler immer lesen können Datenaustausch zwischen Abteilung und Lehrern Formulare vom AV Skriptenaustausch zwischen Lehrern, hier sind keine Arbeitsversionen sondern nur Kopien der Skripten Laborvorbesprechungen und Beispielprotokolle tex Makros und Einstellungen wird auf k:\localtexmf ausgecheckt Verzeichnisse für Schülernutzung lehrer(r), bine(rw) lehrer(rw) lehrer(r),damb(rw) alle(r),damb(rw),mayg(rw),meis(rw) lehrer(rw) lehrer(r), damb(rw), scub(rw), spee(rw), haag(rw) lehrer(rw) lehrer(rw) test Für Versuchszwecke alle(rw) uc-koffer tex Latex Dokumente lehrer(rw) damb(rw),proteusteam(rw),alle(r) DI Werner Damböck (2008) svn-howto-htl-et.odt 7-8

8 :08:41 FAQ 4 FAQ Wie kann man eine Datei umbenennen? 1. Datei in den neuen Dateinamen kopieren 2. Alte Datei mit SVN-delete löschen 3. Die in 1. kopierte Datei mit SVN-add neu hinzufügen 4. Commit Wie kann man bei einer Datei die Groß-Kleinschreibung verändern? 1. Datei in einen beliebigen neuen Dateinamen kopieren 2. Alte Datei mit SVN-delete löschen 3. Die in 1. kopierte Datei in den ursprünglichen Dateinamen jedoch mit der neuen gewünschten Groß-Kleinschreibung umbenennen 4. Die Datei mit SVN-add neu hinzufügen 5. Commit Was macht man bei einem Versionskonflikt beim Update? Dies tritt auf wenn man lokale Änderungen gemacht hat und diese nicht mit Commit auf das Repo gespielt hat. Die Vorgehensweise ist somit genauso wie bei Versionskonflikten beim Commit. Wie kann man ein bestehendes lokales Verzeichnis unter Versionsverwaltung bekommen? 1. Auschecken eines Repos in welches das bestehende Verzeichnis gespeichert werden soll 2. kopieren des bestehenden Verzeichnisses in das gewünschte Unterverzeichnis des zuvor ausgecheckten Repos 3. Mittels Add alle Dateien und Verzeichnisse des vorher kopierten Verzeichnisses zu dem Repo hinzufügen (natürlich nur die gewünschten, keine temporären Dateien usw.) 4. Commit Kann man auch ein privates Repository am SVN-Server beitreiben wo sonst keiner lesen kann? Ja, nach Rücksprache mit Koll. Damböck oder Schubert. Können die Zugriffsrechte innerhalb eines Repositories verändert werden? Ja, aber nur durch Koll. Damböck oder Schubert. DI Werner Damböck (2008) svn-howto-htl-et.odt 8-8