Software Versionsverwaltung mit SVN: Unterschied zwischen den Versionen

Version vom 22. Februar 2021, 16:50 Uhr

Einleitung

Als Software Versionsverwaltung nutzen wir an der HSHL Subversion (SVN). Subversion ist ein freies/Open-Source Versionskontrollsystem. Das bedeutet, Subversion verwaltet Dateien und Verzeichnisse und die Änderungen an ihnen im Lauf der Zeit. Das erlaubt Ihnen, alte Versionen Ihrer Daten wiederherzustellen oder die Geschichte der Änderungen zu verfolgen. Unter diesem Blickwinkel denken viele Leute bei einem Versionskontrollsystem an eine Art „Zeitmaschine“.

Subversion kann netzwerkübergreifend arbeiten, was die Benutzung durch Menschen an verschiedenen Computern ermöglicht. Auf einer bestimmten Ebene fördert die Fähigkeit unterschiedlicher Personen dieselbe Menge an Daten bearbeiten und verwalten zu können die Zusammenarbeit. Ohne auf einen einzigen Kanal, über den alle Änderungen abgewickelt werden müssen, beschränkt zu sein, kann das Vorankommen beschleunigt werden. Und weil die Arbeit versioniert ist, braucht nicht befürchtet zu werden, dass die Qualität bei Verlust dieses Kanals geopfert wird – falls irgendeine falsche Änderung an den Daten gemacht wird, kann man sie einfach zurücknehmen.

USVN ist ein browserbasiertes Verwaltungssystem. Auf Ihrem Rechner benötigen Sie eine Client-Software um auf den Server zugreifen zu können. Eine ausführliche Zusammenstellung verfügbarer Clients finden Sie unter dieser Zusammenstellung und Vergleich von SVN-Clients, die für jeden Client die abgedeckten Funktionen aufführt.

Warum sollten Sie SVN nutzen?

Ihre Daten sind auf einem Server sicher und weltweit für Sie zugänglich.
Teammitglieder können auf ihre Arbeitsergebnisse zugreifen, auch wenn Sie verhindert sind.
Kommentare ermöglichen die schnelle Identifizierung von Änderungen.
Änderungen erfolgen persönlich - sie finden über die Historie sofort heraus, wer was programmiert hat.
Dateien liegen ihnen nur in einer Version vor - der aktuellen. Die Historie dieser Datei ist jederzeit rückverfolgbar und wiederherstellbar.
Fertige Stände Ihrer Software können mit einem Stempel (Tag) versehen und später schnell wiederhergestellt werden.
Versionsverwaltung ist Industriestandard und die Übung im Studium wird Ihnen später helfen sich zurecht zu finden.

Handbücher/Einführungen

Im Internet finden sich zahlreiche Anleitungen zu SVN und der Bedienung mit Tortoise SVN.

SVN Quickstart

Loggen Sie sich via [1] ein und ändern Sie Ihr Passwort
Vorname_Nachname::Kennwort1 (z.B. Max_Mustermann Kennwort1)
Prüfen Sie, ob Sie Zugang zum passenden Repositorium haben.
Installieren Sie Tortoise SVN für Windows (Mac]) inkl. "Language-Pack"
Hochschulrechner:
1. Legen Sie sich auf der Datenpartition unter \SVN ein Repositorium an.
2. Sichern Sie alle Ihren Quelltext in Ihrem Gruppenordner.
Eigener Rechner:
1. Beliebigen Ordner erstellen (Empfehlung: Ordner ohne Leerstellen etc. verwenden, damit für Programmierung/Matlab/... keine Probleme)
2. SVN > auschecken/checkout
Machen Sie sich mit der Funktion von SVN bekannt.
Antworten auf alle Fragen finden Sie hier.

Grundregeln im Umgang mit SVN

Nutzen Sie dies und arbeiten Sie nachhaltig in SVN. Spätestens an jedem Arbeitstag sollten Sie die Daten auf dem Server sichern, wenn nicht sogar nach jeder wichtigen Änderung.
Sichern Sie nur getesteten Quellcode in SVN, welcher über Header und Kommentare verfügt.
Sperren ("Lock") Sie Dateien nur dann, wenn diese zur Bearbeitung eine Sperre benötigen. Normalfall: Nie! Bei binären Dateien (Office-Dokumente, Bilder,...): Immer!
1. Sperren werden Automatisch entfernt beim Commiten oder Manuel über das Context Menu.
2. Sperren können über "Check for Modifications" überprüft werden. (Lokale tauchen direkt auf und um alle zusehen muss "Check Repository" verwendet werden)
Übertragen (engl. "commit") Sie nur mit Kommentaren.
1. Kommentare sollten verständlich und kurz gehalten werden.
2. Kommentare erläutern Ihrer Änderungen. Was haben Sie geändert?
Führen Sie zu Beginn Ihrer Arbeit und vor jedem Commit stets ein Update durch.
Lesen Sie ggf. zu Beginn Ihrer Arbeit das Log-File ("Show Log") und befolgen Sie die Hinweise.
Verschieben Sie Inhalte nur mit der rechten Maustaste "SVN Move versioned Item(s) here".
Versionieren Sie ausschließlich die Primärdateien. Nicht erlaubt sind:
1. Compiler-Dateien oder Backups (z. B. .asv, .bkp, ~Dateinamen)
2. Temporäre Ordner oder Ordner die nur für den Arbeitsrechner erstellt werden (z. B. .vs)
3. Videodateien die nicht als Eingabedatei für Programme dienen
4. Externe Bibliotheken die im gleichen Umfang im Internet zur Verfügung stehen (z. B. opencv)
Vermeiden Sie in Ordnerbezeichnungen und Dateiennamen Sonderzeichen, Freizeichen und Umlaute (z. B. Uebung_1_2).
Cleanup wird benötigt, wenn Fehler aufgetreten sind bei einem Commit oder Update.
1. Cleanup sollte im Obersten Ornder verwendet werden.
2. In den meisten Fällen sollte "Clean up working copy status" und "Refresh shell overlays" genügen.
3. Genaue Befehl Beschreibung ist hier aufzufinden [2]
4. Weitere TortoiseSVN Regeln
Überlassen Sie SVN die Versionierung. Falsch wäre die Speicherung von 3 Domumenten: Dokument_v1, Dokument_v2, Dokument_v3. Richtig: Dokument wurde 3x in SVN übertragen
Sichern Sie nur wichtige Dateien in SVN (auf keinen Fall Kompilat, Backup-Sicherheitskopien, temporäre Dateien, große Videos,...).

(Commit).

Umgang mit binären (nicht textbasierten) Dateien

SVN spielt seine Stärke besonders dann aus, wenn textbasierte Dateien versioniert werden sollen, z. B. Programmcode, Skripte etc. Beim Versionieren werden dann die Änderungen von verschiedenen Nutzern zusammengeführt.

Bei binären Dateien (Bilder, Excel-Tabellen, ...) macht dieses Vorgehen keinen Sinn, da durch das Zusammenführen nicht mehr richtig interpretierbare Dateien resulieren können. Um auch diese Dateien per SVN versionieren zu können, müssen so genannte Sperren genutzt werden. Vorgehen beim Arbeiten mit Sperren:

Per Rechtsklick - Tortoise SVN - Eigenschaften - Neu - Dateisperre kann eingestellt werden, dass eine Datei eine Sperre benötigt.
Eine Datei mit dieser Eigenschaft ist dann in jeder Arbeitskopie zu Beginn gesperrt, d. h. schreibgeschützt.

Zum Arbeiten mit dieser Datei befolgen Sie folgende Schritte:

Rechtsklick auf die Datei - Tortoise SVN - Sperre holen >> Datei ist entsperrt, d. h. veränderbar (Schreibschutz aufgehoben)
Datei ändern und speichern
Beim Übertragen per Rechtsklick auf die Datei - Tortoise SVN - Übertragen ist die Datei wieder gesperrt.
Hinweis: Beim letzten Schritt kann das automatische Wieder-Sperren deaktiviert werden, falls Sie z. B. gleich weiter mit der Datei arbeiten möchten.

Wann sollte man Daten übertragen?

Sie haben einen SW-Stand zu dem Sie zurückkehren möchten.
Übertragen Sie zusammenhängenden Dateien in einer operation. Nutzen Sie eine LOG-Nachricht für alle Dateien.
Übertragen Sie Daten als Backup.
Übertragen Sie Daten von einem Arbeitsrechner um sie mit anderen zu teilen.

Anforderungen an Ihr Passwort

Für das Arbeiten mit SVN ist zwingend ein sicheres Passwort erforderlich. Bechaten Sie nachfolgende Regeln

Das Passwort muss mindestens 12 Zeichen umfassen.
Es sollte mindestens 2 Sonderzeichen, eine Zahl, einen Kleinbuchstaben und einen Großbuchstaben enthalten.
Für das Passwort sind folgende Zeichen erlaubt:
- Kleinbuchstaben ( a - z )
- Großbuchstaben ( A - Z )
- Ziffern ( 0 - 9 )
- die Sonderzeichen ( ) [ ] { } ? ! $ % & / = * + ~ , . ; : < > - _

Verbindungsprobleme

Bei Verbindungsproblemen schreiben Sie bitte eine Email an die IT (it-support@hshl.de‎) und beschreiben Sie freundlich Ihr Problem und senden Sie folgende Infos:

Betreff: Ticket#2013120310000018
Fehlermeldung
Zeit
Client
Netz (HSHL oder Web incl. IP Adresse)

Weblinks

@@ Zeile 40: / Zeile 40: @@
 == Grundregeln im Umgang mit SVN ==
+# Nutzen Sie dies und arbeiten Sie nachhaltig in SVN. Spätestens an jedem Arbeitstag sollten Sie die Daten auf dem Server sichern, wenn nicht sogar nach jeder wichtigen Änderung.
+# Sichern Sie nur getesteten Quellcode in SVN, welcher über Header und Kommentare verfügt.
 # Sperren ("Lock") Sie Dateien nur dann, wenn diese zur Bearbeitung eine Sperre benötigen. Normalfall: Nie! Bei binären Dateien (Office-Dokumente, Bilder,...): Immer!
 ## Sperren werden Automatisch entfernt beim Commiten oder Manuel über das Context Menu.
 ## Sperren können über "<code>Check for Modifications</code>" überprüft werden. (Lokale tauchen direkt auf und um alle zusehen muss "Check Repository" verwendet werden)
 # Übertragen (engl. "commit") Sie nur '''mit Kommentaren'''.
-## Kommentare sollten Verständlich und Kurz gehalten werden.
+## Kommentare sollten verständlich und kurz gehalten werden.
+## Kommentare erläutern Ihrer Änderungen. Was haben Sie geändert?
 # Führen Sie zu Beginn Ihrer Arbeit und vor jedem '''Commit''' stets ein '''Update''' durch.
 # Lesen Sie ggf. zu Beginn Ihrer Arbeit das '''Log-File''' ("<code>Show Log</code>") und befolgen Sie die Hinweise.
@@ Zeile 59: / Zeile 62: @@
 ## Genaue Befehl Beschreibung ist hier aufzufinden [https://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-cleanup.html]
 ## [[TortoiseSVN Regeln| Weitere TortoiseSVN Regeln]]
-# Überlassen Sie SVN die Versionierung. Falsch wäre die Speicherung von 3 Domumenten: <code>Dokument_v1, Dokument_v2, Dokument_v3</code>. Richtig: <code>Dokument</code> wurde 3x in SVN übertragen (<code>Commit</code>).
+# Überlassen Sie SVN die Versionierung. Falsch wäre die Speicherung von 3 Domumenten: <code>Dokument_v1, Dokument_v2, Dokument_v3</code>. Richtig: <code>Dokument</code> wurde 3x in SVN übertragen
+# Sichern Sie nur wichtige Dateien in SVN (auf keinen Fall Kompilat, Backup-Sicherheitskopien, temporäre Dateien, große Videos,...).
+(<code>Commit</code>).
 == Umgang mit binären (nicht textbasierten) Dateien ==