Sitzung: Jeden Freitag in der Vorlesungszeit ab 16 Uhr c. t. im MAR 0.005. In der vorlesungsfreien Zeit unregelmäßig (Jemensch da?). Macht mit!

Subversion im CS-Netz: Unterschied zwischen den Versionen

 
Zeile 1: Zeile 1:
''Work in Progress''
+
Dieser Guide beschreibt, wie man eine Software zur [[WikiPedia:Versionskontrolle|Versionskontrolle]] namens [http://subversion.tigris.org/ Subversion (SVN)] einsetzt. [[WikiPedia:Subversion (Software)|Subversion]] ermöglicht mehreren Nutzern, gleichzeit an den gleichen Dateien zu arbeiten und so vor allem Quellcode und Textdateien zentral zu organisieren und zu speichern.
  
$USER ist der Benutzername desjenigen, der das Repository einrichtet.
+
Diese Anleitung beschreibt allerdings nur die Grundlagen, wie ein SVN Repository im [[IRB|CS-Netz]] eingerichtet wird. Grundlagen in der Software werden nicht gelegt, dafür sollte weitere Literatur dienen.
 +
 
 +
Für das Repository braucht man nur Speicher im Home-Verzeichnis, die SVN-Software auf dem Server (ist installiert) und zu Hause (siehe unten). Weiterhin muss eine Gruppe im CS-Netz existieren oder angelegt werden. Am Ende steht optional die Einrichtung von Commit-Emails.
 +
 
 +
 
 +
== Konventionen ==
 +
$USER ist der Benutzername desjenigen, der das Repository einrichtet, z.B. '''buchholz'''. <br />
 +
$HOME ist das Home-Verzeichnis des Benutzers, z.B. '''/home/b/buchholz''' (bekommt man mit '''pwd''' raus). <br />
 +
$HOST ist der Server, auf dem das SVN laufen soll, z.B. '''condesa.cs.tu-berlin.de'''. <br />
 +
$GROUP ist die Gruppe, die Zugriff auf das SVN haben soll, z.B. '''mycoolsvngroup'''.
 +
 
 +
'''Fettdruck''' bedeutet immer, dass eine Ersetzung durch einen konkreten Wert nötig wird.
  
 
== Über die SVN-Installation im CS-Netz ==
 
== Über die SVN-Installation im CS-Netz ==
Zeile 10: Zeile 21:
  
  
== Schritt 1: Login und Einrichten des des SVNs ==
+
== Schritt 1: Login und Einrichten der Gruppe ==
  ssh condesa.cs.tu-berlin.de
+
Wir connecten uns zum gewählten Host und richten die Gruppe und die Nutzer ein.
 +
 
 +
ssh '''$HOST'''
 +
grp -setup '''$GROUP'''
 +
grp -invite '''$GROUP''' user1 user2 user3... # Einladen der Nutzer ($USER selbst ist schon drin)
 +
 
 +
Die Nutzer bekommen daraufhin eine Email und müssen der Gruppe via Terminal beitreten. Die Aktualisierung der Gruppendatenbank dauert eine Weile (etwa 1 Stunde).
 +
 
 +
 
 +
== Schritt 2: Einrichten des SVNs ==
 +
Nun erstellen wir die nötigen Verzeichnisse und ein Repository.
 +
 
 +
mkdir $HOME/svn-repo
 +
cd $HOME/svn-repo
 +
svnadmin create myrepo
 +
 
 +
Es müssen entsprechende Rechte für das neue Verzeichnis gesetzt werden:
 +
* Execute für jeden, damit er in das Home-Verzeichnis wechseln kann.
 +
* Group-Read und -Write, wo nötig.
 +
chmod o+x . ..
 +
chgrp -R '''$GROUP''' '''myrepo'''
 +
chmod -R o-rwx '''myrepo'''
 +
chmod -R g+rX '''myrepo'''
 +
chmod -R g+u '''myrepo'''/db
 +
 
 +
== URL des Repositories ==
 +
 
 +
Die URL des Repositories lautet:
 +
  svn+ssh://'''$MEINCSNAME'''@'''$HOST'''/'''$HOME'''/svn-repo/myrepo
 +
z.B.
 +
svn+ssh://post@condesa.cs.tu-berlin.de/home/b/buchholz/svn-repo/myrepo
 +
 
 +
=== Clients ===
 +
 
 +
Das Repo kann unter Linux/Solaris ausgecheckt werden mittels
 +
svn co $REPO_URL
 +
 
 +
Unter Windows empfehle ich [http://tortoisesvn.tigris.org/ TortoiseSVN] als Explorer-Plugin.
 +
 
 +
Es gibt für Windows, Linux und Solaris auch ein Eclipse-Plugin dafür: [http://subclipse.tigris.org/ Subclipse].
 +
 
 +
 
 +
== Schritt 4: Einrichten von Commit-Mails (optional) ==
 +
 
 +
Commit-Emails bieten die Möglichkeit, über Commits aller Nutzer benachrichtigt zu werden. Sie enthalten neben der Commit-Log-Nachricht und einer Liste aller veränderten Dateien auch eine genaue Übersicht der Änderungen als Unified Diff.
 +
 
 +
cd '''myrepo'''/hooks
 +
cp post-commit{.tmpl,}
 +
chmod ug+x post-commit
 +
 
 +
Die Datei '''post-commit''' dann in einem Text-Editor öffnen (z.B. pico) und folgende Zeile editieren:
 +
commit-email.pl "$REPOS" "$REV" commit-watchers@example.org
 +
Sie sollte etwa so aussehen:
 +
/home/pub/bin/svn-commit-email.pl "$REPOS" "$REV" --from "'''$USER'''@cs.tu-berlin.de" -s "['''myrepo'''] SVN-Commit:" email1@cs.tu-berlin.de,gruppenmitglied2@web.de,emerge_moo@yahoo.com
 +
Wobei die letzten Emailadressen die Empfänger der Email sind, durch Komma getrennt.
 +
 
 +
== Schritt 5: Und nun? ==
 +
 
 +
Ich empfehle als Einstieg und zur Vertiefung sehr das [http://svnbook.red-bean.com/nightly/en/index.html SVNBook] (auch in verschiedenen Formaten, Versionen und Sprachen [http://svnbook.red-bean.com/ zum Download]). Insbesondere die ersten Kapitel sollte man verstanden haben.
 +
 
 +
== Schritt zurück: Ich brauche Hilfe! ==
 +
Vielleicht hat jemand schon deine Frage beantwortet? Schau doch mal auf der [[Diskussion:Subversion im CS-Netz:Diskussions-Seite]] nach.
 +
 
 +
Neue Fragen bitte [http://wiki.freitagsrunde.org/index.php?title=Diskussion:Subversion_im_CS-Netz&action=edit&section=new auf der Diskussionsseite stellen]. Danke.

Version vom 19. November 2006, 04:21 Uhr

Dieser Guide beschreibt, wie man eine Software zur Versionskontrolle namens Subversion (SVN) einsetzt. Subversion ermöglicht mehreren Nutzern, gleichzeit an den gleichen Dateien zu arbeiten und so vor allem Quellcode und Textdateien zentral zu organisieren und zu speichern.

Diese Anleitung beschreibt allerdings nur die Grundlagen, wie ein SVN Repository im CS-Netz eingerichtet wird. Grundlagen in der Software werden nicht gelegt, dafür sollte weitere Literatur dienen.

Für das Repository braucht man nur Speicher im Home-Verzeichnis, die SVN-Software auf dem Server (ist installiert) und zu Hause (siehe unten). Weiterhin muss eine Gruppe im CS-Netz existieren oder angelegt werden. Am Ende steht optional die Einrichtung von Commit-Emails.


Konventionen

$USER ist der Benutzername desjenigen, der das Repository einrichtet, z.B. buchholz.
$HOME ist das Home-Verzeichnis des Benutzers, z.B. /home/b/buchholz (bekommt man mit pwd raus).
$HOST ist der Server, auf dem das SVN laufen soll, z.B. condesa.cs.tu-berlin.de.
$GROUP ist die Gruppe, die Zugriff auf das SVN haben soll, z.B. mycoolsvngroup.

Fettdruck bedeutet immer, dass eine Ersetzung durch einen konkreten Wert nötig wird.

Über die SVN-Installation im CS-Netz

Zuerst muss man sich einen Server aussuchen, auf dem Subversion installiert ist.

Stand November 2006 ist, dass auf verschiedenen Servern unterschiedliche SVN-Versionen laufen. Wir nutzen hier die Version 1.4.0 auf condesa (Solaris 10), installiert in /opt/csw/bin.


Schritt 1: Login und Einrichten der Gruppe

Wir connecten uns zum gewählten Host und richten die Gruppe und die Nutzer ein.

ssh $HOST
grp -setup $GROUP
grp -invite $GROUP user1 user2 user3... # Einladen der Nutzer ($USER selbst ist schon drin)

Die Nutzer bekommen daraufhin eine Email und müssen der Gruppe via Terminal beitreten. Die Aktualisierung der Gruppendatenbank dauert eine Weile (etwa 1 Stunde).


Schritt 2: Einrichten des SVNs

Nun erstellen wir die nötigen Verzeichnisse und ein Repository.

mkdir $HOME/svn-repo
cd $HOME/svn-repo
svnadmin create myrepo

Es müssen entsprechende Rechte für das neue Verzeichnis gesetzt werden:

  • Execute für jeden, damit er in das Home-Verzeichnis wechseln kann.
  • Group-Read und -Write, wo nötig.
chmod o+x . ..
chgrp -R $GROUP myrepo
chmod -R o-rwx myrepo
chmod -R g+rX myrepo
chmod -R g+u myrepo/db

URL des Repositories

Die URL des Repositories lautet:

svn+ssh://$MEINCSNAME@$HOST/$HOME/svn-repo/myrepo

z.B.

svn+ssh://post@condesa.cs.tu-berlin.de/home/b/buchholz/svn-repo/myrepo

Clients

Das Repo kann unter Linux/Solaris ausgecheckt werden mittels

svn co $REPO_URL

Unter Windows empfehle ich TortoiseSVN als Explorer-Plugin.

Es gibt für Windows, Linux und Solaris auch ein Eclipse-Plugin dafür: Subclipse.


Schritt 4: Einrichten von Commit-Mails (optional)

Commit-Emails bieten die Möglichkeit, über Commits aller Nutzer benachrichtigt zu werden. Sie enthalten neben der Commit-Log-Nachricht und einer Liste aller veränderten Dateien auch eine genaue Übersicht der Änderungen als Unified Diff.

cd myrepo/hooks
cp post-commit{.tmpl,}
chmod ug+x post-commit

Die Datei post-commit dann in einem Text-Editor öffnen (z.B. pico) und folgende Zeile editieren:

commit-email.pl "$REPOS" "$REV" commit-watchers@example.org

Sie sollte etwa so aussehen:

/home/pub/bin/svn-commit-email.pl "$REPOS" "$REV" --from "$USER@cs.tu-berlin.de" -s "[myrepo] SVN-Commit:" email1@cs.tu-berlin.de,gruppenmitglied2@web.de,emerge_moo@yahoo.com

Wobei die letzten Emailadressen die Empfänger der Email sind, durch Komma getrennt.

Schritt 5: Und nun?

Ich empfehle als Einstieg und zur Vertiefung sehr das SVNBook (auch in verschiedenen Formaten, Versionen und Sprachen zum Download). Insbesondere die ersten Kapitel sollte man verstanden haben.

Schritt zurück: Ich brauche Hilfe!

Vielleicht hat jemand schon deine Frage beantwortet? Schau doch mal auf der Diskussion:Subversion im CS-Netz:Diskussions-Seite nach.

Neue Fragen bitte auf der Diskussionsseite stellen. Danke.