Erzeugen des Verzeichnisses für lokale Verwendung ohne Apache¶

mkdir -p /hier/gewünschter/pfad/svn 

und der Repository-Datenbank:

svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn 

Erzeugen des Verzeichnisses für den Webserver¶

mkdir -p /var/local/svn 

und der Repository-Datenbank:

svnadmin create --fs-type fsfs /var/local/svn 

Nun ist das Repository für den WWW-Server schreibbar zu machen:

chown -R www-data:www-data /var/local/svn 

Konfiguration von Apache2¶

a2enmod dav_svn 

1
2
3
4

     <Location /svn>
       DAV svn
       SVNPath /var/local/svn
     </Location>

sudo /etc/init.d/apache2 restart 

mkdir -p /var/local/svn/project1
mkdir -p /var/local/svn/project2 

svnadmin create --fs-type fsfs /var/local/svn/project1
svnadmin create --fs-type fsfs /var/local/svn/project2 

chown -R www-data:www-data /var/local/svn 

1
2
3
4
5

     <Location /svn>
       DAV svn
       SVNParentPath /var/local/svn
       SVNListParentPath on # Notwendig für das Auflisten aller Repositories
     </Location>

sudo /etc/init.d/apache2 restart 

a2enmod dav_svn 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

     <Location /svn>
       DAV svn
       SVNPath /var/local/svn
       AuthType Basic
       AuthName "Subversion repository"
       AuthUserFile /etc/apache2/dav_svn.passwd
       <LimitExcept GET PROPFIND OPTIONS REPORT>
         Require valid-user
       </LimitExcept>
     </Location>

sudo htpasswd /etc/apache2/dav_svn.passwd ein-Nutzer 

sudo /etc/init.d/apache2 restart 

sudo apt-get install apache2-mpm-prefork 

Verzeichnisstruktur erstellen¶

In einem Terminal ^[3] führt man den folgenden Befehl aus:

mkdir -p /tmp/projekt1/trunk
mkdir -p /tmp/projekt1/tags
mkdir -p /tmp/projekt1/branches 

Die Bezeichnung trunk steht für den Hauptast des Projektes. Das Verzeichnis branches steht für eventuelle Entwicklungszweige, das Verzeichnis tags dient der Speicherung von Entwicklungsständen.

Die schon erstellten Dateien muss man ins trunk-Verzeichnis kopieren:

cp -R /projekt_ohne_svn/* /tmp/projekt1/trunk 

Projekt in Subversion importieren:

Für lokale Installation

svn import /tmp/projekt1 file:///hier/gewuenschter/pfad/svn/projekt1 -m "initialer Import" 

Für den Apache

svn import /tmp/projekt1 http://localhost/svn/projekt1 -m "initialer Import" 

Allerdings wird hier der aktuelle Login-Name verwendet. Existiert dieser nicht als Benutzer bzw. soll ein anderer verwendet werden, ist folgender Befehl auszuführen:

svn import /tmp/projekt1 http://localhost/svn/projekt1 -m "initialer Import" --username ein-Nutzer 

Zentrale Zugriffsbeschränkung mehrerer Projekte¶

In SVN gibt es zusätzlich noch die Möglichkeit, mehrere Repositories zu erstellen und diese zentral zu steuern.

Jedes Repository muss in einem Unterordner des SVN-Hauptordners erstellt werden.

svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn/projekt1
svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn/projekt2
svnadmin create --fs-type fsfs /hier/gewuenschter/pfad/svn/projekt3 

Danach muss die Datei /etc/apache2/mods-enabled/dav_svn.conf angepasst werden.

1
2
3
4
5

 <Location /svn>
   ...      
   AuthzSVNAccessFile /etc/apache2/dav_svn.authz
  ...
  </Location>

1
2
3

<LimitExcept GET PROPFIND OPTIONS REPORT>
  ...
</LimitExcept>

Dafür darf nur noch der Inhalt des Bereichs stehen bleiben.

1
2
3
4
5

<Location /svn>
   ...   
   Require valid-user
   ...
</Location>

Insgesamt sieht die Konfigurationsdatei also folgendermaßen aus:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

<Location /svn>
       DAV svn
       SVNPath /var/svn

       AuthzSVNAccessFile /etc/apache2/dav_svn.authz

       Require valid-user

       AuthType Basic
       AuthName "Subversion repository DESADV"
       AuthUserFile /etc/apache2/dav_svn.passwd
</Location>

Bei dieser Art der Benutzerverwaltung ist ggfs. das Modul authz_svn einmalig zusätzlich zu aktivieren. Dies geschieht folgendermaßen:

a2enmod authz_svn 

Im nächsten Schritt werden in der Datei /etc/apache2/dav_svn.authz die notwendigen Einstellungen vorgenommen. Dies könnte wie im folgenden Beispiel aussehen.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

      [groups]
      admin = username1,username2, ...
      gruppe2 = username3,username4, ...

      [projekt1:/]
      @admin = rw
      @gruppe2 = r

      [projekt2:/]
      @gruppe2 = rw

      [projekt3:/]
      @admin = rw

Im Abschnitt groups werden die Gruppen festgelegt, den einzelnen Gruppen können mehrere Benutzer hinzugefügt werden. Einem Projekt können mehrere Gruppen zuweisen und verschiedene Rechte vergeben werden. Bei projekt1 sind es hier die Gruppen admin und gruppe2. Die Gruppe admin hat Schreib- und Leserechte, gruppe2 hingegen nur Leserechte.

Wenn man einem bestimmten Benutzer Rechte für ein Projekt einrichten will, muss dies wie folgt geschehen.

1
2
3
4
5
6
7
8
9

      [groups]
      admin = username1,username2, ...
      gruppe2 = username3,username4, ...

      [projekt1:/]
      username1 = r
      @gruppe2 = rw

      ...

Für den Zugriff aller Benutzer und Gruppen auf ein Projekt kann eine Wildcard verwendet werden.

1
2
3
4

      ...
      [projekt1:/]
      * = r
      ...

Der Doppelpunkt und Slash in projekt1 legen fest, dass die Berechtigungen ab dem Hauptverzeichnis des Repositories greifen. Will man also Benutzern und Gruppen in Unterverzeichnissen andere Rechte gewähren, gibt man einfach zusätzlich noch den zu schützenden Pfad mit an.

1
2
3
4

      ...
      [projekt2:/der/zu/schuetzende/pfad]
      username3 = r
      ...

Jetzt wurden dem Benutzer die zuvor gewährten Schreibrechte im projekt2 wieder entzogen.

Backup erstellen/einspielen¶

svnadmin dump /var/local/svn/ > dumpfile
svnadmin load /var/local/svn/ < dumpfile 

Konfiguration Auto-Keywords¶

Damit jedes neue Dokument in einem Repository automatisch den gewünschten Effekt ausgibt, benötigt es eine Anpassung der Subversion-Konfiguration.

Dazu die Konfigurationsdatei /etc/subversion/config in einem Editor mit Root-Rechten öffnen^[4] und am Ende der Datei Folgendes einfügen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

enable-auto-props = yes
[auto-props]
*.c = svn:eol-style=native;svn:keywords=Date Author Id Revision HeadURL
*.css = svn:eol-style=native;svn:keywords=Date Author Id Revision HeadURL
*.java = svn:eol-style=native; svn:keywords=Id Author Date Revision
*.properties = svn:eol-style=native
*.sh = svn:eol-style=native;svn:executable
*.txt = svn:eol-style=native
*.xml = svn:eol-style=native
*.php = svn:eol-style=native; svn:keywords=Id Author Date Revision

Danach Apache2 neu starten:

sudo /etc/init.d/apache2 restart 

kdesvn¶

Das folgende Paket ist zusätzlich zu installieren ^[1]:

• kdesvn (universe)

Befehl zum Installieren der Pakete:

sudo apt-get install kdesvn 

Oder mit apturl installieren, Link: apt://kdesvn

Kdesvn ist ein Programm der Desktopumgebung KDE. Es werden daher über die Abhängigkeiten weitere Pakete der KDE installiert.

Das Programm wird gestartet über:

• "K-Menü → Entwicklung → Graphische Oberfläche für SVN (kdesvn)"

Falls die Fehlermeldung "PROPFIND Anfrage fehlgeschlagen" erscheint, muss ein SSL-Zertifikat eingerichtet werden. Das folgende Paket ist zusätzlich zu installieren ^[1]:

• ssl-cert

Befehl zum Installieren der Pakete:

sudo apt-get install ssl-cert 

Oder mit apturl installieren, Link: apt://ssl-cert

Dann kann das Zertifikat hiermit erstellt werden:

sudo mkdir /etc/apache2/ssl
sudo /usr/sbin/make-ssl-cert /usr/share/ssl-cert/ssleay.cnf /etc/apache2/ssl/apache.pem 

RabbitVCS¶

Unter unity/GNOME integriert sich RabbitVCS gut in Nautilus.

⚓︎

Nutzung von Passwortmanagern¶

Subversion ermöglicht es, die Zugangsdaten zu einem Repository lokal zu speichern. Dies ist sehr praktisch, um nicht bei jedem Update, Commit oder Log das Passwort eingeben zu müssen. Standardmäßig werden die Zugangsdaten irgendwo im Homeverzeichnis gespeichert, es ist allerdings auch möglich die KDE-Brieftasche oder den Gnome-Schlüsselbund dafür zu verwenden. Dazu die Datei ~/.subversion/config öffnen und im Abschnitt [auth] den Eintrag

1

password-stores = ...

mit dem entsprechenden Keystore ergänzen bzw. anpassen.

Nutzung des Gnome-Schlüsselbundes:

1

password-stores = gnome-keyring

Nutzung der KDE-Brieftasche:

1

password-stores = kwallet

Eine Änderung dieser Einstellung wirkt sich zunächst nur auf neu zu speichernde Passwörter aus. Gegebenenfalls müssen alle bereits vorhandenen Passwörter gelöscht werden (Unterverzeichnis ~/.subversion/auth), gefolgt von einem svn up (und erneuter Passworteingabe) auf allen Arbeitskopien.