Einfu hrung in Subversion mit TortoiseSVN

Transkript

1 Einfu hrung in Subversion mit TortoiseSVN Inhalt Konzept... 1 Begriffe... 1 Werkzeuge... 2 Arbeiten mit TortoiseSVN... 2 Vorbereitung... 2 Erster Checkout... 2 Hinzufügen eines neuen Verzeichnisses... 4 Commit... 5 Update... 6 Weitere Quellen... 7 Konzept Die Projektdaten liegen zentral auf einem Server. Die Teammitglieder greifen auf den Server zu und kopieren die Daten auf ihre lokale Festplatte. Initial muss der ganze Datenbestand vom Server kopiert werden, später genügt es, nur die Änderungen herunterzuladen. Wenn etwas geändert werden soll (Dateien editieren, Verzeichnisse anlegen, Daten löschen), muss das in der lokalen Kopie geändert und die Änderung zurück auf den Server geschrieben werden. Dann erst ist die Änderung für die anderen Teamkollegen sichtbar. Begriffe Repository Revision Working copy Checkout Daten werden in Repositories organisiert. Ein Repository enthält im Standardfall Daten für ein Projekt. Ein Repository muss auf dem Server angelegt werden, bevor es bearbeitet werden kann. Daten in einem Repository können in Verzeichnissen organisiert werden. Im Standardfall können nur Mitglieder einer freigeschalteten Benutzergruppe auf ein Repository zugreifen, sonst niemend. Ein Repository besteht aus Datenständen. Sie nennen sich Revisions. Hierbei handelt es sich um logische Abschnitte von Änderungen. Jede Änderung egal, ob Ändern oder Löschen von Daten verläuft nie destruktiv. Das heißt, dass die vorgegangenen Versionen im Repository nie überschrieben werden. Aus diesem Grund kann man immer nachvollziehen, wie der Datenbestand im Repository zu jedem beliebigen Zeitpunkt war, und auf ältere Versionen zurückgreifen. Lokale Kopie von Daten aus einem Repository nennt sich Working copy. Außer den Daten liegen in jedem Verzeichnis der Working copy Unterverzeichnisse Namens.svn, die man keinesfalls löschen soll. Damit ein Client Daten aus einem Repository bearbeiten kann, muss die Working copy einmalig erzeugt werden. Dabei werden Daten aus dem Repository auf die lokale Festplatte des Clients kopiert. Die Operation nennt sich Checkout.

2 Commit Update Lock Die Änderungen an Daten in der Working copy müssen noch auf den Server gelangen, damit die Änderung für alle Teammitglieder sichtbar ist. Diese Operation nennt sich Commit (oder Checkin) Wenn die Working copy aktualisiert werden muss, wird ein Update ausgeführt. Hierbei werden nur die Änderungen aus dem Repository in die Workign copy geladen. Um sicherzustellen, dass Änderungen an einer Datei nicht gleichzeitig von mehreren Personen gemacht werden können, muss der Client die Datei sperren. Die Operation nennt sich Lock. Um den anderen Teammitgliedern die Bearbeitung der betroffenen Datei wieder zu ermöglichen, gibt man die gesperrte Datei irgendwann wieder frei. Werkzeuge Die GFT Technologies AG hat zwei Subversion-Server in Deutschland: svn.gft.com in St.Georgen subwoofer.gft.com in Eschborn Als Standardclient hat sich TortoiseSVN etabliert. Die aktuelle Version von TortoiseSVN kann hier heruntergeladen werden: TortoiseSVN klinkt sich in Windows Explorer hinein und erweitert dessen Kontextmenü um ein paar spezifische Einträge. Zusätzlich signalisiert TortoiseSVN über den Status der Daten in der Working copy mit überlagerten Symbolen, wie auf dem Bild zu sehen: Arbeiten mit TortoiseSVN Vorbereitung Ein SVN-Repository muss seitens ITIS angelegt werden. Wenn das SVN-Repository angelegt worden ist, bekommen die Teammitglieder eine Adresse (ein URL), unter der sie auf das Repository zugreifen können. Außerdem muss die aktuelle Version von TortoiseSVN auf jedem involvierten Client installiert werden. Erster Checkout Mit der obigen Adresse wird die Working copy des Repository erzeugt. Hierzu klickt man mit der rechten Maustaste in einem leeren Verzeichnis und wählt in dem Popup-Menü den Punkt SVN Checkout aus:

3 In dem neuen Dialogfenster muss die Adresse des Repository eingetragen, die restlichen Elemente brauchen nicht geändert werden. Danach erscheint ein Anmeldedialog, in dem man seinen Domain Loginnamen und Passwort eingibt. Wenn alles richtig gemacht wurde, werden Daten vom Server heruntergeladen und in das Checkout directory kopiert: Die frische Working copy ist nun auf dem neusten Stand, wie uns das grüne Häkchen am Verzeichnis Symbol signalisiert:

4 Hinzufügen eines neuen Verzeichnisses Wir wollen ein neues Verzeichnis mit Daten ins Repository aufnehmen. Man geht in dem Fall wie folgt vor: Falls ein Verzeichnis mit Daten schon existiert, muss es in das Verzeichnis der Working copy kopiert werden. Sonst muss ein neues Verzeichnis im Windows Explorer erzeugt werden. Danach muss das neu angelegte Verzeichnis unter Verwaltung von TortoiseSVN gestellt werden. Hierzu muss das neue Verzeichnis mit der rechten Maustaste angeklickt und im Popup-Menü der Punkt TortoiseSVN- >Add ausgewählt werden. Nun erscheint ein Dialog, in dem man die im Verzeichnis liegenden Dateien aus- oder abwählen kann: Wenn TortoiseSVN das Verzeichnis und die darunterliegenden Dateien erfolgreich hinzufügen konnte, erscheint das Fenster wie unten:

5 Und das hinzugefügte Verzeichnis wird wie folgt markiert: Die hinzugefügten Daten sind aber noch nicht auf dem Server angekommen! Hierzu bemüht man die Operation Commit. Commit Um die Änderungen auf den Server zu schicken, wird Commit ausgeführt. Im Kontext-Menü des Windows Explorer (man erinnert sich: rechte Maustaste im Ordner der Working copy ) wählt man SVN Commit aus: Daraufhin öffnet sich ein Dialogfenster, in dem man die an den Server zu schickenden Änderungen nochmals überprüfen und einen Kommentar einfügen kann, damit die Teammitglieder wissen, aus welchem Grund die Änderung gemacht worden ist:

6 Nach einer Anmeldung werden die Änderungen an den Server geschickt. Wenn die Operation erfolgreich beendet wurde, ändert sich das Symbol am neuen Verzeichnis: Update Angenommen, wir wollen die Working copy auf den neusten Stand bringen, weil wir nicht ausschließen können, dass es auf dem Server Änderungen gibt, die von den anderen Teammitgliedern gemacht worden sind. In dem Fall führen wir die Operation Update aus. Sinnvollerweise klickt man das oberste Verzeichnis mit der rechten Maustaste an und in dem Kontextmenü wählt man SVN Update aus:

7 Nach einer Anmeldung werden ggf. Änderungen in die Working copy übernommen. Weitere Quellen TortoiseSVN Dokumentation auf Deutsch: Subversion Book: Subversion Home: